← Back to Skills Marketplace
ravenquasar

Vision Helper — AI Image Analysis

by U3UT7 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
77
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install vision-helper
Description
Analyze images using local or cloud vision models via Ollama to identify content, UI elements, screenshots, or extract text with OCR support.
Usage Guidance
This skill appears to be what it claims: a helper that reads an image file and sends it to an Ollama instance for analysis. Before installing or using it, consider the following: - Privacy: The script will read any readable file with an allowed extension and base64-encode it. If you take desktop/browser screenshots you may capture passwords, private chats, or other sensitive data. - Endpoint trust: By default the script posts to http://localhost:11434/api/chat. If you change OLLAMA_API_URL to a remote URL, those images (and any textual prompt) will be transmitted to that remote service. Only point it to endpoints you trust. - File validation is extension-based and the path-traversal check is simplistic ('..' substring). Don't feed files you don't trust; avoid symlink/renamed files containing sensitive content. - Automation caution: The README suggests using model output to drive clicks or inputs; make sure any automation steps are safe and tested before running with real privileges or on critical systems. Practical steps: run a local Ollama instance and keep OLLAMA_API_URL at its default if you want privacy; inspect or run the included script in a sandbox first; avoid passing images containing secrets; and do not set OLLAMA_API_URL to an external service unless you control or trust it.
Capability Analysis
Type: OpenClaw Skill Name: vision-helper Version: 1.0.0 The vision-helper skill is a utility designed to analyze images via Ollama, specifically addressing timeout limitations in built-in tools. The core script (scripts/analyze_image.py) is well-structured, using standard Python libraries and implementing security best practices such as path traversal checks and file extension validation. No evidence of data exfiltration, malicious execution, or obfuscation was found; the skill functions transparently as a wrapper for vision model APIs.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the included Python script encodes an image and calls an Ollama chat API with a vision model. The script supports model selection and extended timeout as advertised.
Instruction Scope
SKILL.md explicitly instructs using exec to take and analyze screenshots (browser, desktop tools) and to 'act' on analysis results (clicks/input). That is within the skill's stated automation use-cases, but it carries privacy and automation-safety implications (desktop screenshots may contain sensitive data; automated actions driven by model output can have undesired effects).
Install Mechanism
Instruction-only skill with no install spec; included script is plain Python and there are no downloads or external installers. This is a low-risk install surface.
Credentials
The registry metadata lists no required env vars, but SKILL.md and the script use optional env vars (OLLAMA_API_URL, VISION_MODEL, VISION_TIMEOUT). Defaults point to localhost, which is reasonable, but changing OLLAMA_API_URL to a remote endpoint would send base64-encoded images off-host. The env usage is proportionate to functionality but carries obvious exfiltration/privacy risks if pointed at an untrusted service. Also, the script enforces allowed extensions by filename only (and a simple '..' check), which could be abused if non-image data is disguised with an allowed extension.
Persistence & Privilege
always is false and the skill does not request ongoing system presence or modify other skills. It runs on-demand via exec and does not request elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install vision-helper
  3. After installation, invoke the skill by name or use /vision-helper
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Vision Helper, an image analysis skill using local or cloud vision models via Ollama. - Supports analyzing images, UI elements, screenshots, and performing OCR with extended timeout for cloud models (up to 180 seconds). - Bypasses built-in image tool limitations, including path restrictions and short timeouts. - Provides CLI and conversational usage examples, including workflows for browser, desktop, and game UI screenshots. - Allows easy switching between multiple supported local and cloud vision models via environment variables. - Supports various image formats and directory paths for flexible screenshot handling.
Metadata
Slug vision-helper
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Vision Helper — AI Image Analysis?

Analyze images using local or cloud vision models via Ollama to identify content, UI elements, screenshots, or extract text with OCR support. It is an AI Agent Skill for Claude Code / OpenClaw, with 77 downloads so far.

How do I install Vision Helper — AI Image Analysis?

Run "/install vision-helper" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Vision Helper — AI Image Analysis free?

Yes, Vision Helper — AI Image Analysis is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Vision Helper — AI Image Analysis support?

Vision Helper — AI Image Analysis is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Vision Helper — AI Image Analysis?

It is built and maintained by U3UT7 (@ravenquasar); the current version is v1.0.0.

💬 Comments