How do I install the Claude Vision Skill skill?

Run npx skillmds@latest add asuojun/claude-vision-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Claude Vision Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Claude Vision Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Claude Vision Skill free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Claude Vision Skill?

asuojun (@asuojun) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Claude Vision Skill by asuojun — Agent Skill

Name: Claude Vision Skill
Author: asuojun

Claude Vision Skill

Use when the user shares, pastes, or references an image (local path or URL) and you need to describe, analyze, or recognize its content, especially when the current model cannot read images directly. Run the bundled vision.js helper to convert the image into text.

asuojun 94188c9 9 files · 15.8 KB Updated Sep 17, 2026

File contents

Vision Helper

The current model may not support native image input. When the user provides an image path or URL, do not rely on viewing the image directly. Instead run:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js "<absolute image path>" "<prompt>"

For an image URL:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --url "<image url>" "<prompt>"

When the user pastes an image into the chat but no file path or URL is visible:

node /Users/wwu/.codex/skills/claude-vision-skill/vision.js --clipboard "<prompt>"

--clipboard reads the current image from the system clipboard (macOS uses a bundled Swift helper, Windows uses a bundled PowerShell script; the pasted image is usually still there). If it fails, ask the user to save the image to a file and provide the absolute path.

Fallback rules (automatic):

If a local path is given but the file does not exist, vision.js automatically falls back to the clipboard.
If no image path or URL is given at all, vision.js automatically tries the clipboard.
Pass --no-fallback to disable this behavior and fail with an explicit error instead.

Rules:

Always use the absolute path to vision.js.
Use an absolute image path for local files, or --url for remote images.
Prefer --clipboard when the user pasted an image with no accessible path.
Use Chinese for descriptions unless the user asks otherwise.
Configuration lives in .env next to vision.js (DASHSCOPE_API_KEY, VISION_MODEL, DASHSCOPE_BASE_URL). Never print or commit the API key.
If the API call fails, report the error to the user and ask them to check the key, model, or base URL.

---name: claude-vision-skilldescription: Use when the user shares, pastes, or references an image (local path or URL) and you need to describe, analyze, or recognize its content, especially when the current model cannot read images directly. Run the bundled vision.js helper to convert the image into text.---# Vision HelperThe current model may not support native image input. When the user provides an image path or URL, do not rely on viewing the image directly. Instead run:```bashnode /Users/wwu/.codex/skills/claude-vision-skill/vision.js "<absolute image path>" "<prompt>"```For an image URL:```bashnode /Users/wwu/.codex/skills/claude-vision-skill/vision.js --url "<image url>" "<prompt>"```When the user pastes an image into the chat but no file path or URL is visible:```bashnode /Users/wwu/.codex/skills/claude-vision-skill/vision.js --clipboard "<prompt>"````--clipboard` reads the current image from the system clipboard (macOS uses a bundled Swift helper, Windows uses a bundled PowerShell script; the pasted image is usually still there). If it fails, ask the user to save the image to a file and provide the absolute path.Fallback rules (automatic):- If a local path is given but the file does not exist, vision.js automatically falls back to the clipboard.- If no image path or URL is given at all, vision.js automatically tries the clipboard.- Pass `--no-fallback` to disable this behavior and fail with an explicit error instead.Rules:- Always use the absolute path to `vision.js`.- Use an absolute image path for local files, or `--url` for remote images.- Prefer `--clipboard` when the user pasted an image with no accessible path.- Use Chinese for descriptions unless the user asks otherwise.- Configuration lives in `.env` next to `vision.js` (`DASHSCOPE_API_KEY`, `VISION_MODEL`, `DASHSCOPE_BASE_URL`). Never print or commit the API key.- If the API call fails, report the error to the user and ask them to check the key, model, or base URL.

Frequently asked questions