# deepseek-ocr

Teaches your coding agent to run DeepSeek-OCR for document parsing and markdown extraction. Works with images and PDFs via vLLM or Transformers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/deepseek-ocr/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/deepseek-ocr

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/deepseek-ocr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/deepseek-ocr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/deepseek-ocr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/deepseek-ocr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills deepseek-ocr
```

2. **Manually: put the files in place**
- File: `.github/skills/deepseek-ocr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/deepseek-ocr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/deepseek-ocr/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill deepseek-ocr -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/deepseek-ocr/SKILL.md

## When to use it
- 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
- Convert `contract.pdf` to markdown using the DeepSeek-OCR vLLM script
- Write a HuggingFace inference script to parse `chart.png`
- Extract all text from `invoice.jpg` without layout structure

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md