【third-party】Add Claude Code Skills for PaddleOCR Document Parsing and Text Recognition by Aidenwu0209 · Pull Request #17690 · PaddlePaddle/PaddleOCR

Aidenwu0209 · 2026-02-10T03:14:47Z

Summary

Add two Claude Code skills for PaddleOCR API integration:
- paddleocr-doc-parsing: Document parsing with layout detection, table extraction, and markdown output
- paddleocr-text-recognition: OCR text recognition from images and PDFs
Each skill includes: API caller, configuration wizard, smoke test, optimization utilities
Shared .env configuration with PADDLEOCR_ACCESS_TOKEN

Changes

skills/paddleocr-doc-parsing/ — Document parsing skill (SKILL.md, scripts, references)
skills/paddleocr-text-recognition/ — Text recognition skill (SKILL.md, scripts, references)
.env.example — Environment variable template
README.md — Updated with skills section

Test plan

Run python scripts/configure.py to set up API credentials
Run python scripts/smoke_test.py to verify API connectivity
Test document parsing with sample PDF/image files
Test text recognition with sample images

🤖 Generated with Claude Code

paddle-bot · 2026-02-10T03:14:53Z

Thanks for your contribution!

…ition Add two Claude Code skills integrating PaddleOCR APIs: - paddleocr-doc-parsing: Document layout parsing with table extraction, formula recognition, and markdown output via PaddleOCR Document Parsing API - paddleocr-text-recognition: OCR text recognition from images and PDFs via PaddleOCR Text Recognition API Each skill includes: API caller, configuration wizard, smoke test, file optimization utilities, and reference documentation. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

skills/paddleocr-doc-parsing/scripts/lib.py

skills/paddleocr-doc-parsing/SKILL.md

Bobholamovic

这几个skill是否可以考虑不针对Claude Code，而是更通用一些，其他的AI产品也能使用：

https://agentskills.io/specification

.env.example

skills/paddleocr-text-recognition/scripts/lib.py

skills/paddleocr-text-recognition/references/provider_api.md

Bobholamovic · 2026-02-11T07:45:36Z

另外可能需要检查一下本地开发环境是否安装了pre-commit钩子；代码风格检查好像没有通过

Bobholamovic

赞！感觉doc parsing的部分已经很接近最终版本了，留了一些意见辛苦看看。doc parsing的ready之后，可以参考doc parsing 更新一下text recognition部分

README.md

skills/paddleocr-doc-parsing/references/output_schema.md

skills/paddleocr-doc-parsing/scripts/lib.py

skills/paddleocr-doc-parsing/scripts/optimize_file.py

skills/paddleocr-doc-parsing/scripts/vl_caller.py

skills/paddleocr-doc-parsing/SKILL.md

skills/paddleocr-doc-parsing/references/output_schema.md

skills/paddleocr-doc-parsing/scripts/optimize_file.py

skills/paddleocr-doc-parsing/scripts/smoke_test.py

skills/paddleocr-doc-parsing/SKILL.md

skills/paddleocr-text-recognition/SKILL.md

skills/.env.example

skills/paddleocr-doc-parsing/SKILL.md

Bobholamovic

有一些新的建议

skills/paddleocr-doc-parsing/references/output_schema.md

README.md

skills/paddleocr-text-recognition/SKILL.md

README.md

skills/paddleocr-text-recognition/SKILL.md

…chema

…action scope

…format

Aidenwu0209 · 2026-03-02T08:10:41Z

已修复 pre-commit 代码风格问题：

CRLF → LF：所有文件已转换为 LF 行尾
UTF-8 BOM：已移除多余的 BOM 标记
black 格式化：已修复 4 个 Python 文件的格式问题
flake8：检查通过（0 issues）

已在本地验证所有 pre-commit hook 检查通过。

skills/.env.example

Bobholamovic · 2026-03-02T15:07:48Z

skills/README.ch.md

@@ -0,0 +1,36 @@
+# PaddleOCR Skills（中文）
+
+本目录提供 PaddleOCR 云端 API 的 Agent Skills。


“PaddleOCR 云端 API” => “PaddleOCR 官方 API”

Done. Changed to「PaddleOCR 官方 API」.

Bobholamovic · 2026-03-02T15:09:16Z

skills/README.ch.md

+
+## 仓库
+
+- Source: <https://github.com/PaddlePaddle/PaddleOCR/tree/main/skills>


本身就在仓库里，应该就不用再专门这样写了

Done. Removed the 仓库/Repository section from both READMEs.

Bobholamovic · 2026-03-02T15:09:32Z

skills/README.ch.md

@@ -0,0 +1,36 @@
+# PaddleOCR Skills（中文）


不必标记“（中文）”

Done. Removed（中文）from the title.

