deepseek-ocr — Claude Code skill: what it does, how to install
Teaches your coding agent to run DeepSeek-OCR for document parsing and markdown extraction. Works with images and PDFs via vLLM or Transformers.
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a claude-codeWhat deepseek-ocr does
This skill guides coding agents through configuring DeepSeek-OCR pipelines. The model processes visual document inputs and outputs structured markdown or plain text. It covers dedicated prompt formats for tabular data extraction, bounding box detection via grounding tokens, and chart interpretation.
Setups can use HuggingFace Transformers for isolated runs or vLLM when batch performance matters. The instructions include logit processing configurations with NGramPerReqLogitsProcessor to preserve HTML table tags. Execution fails without CUDA 11.8+ and PyTorch 2.6.0.
What it helps with
- convert scanned multi-page PDFs into formatted markdown
- extract plain text from document pictures without layout tags
- parse diagrams and visual charts into text
- detect bounding coordinates for target words on a page
Example prompts for the agent
- Convert
contract.pdfto markdown using the DeepSeek-OCR vLLM script - Write a HuggingFace inference script to parse
chart.png - Extract all text from
invoice.jpgwithout layout structure
How to install deepseek-ocr
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a claude-code2Manually: put the files in place
~/.claude/skills/deepseek-ocr/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deepseek-ocr/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a codex2Manually: put the files in place
.agents/skills/deepseek-ocr/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a cursor2Manually: put the files in place
.cursor/skills/deepseek-ocr/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills deepseek-ocr2Manually: put the files in place
.github/skills/deepseek-ocr/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/deepseek-ocrManually: put the files in place
.devin/skills/deepseek-ocr/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deepseek-ocr
How to install deepseek-ocr in Claude Code?
Run npx skills add reason-machines/trending-skills --skill deepseek-ocr -a claude-code in your terminal.
What does deepseek-ocr do?
It supplies the agent with prompt templates and execution patterns to run DeepSeek-OCR on PDFs and images.
What dependencies are needed to run the model?
The setup requires Python 3.12.9, PyTorch 2.6.0, and CUDA 11.8+. You also need either vLLM 0.8.5 or HuggingFace Transformers alongside flash-attn==2.7.3.