Agent skill

PDF

Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

ProprietaryAuto-check: notesDocuments & Office

Install PDF

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install zai-org/ZCode pdf --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .claude/skills/pdf && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .claude/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install zai-org/ZCode pdf --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .agents/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .agents/skills/pdf && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .agents/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install zai-org/ZCode pdf --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .cursor/skills/pdf && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .cursor/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/zai-org/ZCode.git --path apps/zcode-cli/packages/pdf-plugin/skills/pdf

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install zai-org/ZCode pdf --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .gemini/skills/pdf && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .gemini/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install zai-org/ZCode pdf

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .github/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .github/skills/pdf && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .github/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add zai-org/ZCode --skill pdf -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install zai-org/ZCode pdf --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/zai-org/ZCode.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/apps/zcode-cli/packages/pdf-plugin/skills/pdf .opencode/skills/pdf && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pdf" agent skill from https://github.com/zai-org/ZCode/tree/main/apps/zcode-cli/packages/pdf-plugin/skills/pdf into .opencode/skills/pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pdf", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pdf
GitHub stars: 7.7k
Token cost: ~18k tokens
SKILL.md length: 7,088 words
Files: 43 (incl. scripts, references)
Skills in repo: 5
Repo updated: Oct 10, 2026
First seen: Oct 11, 2026
Licence: Proprietary

At a glance

Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

Works in 4 steps: Emoji Check - Scan user content for… → CJK Check - Chinese/Japanese/Korean… → Size Check - Non-standard page sizes… → …
Any conversion whose output is a PDF: Office → PDF (.docx/.doc/.pptx/.ppt/.xlsx/.xls/.odt/.odp/.ods/.rtf/.csv/.txt → PDF)
SKILL.md covers Quick Setup, Triage, Briefing and Shared Assets, plus 4 more sections
Runs Shell scripts from its folder; calls python3, node and bash; reaches mirrors.tuna.tsinghua.edu.cn

What it does

PDF is an agent skill from zai-org/ZCode. Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing. Routes automatically by document type and supports reports, posters, papers, resumes, extraction, merging, splitting, and form filling. Use this skill for any conversion whose output is a PDF: Office → PDF (.docx/.doc/.pptx/.ppt/.xlsx/.xls/.odt/.odp/.ods/.rtf/.csv/.txt → PDF), HTML → PDF, and LaTeX/.tex → PDF; also PDF → images, PDF → text, and PDF → tables when reading a PDF apart…

Its SKILL.md is about 18k tokens, which your agent loads only when the skill is triggered. The skill folder holds 45 other files, including scripts and reference files (for example `briefs/academic.md`, `briefs/creative-fixed-canvas.md` and `briefs/creative-flow.md`).

It sits in Documents & Office, covering PDF, LaTeX and Excel spreadsheets. It works with Microsoft Excel, LaTeX, Microsoft PowerPoint and Microsoft Word. The repository describes itself as: Z.ai's coding agent harness. Powerful, intelligent, extensible.

When your agent uses it

Any conversion whose output is a PDF: Office → PDF (.docx/.doc/.pptx/.ppt/.xlsx/.xls/.odt/.odp/.ods/.rtf/.csv/.txt → PDF)
LaTeX/.tex → PDF
Also PDF → images
PDF → tables when reading a PDF apart

Example prompts

“Word转PDF”
“PPT转PDF”
“Excel转PDF”
“/pdf”

Requirements

Python 3
A Bash shell

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Emoji Check - Scan user content for intentional emoji (decorative 📊🎯🔥, not OS-level emoji input). If found → force Creative brief…
CJK Check - Chinese/Japanese/Korean content needs font coverage. Report brief must use UniSong/UniHei registered fonts; Creative brief…
Size Check - Non-standard page sizes (not A4/Letter/A3) → prefer Creative brief (Playwright handles any dimension). ReportLab can do…
Character Safety Check - Before writing any content string, scan for Japanese kana (の、が、は etc.), unusual Unicode symbols, or non-CJK…