skills/paddleocr-text-recognition/scripts/ocr_caller.py

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Remove （中文） from Chinese README title - Change 云端 API → 官方 API / cloud APIs → official APIs - Remove 仓库/Repository section (already in repo) - Remove UTF-8 BOM from both files Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add useDocUnwarping=False, useDocOrientationClassify=False, and visualize=False to match the doc-parsing defaults. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Replace real-looking API key/token examples with obvious placeholders - Recommend configure.py as primary setup method, .env as fallback Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Bobholamovic

LGTM

paddle-bot bot added the contributor label Feb 10, 2026

Aidenwu0209 mentioned this pull request Feb 10, 2026

【third-party】Add Claude Code Skills for PP-OCRv5 and PaddleOCR-VL #17659

Closed

7 tasks

Aidenwu0209 force-pushed the add-claude-code-skills branch from 06b0a54 to d0acca5 Compare February 10, 2026 07:59

Aidenwu0209 force-pushed the add-claude-code-skills branch from d0acca5 to 1ad68dc Compare February 10, 2026 08:56

Bobholamovic requested changes Feb 11, 2026

View reviewed changes

.env.example Outdated Show resolved Hide resolved

skills/paddleocr-text-recognition/scripts/lib.py Show resolved Hide resolved

skills/paddleocr-text-recognition/references/provider_api.md Outdated Show resolved Hide resolved

Aidenwu0209 force-pushed the add-claude-code-skills branch from ca44189 to 1ad68dc Compare February 12, 2026 05:16

Bobholamovic reviewed Feb 12, 2026

View reviewed changes

docs(skills): address PR PaddlePaddle#17690 review feedback (R01-R20)

9525cab

Aidenwu0209 force-pushed the add-claude-code-skills branch 3 times, most recently from 34d658c to e65ebee Compare February 13, 2026 03:49

docs(skills): consolidate today's endpoint and review alignment updates

f39934f

Aidenwu0209 force-pushed the add-claude-code-skills branch from 39e1969 to f39934f Compare February 13, 2026 05:05

chore: merge upstream main and resolve conflicts

3d9b376

Bobholamovic reviewed Feb 13, 2026

View reviewed changes

docs(skills): align 4h review feedback and credential guidance

1ba5b2f

Aidenwu0209 force-pushed the add-claude-code-skills branch from 31f0237 to 1ba5b2f Compare February 14, 2026 03:30

Bobholamovic requested changes Feb 27, 2026

View reviewed changes

Aidenwu0209 added 6 commits March 1, 2026 11:16

docs(skills): unify placeholder comment style in doc-parsing output s…

9e1131a

…chema

docs(skills): deduplicate text-recognition use cases and clarify extr…

0ef7653

…action scope

docs(skills): align text-recognition example naming with doc-parsing …

a31db65

…format

docs(skills): restore root README and add skills README in EN/ZH

2e882e6

docs(skills): fix license and repository links in skills readmes

33f96dd

docs(skills): remove AI Studio wording from skills docs and guidance

deb40ce

Bobholamovic reviewed Mar 2, 2026

View reviewed changes

Aidenwu0209 and others added 5 commits March 3, 2026 16:18

chore: move .env.example into skills/ directory

14711d3

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

fix(text-recognition): add default API params in ocr_caller

e190024

Add useDocUnwarping=False, useDocOrientationClassify=False, and visualize=False to match the doc-parsing defaults. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs(skills): add .env.example usage to Quick Start

aeb033e

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs(skills): fix .env.example placeholders and README config order

a5dac79

- Replace real-looking API key/token examples with obvious placeholders - Recommend configure.py as primary setup method, .env as fallback Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Bobholamovic approved these changes Mar 4, 2026

View reviewed changes

Merge branch 'main' into add-claude-code-skills

786d661

Bobholamovic merged commit a310955 into PaddlePaddle:main Mar 4, 2026
6 checks passed

Aidenwu0209 mentioned this pull request Mar 4, 2026

skills: add Client-Platform header for official skills #17766

Merged

		@@ -0,0 +1,36 @@
		# PaddleOCR Skills（中文）

		本目录提供 PaddleOCR 云端 API 的 Agent Skills。


		## 仓库

		- Source: <https://github.com/PaddlePaddle/PaddleOCR/tree/main/skills>

Conversation

Aidenwu0209 commented Feb 10, 2026

Summary

Changes

Test plan

Uh oh!

paddle-bot bot commented Feb 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Bobholamovic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Bobholamovic commented Feb 11, 2026

Uh oh!

Bobholamovic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Bobholamovic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Aidenwu0209 commented Mar 2, 2026

Uh oh!

Uh oh!

Bobholamovic Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

Aidenwu0209 Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

Bobholamovic Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

Aidenwu0209 Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

Bobholamovic Mar 2, 2026

Choose a reason for hiding this comment

Uh oh!

Aidenwu0209 Mar 3, 2026

Choose a reason for hiding this comment