Skills transform-describe-image-with-transloadit
One-off image description using the official `@transloadit/node` CLI. Use `image describe --fields labels` for object-style labels, or `image describe --for wordpress` for structured alt text, title, caption, and description JSON.
install
source · Clone the upstream repo
git clone https://github.com/transloadit/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/transloadit/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/transform-describe-image-with-transloadit" ~/.claude/skills/transloadit-skills-transform-describe-image-with-transloadit && rm -rf "$T"
manifest:
skills/transform-describe-image-with-transloadit/SKILL.mdsource content
Inputs
- Absolute path to a local input image
- Optional
output path; default is the same path with.json.json
Prepare
Resolve credentials in this order:
- Shell environment variables
- The current working directory
only.env ~/.transloadit/credentials
If your
.env lives in a parent directory, export the variables into the shell first.
Run
Use the official Transloadit Node CLI directly.
Labels / object-style description:
npx -y @transloadit/node image describe \ --input ./input.jpg \ --fields labels \ --output ./labels.json
WordPress-ready fields:
npx -y @transloadit/node image describe \ --input ./input.jpg \ --for wordpress \ --output ./fields.json
Custom field selection:
npx -y @transloadit/node image describe \ --input ./input.jpg \ --fields altText,title,caption,description \ --output ./fields.json
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
--fields labels returns a JSON array of labels.
--for wordpress and authored --fields ... return a JSON object with requested string fields, for example:
{ "altText": "...", "title": "...", "caption": "...", "description": "..." }
Notes
- Prefer
when you want publishable CMS fields.--for wordpress - Prefer
when you want recognizer-style tags instead of authored copy.--fields labels
only matters for authored fields, not for--model
.labels- Prefer
as the default fallback when you want a reusable user-level setup.~/.transloadit/credentials - A current-directory
still takes precedence, so avoid it when deterministic account selection matters..env - If credentials only exist in a repo-root
, run the command from that directory or export the variables first..env
Debug If It Fails
npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j