docs: update transloadit intent output guidance (#6)

Author: kvz

skills/transform-convert-markdown-to-pdf-with-transloadit/SKILL.md

@@ -29,12 +29,13 @@ description: Convert a local Markdown file to a sibling PDF via the official `@t
 4. Run the conversion with the official CLI:
 
 ```bash
-npx -y @transloadit/node markdown pdf --input /ABS/PATH/file.md --out /ABS/PATH/file.pdf
+npx -y @transloadit/node markdown pdf --input /ABS/PATH/file.md --output /ABS/PATH/file.pdf
 ```
 
 ## Notes
 
 - Prefer `@transloadit/node`; it is the official CLI route and exposes `markdown pdf`.
+- When no `--output` is provided, the CLI writes the PDF next to the Markdown file by default.
 - Prefer `~/.transloadit/credentials` as the default fallback when you want a reusable user-level setup.
 - A current-directory `.env` still takes precedence, so avoid it when deterministic account selection matters.
 - If credentials only exist in a repo-root `.env`, run the command from that directory or export the variables first.

skills/transform-describe-image-with-transloadit/SKILL.md

@@ -6,7 +6,7 @@ description: One-off image description using the official `@transloadit/node` CL
 # Inputs
 
 - Absolute path to a local input image
-- Explicit `.json` output path
+- Optional `.json` output path; default is the same path with `.json`
 
 # Prepare
 
@@ -27,7 +27,7 @@ Labels / object-style description:
 npx -y @transloadit/node image describe \
   --input ./input.jpg \
   --fields labels \
-  --out ./labels.json
+  --output ./labels.json
 ```
 
 WordPress-ready fields:
@@ -36,7 +36,7 @@ WordPress-ready fields:
 npx -y @transloadit/node image describe \
   --input ./input.jpg \
   --for wordpress \
-  --out ./fields.json
+  --output ./fields.json
 ```
 
 Custom field selection:
@@ -45,10 +45,11 @@ Custom field selection:
 npx -y @transloadit/node image describe \
   --input ./input.jpg \
   --fields altText,title,caption,description \
-  --out ./fields.json
+  --output ./fields.json
 ```
 
-After the command finishes, confirm the JSON file exists at the expected output path.
+If you omit `--output`, the CLI writes the JSON file next to the input image using the same base
+name. After the command finishes, confirm the JSON file exists at the expected output path.
 
 # Output Shapes
 

skills/transform-generate-image-with-transloadit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: transform-generate-image-with-transloadit
-description: One-off image generation (prompt -> image file) using Transloadit via the `transloadit` CLI. Prefer `image generate` for text-only and input-guided generation, and download outputs locally via `-o`.
+description: One-off image generation (prompt -> image file) using Transloadit via the `transloadit` CLI. Prefer `image generate` for text-only and input-guided generation, and use `--output` when you need a deterministic path.
 ---
 
 # Run
@@ -10,7 +10,7 @@ Use the `image generate` intent for quick image generation from a prompt.
 ```bash
 npx -y @transloadit/node image generate \
   --prompt 'A minimal product photo of a chameleon on white background' \
-  -o ./out.png
+  --output ./out.png
 ```
 
 # Run With Input Images
@@ -24,13 +24,14 @@ npx -y @transloadit/node image generate \
   --input ./person2.jpg \
   --input ./background.jpg \
   --prompt 'Place person1.jpg feeding person2.jpg in front of background.jpg' \
-  -o ./out.png
+  --output ./out.png
 ```
 
 Notes:
 - The CLI defaults to `google/nano-banana-2`.
 - Repeated `--input` values are bundled into a single `/image/generate` assembly.
 - Prompt-only generation still works without any `--input`.
+- Without `--output`, prompt-only and multi-input runs default to the current working directory.
 
 # Debug If It Fails