pdf-parsing SKILL.md skillA

pdf-parsing from black-yt/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add black-yt/skills/pdf-parsing@git:20260713.9b7b32b

Pins git:20260713.9b7b32b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
black-yt/skills
Path
pdf-parsing/SKILL.md
Versions recorded
5
Latest version
git:20260713.9b7b32b, committed Jul 13, 2026
First version recorded
May 9, 2026
Size
8,555 bytes
Repository stars
16
License
none declared

当需要用 structai.read_pdf 将 PDF 文档解析成本地 Markdown、抽取图片资源,并处理 MinerU 解析缓存或代理重试问题时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# PDF 解析

## 目标

把 PDF 文档解析成本地可读取、可搜索、可复制的 Markdown,并抽取 PDF 中的图片资源。解析完成后,后续阅读应优先使用本地 Markdown 文件;重复调用 `structai.read_pdf` 也会优先复用本地解析结果,不会在本地结果已存在时重复上传同一个 PDF。

## 依赖安装

当前 skill 对照的关键解析依赖:

- `structai` package version:`0.1.24`。
- `structai` GitHub HEAD:`d20df602578bee124a9c93b293493e63212d0aab`。
- 更新本 skill 前,先确认 `structai.read_pdf` 行为是否变化;如果上游版本或 HEAD 变化,必须重新阅读 `read_pdf` 源码和 `structai_skill()` 输出。

```bash
pip install structai
```

如果包索引中找不到 `structai`,或需要使用 GitHub 仓库中的最新代码:

```bash
pip install "git+https://github.com/black-yt/structai.git"
```

校验:

```bash
python3 -c "from structai import read_pdf; import inspect; print(inspect.signature(read_pdf))"
```

如果当前环境同时有多个 Python,请确认 `pip` 和 `python3` 指向同一个环境:

```bash
python3 -m pip show structai
python3 -c "import structai; print(structai.__file__)"
```

## `read_pdf` 源码追溯

- `read_pdf` 行为以当前安装版本源码为准;如果缓存、上传、下载、图片路径或返回值和预期不一致,先读源码再判断。
- `inspect.signature(read_pdf)` 用于看函数参数。
- `inspect.getsource(read_pdf)` 用于看 `read_pdf` 入口逻辑。
- `structai.__file__` 和 `structai.pdf.__file__` 用于定位安装包源码文件。
- 源码只用于阅读和定位问题,不要改源码,不要直接修改 `site-packages` 或共享环境;需要改库时,先 clone `https://github.com/black-yt/structai`,在用户确认后用 editable install。

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add black-yt/skills/pdf-parsing@sha256:7d05be3a004fc063