What it can do on your machine

Read from SKILL.md and the folder at commit aac4755. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Shell, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- python3
- node
- bash
- brew
- apt
- winget
- soffice
- pip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- mirrors.tuna.tsinghua.edu.cn
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PDF loads about 18k tokens when it runs, and up to ~21k if it reads all its reference files. Until then it costs about 192 tokens; SKILL.md has 7,088 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~192
When it runs · the whole SKILL.md, loaded when a task matches: ~18k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~21k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteRuns commands with sudoSKILL.md:706

> `sudo apt install libreoffice-core` / `winget install TheDocumentFoundation.LibreOffice` as

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Proprietary) doesn't allow us to republish the file, so here is its outline and opening line. It has 7,088 words (~18,055 tokens).

“Determine task weight to control how much context to load:”

— opening of SKILL.md by zai-org, Proprietary

name: pdf
metadata.author: Z.AI
metadata.version: 1.1
license: Proprietary. LICENSE.txt has complete terms

Outline of SKILL.md

PDF - Document Production Workbench
Quick Setup
Triage
⚠️ Pre-Routing Checks (run BEFORE matching brief)
Briefing
Detection Keywords
Complete Scenario Routing Matrix
Special Routing Rules
Shared Assets
Content Rules
HTML Image Source Path Rules
Figure & Diagram Embedding (All Briefs)
Iron Rule: Figures Are Block-Level
Complex Diagram Strategy
Diagram Content Quality Rules (Cross-reference: charts)
Diagram Generation Strategy (Per-Brief)
Vector Rendering Iron Rule
HTML→PDF Engine Selection Rules
No overflow:hidden on Fixed-Size Pages (html2pdf-next.js only)
Full-Bleed Rule (No White Margins)
Background Color Consistency (No Color Mismatch)
Overflow Prevention System
Table Overflow Prevention (ReportLab)
Table Overflow Prevention (LaTeX/Academic)
Playwright PDF CSS Blacklist
PDF Metadata (all briefs)
Delivery Summary (all briefs)
Tooling Reference
CLI: python3 "$PDF_SKILL_DIR/scripts/pdf.py"
Poster/HTML/LaTeX Validator: python3 "$PDF_SKILL_DIR/scripts/poster_validate.py"

Read the full SKILL.md on GitHub

Files

SKILL.md and 42 other files (scripts, references) in apps/zcode-cli/packages/pdf-plugin/skills/pdf of zai-org/ZCode.

SKILL.md
LICENSE.txt
briefs/academic.md
briefs/creative-fixed-canvas.md
briefs/creative-flow.md
briefs/creative.md
briefs/poster.md
briefs/process-advanced.md
briefs/process.md
briefs/report.md
briefs/resume.md
configs/components.md
configs/fonts.md
configs/visual_framework.md
env_setup/env_check.sh
env_setup/font_list.txt
env_setup/setup.md
env_setup/setup_mac_linux.sh
… and 25 more

Open the folder on GitHubat commit aac4755

Compare with similar skills

PDF next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PDF compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
PDF this skillzai-org/ZCode	7.7k	—	~18k	Automated safety check: Notes	Proprietary	today
Office ArtifactsPrismer-AI/PrismerCloud	1.6k	—	~2.6k	Automated safety check: Pass	MIT	today
Document Converterwentorai/Research-Claw	858	—	~1.3k	Automated safety check: Pass	Custom licence	1 mo ago
MarkitdownImCa0/just-laws	781	14 repos	~3.2k	Automated safety check: Notes	MIT	3 days ago
Markitdownjimmc414/Kosmos	595	2 repos	~1.7k	Automated safety check: Pass	None	2 days ago
MineruNebutra/MinerU-Skill	123	—	~504	Automated safety check: Pass	MIT	17 days ago

Similar skills

