free-vision

Analyze local images via Gemini or Qwen CLI to produce structured summaries, object lists, and verbatim text.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/thanhtunguet/agent-skills --skill free-vision
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: free-vision
Source: https://github.com/thanhtunguet/agent-skills/tree/main/free-vision
Command: npx skills add https://github.com/thanhtunguet/agent-skills --skill free-vision

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reduce the friction of interpreting images by invoking local AI CLIs to produce structured visual summaries, explicit object lists, and verbatim visible text so users do not need to manually inspect or transcribe images.

Core Features & Use Cases

  • CLI-first analysis with fallback: Prefer Gemini for structured image analysis and automatically fall back to Qwen Code CLI if Gemini fails or returns generic output.
  • Structured output: Return a one-sentence summary, enumerated key objects, verbatim visible text extraction, and notable visual details for each image.
  • Path validation and error handling: Require absolute paths, confirm file existence, and handle CLI errors or empty responses to prompt for alternative inputs.
  • Use Case: Convert screenshots, photos, or diagrams into concise, machine-readable descriptions and extract any visible text for downstream tasks like documentation or accessibility summaries.

Quick Start

Ask the skill to analyze the image at /absolute/path/to/image.jpg and provide a one-sentence summary, list key objects, extract any visible text verbatim, and note notable details.

Frequently Asked Questions about free-vision

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract visible text from a local image file for documentation?

To extract visible text from a local image file, the Skill analyzes images using local AI CLIs like Gemini or Qwen to produce verbatim visible text and structured visual summaries. It processes photographs, screenshots, and diagrams to provide machine-readable descriptions and text for downstream tasks.

Can I use Qwen to analyze images if Gemini CLI fails or returns generic output?

Yes, you can use Qwen to analyze images if Gemini CLI fails. The Skill prefers Gemini for structured image analysis but automatically falls back to Qwen Code CLI if Gemini fails, returns CLI errors, or provides generic responses. This dual-CLI approach ensures robust image processing.

Do I need to provide an absolute path to analyze images with a CLI tool?

Yes, you must provide an absolute file path to analyze images with a CLI tool. The Skill performs path validation and requires absolute paths to confirm file existence before invoking Gemini or Qwen. If validation fails or CLI errors occur, it handles these by prompting for alternative inputs.

What structured output is generated when analyzing screenshots for accessibility summaries?

Analyzing screenshots for accessibility summaries generates structured output including a one-sentence summary, enumerated key objects, verbatim visible text extraction, and notable visual details. This machine-readable format reduces friction by eliminating manual inspection and transcription of image content.

What are the limitations of using local CLI tools for image analysis?

Limitations of using local CLI tools for image analysis include dependency on the availability of Gemini or Qwen CLIs and the strict requirement for absolute image paths. The Skill cannot process relative paths and will prompt for alternative inputs if CLI calls return empty outputs or errors.