The line at the top of this page pins the label git:20260713.9b7b32b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jjcuak2ylezxts6g.svg)](https://markdownregistry.com/a/art_jjcuak2ylezxts6g)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between May 9, 2026 and Jul 13, 2026, about one every 16 days.

versioncommittedcommitsizeaudit
git:20260713.9b7b32b latest2026-07-13 9b7b32b 8,555 BA view · diff
git:20260605.e7634082026-06-05 e763408 8,213 BA view · diff
git:20260509.b2dbdf82026-05-09 b2dbdf8 6,902 BA view · diff
git:20260509.02fca212026-05-09 02fca21 6,413 BA view · diff
git:20260509.ab5becd2026-05-09 ab5becd 6,395 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8555 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

black-yt/skills · 16 stars · license none declared · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jjcuak2ylezxts6g
GET https://markdownregistry.com/api/v1/resolve?ref=black-yt/skills/pdf-parsing
GET https://markdownregistry.com/api/v1/blob/7d05be3a004fc063fde863fd11346e4db2e4aecdf2f4d7ca67d2bd3c7b5c1b23

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from black-yt/skills

AGENTS.md AGENTS.md file
black-yt/skills · AGENTS.md
git:20260804.1ce2bfe · audit B · 16 stars
agent-orchestration SKILL.md skill
black-yt/skills · agent-orchestration/SKILL.md · 当任务包含大量相似工作、长时间管线或需要并行陪跑与异常修复时,组织主 Codex、原生子 agent 或 Claude Code/Atria 中层监督者,以及确定性底层执行者;控制权限、资源、证据和接管边界。
git:20261016.9ee6ddd · audit A · 16 stars
agents-md-maintenance SKILL.md skill
black-yt/skills · agents-md-maintenance/SKILL.md · 当需要创建、整理、拆分或维护仓库中的 AGENTS.md、CLAUDE.md 或同类默认加载 agent 操作指南时使用;覆盖常驻上下文边界、*.local/ 按需拆分、公开/私有跟踪策略、同步校验和安全编辑。
git:20260803.6c56440 · audit A · 16 stars
ai-conference-paper-writing SKILL.md skill
black-yt/skills · ai-conference-paper-writing/SKILL.md · 当需要撰写、重构或打磨 AI conference paper,或从通用 LaTeX 技术报告模板开始写论文时使用;覆盖 research story、章节结构、图表实验布局、引用、case study 和可复现评测。
git:20261027.fc8e805 · audit A · 16 stars
bilibili-video-download SKILL.md skill
black-yt/skills · bilibili-video-download/SKILL.md · 当用户要下载哔哩哔哩普通 BV 投稿视频为 MP4、选择画质或分 P,或将其音频导出为 MP3 时使用;提供完整的标准库 Python 下载脚本、ffmpeg 安装与调用步骤、登录态处理和结果验证。
git:20261022.f462695 · audit A · 16 stars
browser-render-visualization SKILL.md skill
black-yt/skills · browser-render-visualization/SKILL.md · 当需要用 Playwright 渲染网页前端、GitHub Pages、本地静态页面、Canvas 或 Three.js 页面并保存桌面/移动端截图、检查空白渲染、布局溢出和浏览器报错时使用。
git:20260605.e763408 · audit B · 16 stars
cloudflare-flux-image-generation SKILL.md skill
black-yt/skills · cloudflare-flux-image-generation/SKILL.md · 使用 Cloudflare Workers AI 的 FLUX.1 schnell 免费额度按文字生成 JPEG 图片时使用;覆盖账号注册、Workers AI API Token、Python 标准库脚本调用、额度核算和故障排查。
git:20261023.26b4d66 · audit A · 16 stars
codex-app-troubleshooting SKILL.md skill
black-yt/skills · codex-app-troubleshooting/SKILL.md · 排查 Codex App 登录、更新中断、WSL 后端、CLI 定位、项目迁移、MCP 和代理故障,保护 provider、活动对话与历史;也覆盖用户明确涉及的 CC Switch、Claude Code 代理迁移、Gemini CLI…
git:20261104.2f62771 · audit A · 16 stars
codex-history-sync SKILL.md skill
black-yt/skills · codex-history-sync/SKILL.md · 当需要把一个 CODEX_HOME/.codex 中的 Codex 会话记录、history.jsonl、sessions 和 thread title 元数据单向同步到另一个用户或目录下的 .codex 时使用;强调…
git:20260701.f15c195 · audit A · 16 stars
context-overlay SKILL.md skill
black-yt/skills · context-overlay/SKILL.md · Use when configuring or debugging the context-overlay OpenAI-compatible proxy for deterministic prompt/context…
git:20260713.9b7b32b · audit B · 16 stars
docx-splitting SKILL.md skill
black-yt/skills · docx-splitting/SKILL.md · 当需要在 Windows + Microsoft Word 环境中按页拆分 .docx 文件并尽量保留原始格式、图片、表格和分页效果时使用。
git:20260509.cdf62b1 · audit A · 16 stars
feishu-bot SKILL.md skill
black-yt/skills · feishu-bot/SKILL.md · 当需要创建、配置、调用或排查飞书/Lark 机器人时使用;覆盖自定义机器人 webhook 单向群通知、签名校验、消息格式、错误码,以及应用机器人收发消息、tenant_access_token、权限、事件订阅、卡片交互和资源上传。
git:20260613.d8ec3ec · audit A · 16 stars

Every file in black-yt/skills

Browse by kind, by grade A, or by owner.