ocr-scan

Transcribe handwritten or scanned documents into Markdown text.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jeff-hamm/ai-tools --skill ocr-scan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ocr-scan
Source: https://github.com/jeff-hamm/ai-tools/tree/main/src/skills/ocr-scan
Command: npx skills add https://github.com/jeff-hamm/ai-tools --skill ocr-scan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ai-backends, easyocr, and includes scripts (resource) and references (resource) components.

What problem does it solve?

OCR is a practical solution for turning handwritten or scanned documents into searchable, editable Markdown text. This skill streamlines archival, note-taking, and information sharing by producing consistent Markdown output from image-based sources.

Core Features & Use Cases

  • Multi-backend OCR: supports copilot-cli, github-api, gemini, openai, anthropic, cursor, and easyocr to maximize transcription accuracy.
  • Per-image outputs: writes a .ocr.md file next to each source image with provenance and source references.
  • Directory support: recursively scans directories for image files and processes them in batch for large collections.
  • Model-quality selection: automatically selects the best available backend/model via a centralized registry.

Quick Start

Provide an image file path or directory to OCR and generate per-image Markdown transcripts.

Frequently Asked Questions about ocr-scan

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

FAQPage Schema
How do I convert handwritten notes to Markdown?

To convert handwritten notes to Markdown, you provide an image file path to trigger multi-backend OCR transcription. The system processes the image and generates a per-image .ocr.md file containing the transcribed text and metadata.

Can I batch process a directory of scanned images for OCR transcription?

Yes, you can batch process a directory of scanned images for OCR transcription. The system recursively scans directories for image files and processes them in batch, writing a separate .ocr.md file next to each source image.

Does OCR transcription work with multiple AI backends like easyocr and openai?

Yes, OCR transcription works with multiple AI backends including easyocr, openai, anthropic, gemini, and others. A centralized model registry automatically selects the best available backend to maximize transcription accuracy.

What is the best way to OCR handwritten forms and receipts into editable text?

The best way to OCR handwritten forms and receipts into editable text is using multi-backend OCR with quality-based model selection. This approach automatically chooses the optimal backend to transcribe image-based sources into consistent Markdown transcripts.

How does the model registry select the best OCR backend for my images?

The model registry selects the best OCR backend for your images by evaluating quality-based criteria across supported backends. It automatically identifies and utilizes the best available model to maximize transcription accuracy for your handwritten or scanned documents.

What output format does OCR scanning generate for each processed image?

OCR scanning generates a per-image .ocr.md output file placed alongside the source image. This Markdown file contains the transcribed text along with provenance and source references for archival and information sharing.