image-to-text
Skill210 starsChanged yesterdayMITView on GitHub
Converts one image into a faithful text description or OCR with the local 1.3B MiniCPM-V 4.6 GGUF model through llama.cpp, automatically preferring an available Vulkan GPU and falling back to CPU. Use when the user asks to describe, caption, transcribe, inspect, or extract visible details and text from PNG, JPEG, WebP, GIF, BMP, or TIFF images without a GPU or remote vision API.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- godot-fun/gaiword for word, first seen Nov 15, 2026
- pascalorg/skillstheir own version, first seen Apr 3, 2026
Other versions2 projects use a version of this.
Word for word · 1
- godot-fun/gai★ 210100% same
Edited · 0
None found.
Wrote their own version · 1
- pascalorg/skills★ 91same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository40 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/AGENTS.mdAGENTS.md
- ai-text-to-speechSkill
- audio-denoiseSkill
- audio-fadeSkill
- audio-loudness-normalizationSkill
- audio-sample-rate-standardizeSkill
- audio-splitSkill
- audio-to-oggSkill
- audio-to-textSkill
- audio-to-wavSkill
- audio-trimSkill
- audio-volume-adjustSkill
- file-naming-normalizationSkill
- git-commit-messageSkill
- image-inpaint-regionSkill
- image-region-remove-key-color-appSkill
- image-remove-backgroundSkill
- image-remove-white-backgroundSkill
- image-resizeSkill
- image-sprite-sheet-splitSkill
- image-to-pngSkill
- image-trimSkill
- storyboard-av-mixSkill
- storyboard-shot-to-htmlSkill
- storyboardSkill
- storyboard-ttsSkill
- video-4k-normalizationSkill
- video-bgmSkill
- video-compress-to-sizeSkill
- video-cutSkill
- video-merge-gpuSkill
- video-mergeSkill
- video-publishSkill
- video-remove-audioSkill
- video-to-4kSkill
- video-to-60fpsSkill
- video-to-mp4Skill
- video-to-ogvSkill
- video-to-wavSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 2 are distinctive, and 6 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
6
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 13
Run the official openbmb/MiniCPM-V-4.6-gguf Q4_K_M model locally with llama.cpp.
- Distinctive: line 17
Read and follow dependency-manager before running commands.
- Very specific: line 19
Run .ai/image-to-text/image_to_text.py through the default python manifest entry only.
- Very specific: line 21
Before inference, check the llama-cpp-gpu runtime with --list-devices.
- Very specific: line 22
Use --gpu or -GPU to require GPU inference and fail when unavailable.
- Very specific: line 23
Use --cpu to bypass detection and force CPU inference for troubleshooting or comparison.
- Very specific: line 41
Use --output description.md to also save UTF-8 text.
- Distinctive: line 49
Never identify a real person from appearance alone or infer sensitive traits not explicitly visible as text.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Image to Text
Run the official openbmb/MiniCPM-V-4.6-gguf Q4_K_M model locally with llama.cpp. Do not send images to remote APIs.
Rules
Read and follow dependency-manager before running commands.
- Run
.ai/image-to-text/image_to_text.pythrough the defaultpythonmanifest entry only. - Load the language model and multimodal projector only from
.dependency/minicpm-v-4.6/model. - Before inference, check the
llama-cpp-gpuruntime with--list-devices. Prefer it when a Vulkan device is reported; otherwise usellama-cpp-cpu. - Use
--gpuor-GPUto require GPU inference and fail when unavailable. - Use
--cputo bypass detection and force CPU inference for troubleshooting or comparison. - Preserve observable facts and clearly distinguish uncertainty from fact.
- Pass exactly one image file to
--imageper invocation.
Usage
.dependency/python/python.exe .ai/image-to-text/image_to_text.py --image C:\path\photo.png.dependency/python/python.exe .ai/image-to-text/image_to_text.py --image C:\path\photo.png -GPU.dependency/python/python.exe .ai/image-to-text/image_to_text.py --image C:\path\photo.png --cpuUse --output description.md to also save UTF-8 text. See cli/image-to-text.md for copy-paste commands.
Output guidance
- General description: mention scene, subjects, actions, composition, colors, and legible text.
- OCR: preserve reading order and line breaks where practical; mark uncertain characters with
[unclear]. - Accessibility alt text: be concise and omit decorative speculation.
- Structured extraction: request JSON explicitly and validate it before presenting it as machine-readable.
- Never identify a real person from appearance alone or infer sensitive traits not explicitly visible as text.
Troubleshooting
- Missing CPU runtime: verify
.dependency/llama-cpp-cpu/llama-mtmd-cli.exeexists. - GPU unavailable: verify
.dependency/llama-cpp-gpu/llama-mtmd-cli.exeexists and--list-devicesreports a Vulkan device. Update the graphics driver if necessary. - Missing model: verify
MiniCPM-V-4_6-Q4_K_M.ggufandmmproj-model-f16.ggufexist under.dependency/minicpm-v-4.6/model. - Out of memory: close other applications or use a smaller image; the official GGUF listing states approximately 2GB memory, but working memory varies with image size and context.
- Slow inference: CPU speed, core count, memory bandwidth, and image resolution directly affect latency.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