Office Artifacts
Prismer-AI/PrismerCloud
Generate real DOCX, PPTX, XLSX, PDF, CSV files using python-docx / python-pptx / openpyxl / reportlab by writing them into the dispatch artifacts dir, then explicitly deliver each one with cloud…
1.6k GitHub stars~2.6k tokensUpdated today
Documents & OfficeAuto-check passed
Document Converter
wentorai/Research-Claw
Convert Office documents (PPTX, DOCX, XLSX, PDF, HTML, CSV, JSON, XML, images) to Markdown using Microsoft MarkItDown.
858 GitHub stars~1.3k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
781 GitHub starsUsed in 14 repos~3.2k tokens
Documents & OfficeAuto-check: notes
Markitdown
jimmc414/Kosmos
Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing.
595 GitHub starsUsed in 2 repos~1.7k tokens
Documents & OfficeAuto-check passed
Mineru
Nebutra/MinerU-Skill
An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.
123 GitHub stars~504 tokensUpdated 17 days ago
Documents & OfficeAuto-check passed
Office Documents
ZS520L/HanakoPro
A skill your agent uses when the user asks to open, read, inspect, understand, summarize, analyze, extract tables/text from, modify, update, repair, split, merge, rotate, or convert information from…
103 GitHub stars~1.6k tokensUpdated 4 mo ago
Documents & OfficeAuto-check passed

Questions about PDF

What does PDF do?

Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing. PDF is an agent skill from zai-org/ZCode. Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

When should I use PDF?

PDF fits situations like: any conversion whose output is a PDF: Office → PDF (.docx/.doc/.pptx/.ppt/.xlsx/.xls/.odt/.odp/.ods/.rtf/.csv/.txt → PDF); laTeX/.tex → PDF; also PDF → images; PDF → tables when reading a PDF apart.

How do I install PDF in Claude Code?

Run `npx skills add zai-org/ZCode --skill pdf -a claude-code`. Or copy the skill folder (apps/zcode-cli/packages/pdf-plugin/skills/pdf in zai-org/ZCode) into .claude/skills/pdf in your project. Claude Code loads it when a task matches its description.

How do I install PDF in Codex?

Run `npx skills add zai-org/ZCode --skill pdf -a codex`. Or copy the skill folder (apps/zcode-cli/packages/pdf-plugin/skills/pdf in zai-org/ZCode) into .agents/skills/pdf in your project. Codex loads it when a task matches its description.

Can I use PDF in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zai-org/ZCode --skill pdf -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdf, .gemini/skills/pdf, .github/skills/pdf and .opencode/skills/pdf in your project.

What does PDF need to run?

Going by SKILL.md and its folder, PDF needs a shell for the scripts in its folder and the command-line tools its instructions call (python3, node, bash, brew, apt and winget). Our summary lists: Python 3; A Bash shell.

Does PDF access the network?

SKILL.md names 1 domain. In commands or code: mirrors.tuna.tsinghua.edu.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is PDF safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does PDF use?

PDF carries a proprietary licence (declared in SKILL.md). It is published on GitHub, but it is not open source: read the licence file before using or sharing it.

How many tokens does PDF use?

About 18k tokens (SKILL.md is roughly 72k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to PDF?

Skills that share tags, products or a category with PDF: Office Artifacts (Prismer-AI/PrismerCloud, 1.6k stars), Document Converter (wentorai/Research-Claw, 858 stars), Markitdown (ImCa0/just-laws, 781 stars) and Markitdown (jimmc414/Kosmos, 595 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF?

zai-org (a GitHub organization) maintains it in zai-org/ZCode, which has 7,659 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 10, 2026.

Source: zai-org/ZCode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

PDF

Install PDF

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Office Artifacts

Document Converter

Markitdown

Markitdown

Mineru

Office Documents

More from zai-org/ZCode

DOCX

Visualize

Restore Legacy Sessions

Zcode Large Task Fixture

Architecture Governance

XLSX

Questions about PDF

Install PDF

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from zai-org/ZCode

Related

Questions about PDF