ocr
OCR image files using the Qwen VL model via the bundled scripts/ocr.py (lives in this skill's directory, NOT your cwd). Use when the user asks to extract text from an image, perform OCR on a photo or screenshot, or recognize characters in an image file (.jpg, .jpeg, .png, .gif, .webp). Requires QWEN_API_KEY and QWEN_BASE_URL (env vars, or a .env in the skill directory).
Best use case
ocr is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
OCR image files using the Qwen VL model via the bundled scripts/ocr.py (lives in this skill's directory, NOT your cwd). Use when the user asks to extract text from an image, perform OCR on a photo or screenshot, or recognize characters in an image file (.jpg, .jpeg, .png, .gif, .webp). Requires QWEN_API_KEY and QWEN_BASE_URL (env vars, or a .env in the skill directory).
Teams using ocr should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ocr/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ocr Compares
| Feature / Agent | ocr | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
OCR image files using the Qwen VL model via the bundled scripts/ocr.py (lives in this skill's directory, NOT your cwd). Use when the user asks to extract text from an image, perform OCR on a photo or screenshot, or recognize characters in an image file (.jpg, .jpeg, .png, .gif, .webp). Requires QWEN_API_KEY and QWEN_BASE_URL (env vars, or a .env in the skill directory).
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# OCR Skill Extract text from images using `scripts/ocr.py` (Qwen VL OCR model). **Path note**: this skill's files live in the directory containing this SKILL.md — written as `<skill-dir>` below. It is shown on the `Skill directory:` line when the skill is activated (the activation message also lists the script's absolute path). The script is at `<skill-dir>/scripts/ocr.py`, NOT in your current working directory. ## Prerequisites `QWEN_API_KEY` and `QWEN_BASE_URL`, read in this order (first found wins): 1. process environment variables 2. `.env` in your current working directory 3. `<skill-dir>/.env` (recommended place to keep them) 4. `~/.env` (user-wide fallback) ``` QWEN_API_KEY=your_key QWEN_BASE_URL=https://your-base-url ``` No dependency setup needed: the script carries inline metadata (PEP 723), so `uv run` resolves `openai` / `python-dotenv` automatically in any directory. Do NOT run `uv add` — your cwd is usually not a Python project. ## Usage ```bash uv run "<skill-dir>/scripts/ocr.py" <image_file> ``` Substitute `<skill-dir>` with the absolute skill directory before running — it is NOT a shell variable. Output is printed to stdout. If credentials are missing, the script exits with an error telling you where to put them. ## Workflow 1. Confirm the image file path with the user if not provided 2. Run the script with the image path 3. Present the extracted text to the user 4. If the user wants to save the output, write it to a `.txt` file ## Notes - Blurry or overexposed single characters are replaced with `?` - Supported formats: `.jpg` `.jpeg` `.png` `.gif` `.webp`
Related Skills
skill-creator
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, update or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
support-triage
Use for every inbound support ticket. Defines triage policy, tone, and escalation rules.
zootopia-ppt
将用户的演示讲稿转化为拟人化动物世界主题的演示文稿图像（顶级3D动画电影风格）。 分三步：① 理解演讲内容与受众 ② 生成每页的3D动画电影风格生图提示词（Markdown 格式，保存到 workspace/docs/outline/） ③ 调用 image_gen_ppt.py 批量生成图像（保存到 workspace/docs/slides/）。 触发条件：用户提供演示稿/PPT 内容，要求制作 疯狂动物城风格 / 拟人化动物 / 3D动画电影风格的图像或演示文稿。
pro-ppt
将用户的演示讲稿转化为「专业 · 高级感」风格的演示文稿图像（高端商务编辑风）。 视觉特征：极浅灰主色（#F2F2F2）、金属灰辅色、金色点缀、深蓝灰背景（#0F233B），整体克制、克莱因蓝调、印刷品级质感。 分三步：① 理解演讲内容与受众 ② 生成每页高级商务视觉提示词（Markdown 格式，保存到 workspace/docs/outline/） ③ 调用 image_gen_ppt.py 批量生成图像（保存到 workspace/docs/slides/）。 触发条件：用户提供演讲稿/PPT 内容，要求制作 专业 / 高级感 / 高端商务 / 企业级 / 资本市场 / 咨询风 / 编辑风 的演示文稿。
kanban-tasks
使用 agentao-kanban 看板进行任务管理（拆任务 / 状态流转 / 后台服务 / 看产物）。 本技能负责：① 初始化 .kanban/ 项目 ② 把需求拆成原子卡片入板 ③ 推动状态流转 INBOX → READY → DOING → REVIEW → DONE ④ 启停 daemon 与 Web UI ⑤ 察看卡片状态与产物。 触发关键词（中/英）：看板 / kanban / 任务管理 / task board / 拆任务 / 任务卡 / 排期 / WIP / dispatcher / orchestrator。 复合触发短语（一键启停）： • "启动 kanban" → daemon（mock 执行器，后台）+ Web UI（自动开浏览器） • "启动 kanban 真跑" → daemon（--executor agentao，真调 sub-agent）+ Web UI • "停止 kanban" → 先停 Web UI，再停 daemon
matplotlib-charts
Produce PNG charts with matplotlib. Save to chart-<slug>.png in the working directory.
duckdb-analyst
Use for any analytical question over ./data/*.parquet. Prefer DuckDB, always show the SQL.
daily-digest
Build a daily digest from curated sources. Follow the output contract strictly.
swe-cli-skills
Senior engineer CLI expertise for AI agents — workflows, safety guardrails, gotchas, and anti-patterns across cloud, IaC, containers, databases, dev tools, and platforms
PicoClaw Fleet
Orchestrate a fleet of remote PicoClaw workers over SSH for fast, ephemeral one-shot tasks.
VibeCollab — Setup Instructions for AI Assistants
You are helping a user set up VibeCollab in their project.
raycast-extension-docs
Guidance for building, debugging, and publishing Raycast extensions using the Raycast documentation set. Use when Codex needs to create or modify Raycast extensions (React/TypeScript/Node), consult Raycast API reference or UI components, build AI extensions, handle manifest/lifecycle/preferences, troubleshoot issues, or prepare/publish extensions to the Raycast Store or Teams.