How do I install the Ocr skill?

Run npx skillmds add majiayu000/ocr-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ocr?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ocr by majiayu000 — Agent Skill

Name: Ocr
Rating: 4.2 (5 reviews)
Author: majiayu000

Ocr

Processes documents through case.dev OCR for text and table extraction. Supports PDF and image files up to 500MB with page-level and word-level output. Use when the user mentions "OCR", "text extraction", "scan document", "digitize", "extract text from PDF", or needs word-level positional data from documents.

majiayu000 4e6edd8 2 files · 3.8 KB Updated Sep 9, 2026 567 repo stars

File contents

case.dev OCR

Production-grade document OCR with table extraction and word-level positional data. Processes PDFs and images (PNG, JPG, TIFF, BMP, WEBP) up to 500MB.

Requires the casedev CLI. See setup skill for installation and auth.

Process a Document

Submit a document URL for OCR:

casedev ocr process --document-url "https://example.com/contract.pdf" --json

Flags:

--document-url / --url (required) — publicly accessible URL or presigned vault URL
--document-id — optional identifier to tag the job
--engine — OCR engine override

Returns a job ID and initial status.

Check Job Status

casedev ocr status JOB_ID --json

Returns: ID, status, page count, created/completed timestamps.

Statuses: queued -> processing -> completed or failed.

Watch Until Complete

casedev ocr watch JOB_ID --json

Polls until the job finishes. Flags:

--interval / -i — poll interval in seconds (default: 3)
--timeout / -t — max wait in seconds (default: 900)

Word-Level Data

Retrieve word-level OCR output for a vault object:

casedev ocr words --vault VAULT_ID --object OBJECT_ID --json

This requires the document to be in a vault and have completed OCR ingestion. The object must be a PDF or image (audio/video files are rejected).

Flags:

--page — specific page number
--word-start — starting word index
--word-end — ending word index

Returns per-page word arrays with text, word index, and confidence scores.

Uses focused vault if set via casedev focus set --vault.

Common Workflow

OCR a document from a vault

# 1. Upload to vault (triggers automatic ingestion + OCR)
casedev vault object upload ./scanned-contract.pdf --vault VAULT_ID --json

# 2. Check ingestion status
casedev vault object list --vault VAULT_ID --json

# 3. Get word-level data
casedev ocr words --vault VAULT_ID --object OBJECT_ID --json

# 4. Get specific page range
casedev ocr words --vault VAULT_ID --object OBJECT_ID --page 3 --json

OCR an external document

# 1. Submit
casedev ocr process --document-url "https://storage.example.com/doc.pdf" --json

# 2. Watch
casedev ocr watch JOB_ID --json

Troubleshooting

"Invalid file type for OCR": OCR only supports PDFs and images (application/pdf, image/*). Check the object's content type with casedev vault object list.

"Invalid object ID for this vault": Run casedev vault object list --vault VAULT_ID to see valid object IDs.

Job stuck in "processing": Increase watch timeout with --timeout 1800. Large documents (100+ pages) take longer.

"OCR job failed": The document may be corrupted or in an unsupported format. Re-upload and retry.

---name: ocr-2description: Processes documents through case.dev OCR for text and table extraction. Supports PDF and image files up to 500MB with page-level and word-level output. Use when the user mentions "OCR", "text extraction", "scan document", "digitize", "extract text from PDF", or needs word-level positional data from documents.--- # case.dev OCR Production-grade document OCR with table extraction and word-level positional data. Processes PDFs and images (PNG, JPG, TIFF, BMP, WEBP) up to 500MB. Requires the `casedev` CLI. See `setup` skill for installation and auth. ## Process a Document Submit a document URL for OCR: ```bash casedev ocr process --document-url "https://example.com/contract.pdf" --json ``` Flags: - `--document-url` / `--url` (required) — publicly accessible URL or presigned vault URL - `--document-id` — optional identifier to tag the job - `--engine` — OCR engine override Returns a job ID and initial status. ## Check Job Status ```bash casedev ocr status JOB_ID --json ``` Returns: ID, status, page count, created/completed timestamps. Statuses: `queued` -> `processing` -> `completed` or `failed`. ## Watch Until Complete ```bash casedev ocr watch JOB_ID --json ``` Polls until the job finishes. Flags: - `--interval` / `-i` — poll interval in seconds (default: 3) - `--timeout` / `-t` — max wait in seconds (default: 900) ## Word-Level Data Retrieve word-level OCR output for a vault object: ```bash casedev ocr words --vault VAULT_ID --object OBJECT_ID --json ``` This requires the document to be in a vault and have completed OCR ingestion. The object must be a PDF or image (audio/video files are rejected). Flags: - `--page` — specific page number - `--word-start` — starting word index - `--word-end` — ending word index Returns per-page word arrays with text, word index, and confidence scores. Uses focused vault if set via `casedev focus set --vault`. ## Common Workflow ### OCR a document from a vault ```bash # 1. Upload to vault (triggers automatic ingestion + OCR) casedev vault object upload ./scanned-contract.pdf --vault VAULT_ID --json # 2. Check ingestion status casedev vault object list --vault VAULT_ID --json # 3. Get word-level data casedev ocr words --vault VAULT_ID --object OBJECT_ID --json # 4. Get specific page range casedev ocr words --vault VAULT_ID --object OBJECT_ID --page 3 --json ``` ### OCR an external document ```bash # 1. Submit casedev ocr process --document-url "https://storage.example.com/doc.pdf" --json # 2. Watch casedev ocr watch JOB_ID --json ``` ## Troubleshooting **"Invalid file type for OCR"**: OCR only supports PDFs and images (`application/pdf`, `image/*`). Check the object's content type with `casedev vault object list`. **"Invalid object ID for this vault"**: Run `casedev vault object list --vault VAULT_ID` to see valid object IDs. **Job stuck in "processing"**: Increase watch timeout with `--timeout 1800`. Large documents (100+ pages) take longer. **"OCR job failed"**: The document may be corrupted or in an unsupported format. Re-upload and retry.

Frequently asked questions