Skip to content
Machine Learning
Skill

/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.

BOOST
From plugin
claude-vision-skill
2.3k1 skill
Install
$ npx -y skills add asuojun/claude-vision-skill --skill claude-vision-skill --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/claude-vision-skill

Context preview

The summary Claude sees to decide when to auto-load this 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.

SKILL.md

claude-vision-skill.SKILL.md
name: claude-vision-skill
description: 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 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.
Read more
Ships withclaude-vision-skill

让没有识图能力的模型获得识图能力——把图片发给有 vision 的模型,用文字描述回来。

Get the whole plugin
Stats
2,301
Stars
120
Forks
Maintained
Maintenance
JavaScript
Language
2mo ago
Last commit
5mo ago
Created
2d ago
Added

Repo: asuojun/claude-vision-skill