Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

MITAuto-check passedDocuments & Office

Install PDF

skills CLI
$ npx skills add codewhale-hq/Codewhale --skill pdf -a claude-code

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

GitHub CLI
$ gh skill install codewhale-hq/Codewhale 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/codewhale-hq/Codewhale.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/tui/assets/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/

Facts

Skill name
pdf
GitHub stars
41k
Token cost
~309 tokens
SKILL.md length
158 words
Files
2
Skills in repo
63
Repo updated
First seen
Licence
MIT

At a glance

Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

  • Works in 5 steps: Identify the PDF operation: read,… → Preserve originals. Write outputs with… → Use the most reliable available tool → …
  • Tasks that involve PDF
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

PDF is an agent skill from codewhale-hq/Codewhale. Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

Its SKILL.md is about 310 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `SKILL.generation-14.md`).

It sits in Documents & Office, covering PDF. It works with pypdf. The repository describes itself as: Open-source coding agent for your terminal, built in Rust and on a journey of continuous community improvement. Issues and PRs welcome. The licence is MIT.

When your agent uses it

  • Tasks that involve PDF

Example prompts

  • “/pdf”

Requirements

  • Python 3

Workflow steps

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

  1. Identify the PDF operation: read, extract, OCR, split, merge, rotate,
  2. Preserve originals. Write outputs with explicit names.
  3. Use the most reliable available tool
  4. For extraction, report page coverage and note when layout, tables, or OCR
  5. For generated or modified PDFs, verify page count, text extraction where

What it can do on your machine

Read from SKILL.md and the folder at commit ad333fd. 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

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 309 tokens when it runs. Until then it costs about 34 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~34
When it runs · the whole SKILL.md, loaded when a task matches
~309

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from codewhale-hq/Codewhale at commit ad333fd, republished under its MIT licence (© codewhale-hq). 158 words, ~309 tokens.

Download SKILL.mdSave it as .claude/skills/pdf/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
pdf
description
Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

PDF

Use this skill for any task where a PDF is the primary input or output.

Workflow

  1. Identify the PDF operation: read, extract, OCR, split, merge, rotate, watermark, redact, fill forms, encrypt/decrypt, or create.
  2. Preserve originals. Write outputs with explicit names.
  3. Use the most reliable available tool:
    • pdftotext, pdfinfo, qpdf, or mutool through bash when installed (the built-in read tool does not extract text from a PDF)
    • Python libraries such as pypdf, pdfplumber, PyMuPDF, or reportlab when available
    • OCR tools only for scanned pages
  4. For extraction, report page coverage and note when layout, tables, or OCR quality may affect accuracy.
  5. For generated or modified PDFs, verify page count, text extraction where possible, and file size. For redaction, confirm removed text is not extractable from the output.

Ask before installing dependencies or running OCR over large documents. Do not represent a visually scanned PDF as fully accurate text unless OCR quality has been checked.

© codewhale-hq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in crates/tui/assets/skills/pdf of codewhale-hq/Codewhale.

  • SKILL.md
  • SKILL.generation-14.md

Open the folder on GitHubat commit ad333fd

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PDF this skillcodewhale-hq/Codewhale41k—~309Automated safety check: PassMIT
PDFnuoyimanaituling/manus-x830—~985Automated safety check: PassNone
PDFeinverne/dotfiles12146 repos~1.8kAutomated safety check: PassProprietary
Reportlabjimmc414/Kosmos5941 repos~4.2kAutomated safety check: PassNone
PDFguyi-a/pi-ling106—~3.3kAutomated safety check: PassMIT
PDF ReadingWide-Moat/open-computer-use1261 repos~2.7kAutomated safety check: PassProprietary

Similar skills

  • PDF

    nuoyimanaituling/manus-x

    Process PDF files - extract text, read content, create PDFs, merge or split documents.

    830 GitHub stars~985 tokensUpdated 8 mo ago
    Documents & OfficeAuto-check passed
  • PDF

    einverne/dotfiles

    Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms.

    121 GitHub starsUsed in 46 repos~1.8k tokens
    Documents & OfficeAuto-check passed
  • Reportlab

    jimmc414/Kosmos

    PDF generation toolkit. An agent skill from jimmc414/Kosmos.

    594 GitHub starsUsed in 1 repo~4.2k tokens
    Documents & OfficeAuto-check passed
  • PDF

    guyi-a/pi-ling

    PDF 相关的所有操作:从零生成(reportlab / pypdf)、格式转化(md/html → PDF)、修改(合并 / 拆分 / 旋转 / 加水印 / 提图片 / 元数据)、读内容(pdfplumber / extractdocumenttext)、OCR 扫描件、加密解密。触发场景:用户说"生成 PDF" / "做份 PDF 简历" / "合并这几份 PDF" / "给 PDF…

    106 GitHub stars~3.3k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed
  • PDF Reading

    Wide-Moat/open-computer-use

    A skill your agent uses when you need to read, inspect, or extract content from PDF files — especially when file content is NOT in your context and you need to read it from disk.

    126 GitHub starsUsed in 1 repo~2.7k tokens
    Documents & OfficeAuto-check passed
  • PDF

    LeastBit/Claude_skills_zh-CN

    全面的 PDF 操作工具包,用于提取文本和表格、创建新 PDF、合并/拆分文档以及处理表单。当 Claude 需要填写 PDF 表单或以编程方式大规模处理、生成或分析 PDF 文档时使用。

    588 GitHub stars~1.5k tokensUpdated 8 mo ago
    Documents & OfficeAuto-check passed

More from codewhale-hq/Codewhale

All 63 skills in this repo
  • Codewhale Dogfood Install

    codewhale-hq/Codewhale

    Proves a Codewhale change in the real product: a stamped release build, an atomic local install, fresh-shell verification and manual QA that automated gates cannot cover.

    41k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Codewhale Session Handoff

    codewhale-hq/Codewhale

    Writes a paste-ready handoff for the next agent session, opening with a state-check command block and separating done, suspected and blocked work.

    41k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Codewhale Landing Workflow

    codewhale-hq/Codewhale

    Decides how verified work should reach main, directly, in a worktree or on an integration branch, while keeping contributor credit and respecting merge gates.

    41k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Sub-Agent Delegation

    codewhale-hq/Codewhale

    Guides when and how to split multi-step coding, research or verification work into focused sub-agent runs while the parent keeps integration and final checks.

    41k GitHub stars~790 tokensUpdated today
    Auto-check passed
  • Codewhale Fleet Manager

    codewhale-hq/Codewhale

    Triages and manages Codewhale fleet runs and workers with typed commands, classifying failures and choosing a safe restart, resume or escalation.

    41k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • GitHub Issue Bulk Assigner

    codewhale-hq/Codewhale

    Moves a list of GitHub issues into a milestone or assigns them to owners with the gh CLI, checking each one before and after the change.

    41k GitHub stars~953 tokensUpdated today
    Auto-check passed

Works with

Questions about PDF

What does PDF do?

Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction. PDF is an agent skill from codewhale-hq/Codewhale. Read, extract, split, merge, rotate, watermark, fill, OCR, or create PDF files with verification of page counts and text extraction.

When should I use PDF?

PDF fits situations like: tasks that involve PDF.

How do I install PDF in Claude Code?

Run `npx skills add codewhale-hq/Codewhale --skill pdf -a claude-code`. Or copy the skill folder (crates/tui/assets/skills/pdf in codewhale-hq/Codewhale) 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 codewhale-hq/Codewhale --skill pdf -a codex`. Or copy the skill folder (crates/tui/assets/skills/pdf in codewhale-hq/Codewhale) 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 codewhale-hq/Codewhale --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?

SKILL.md names no scripts, command-line tools or credentials: PDF is instructions for the agent only. Our summary lists: Python 3.

Does PDF access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PDF safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PDF use?

PDF is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PDF use?

About 309 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PDF?

Skills that share tags, products or a category with PDF: PDF (nuoyimanaituling/manus-x, 830 stars), PDF (einverne/dotfiles, 121 stars), Reportlab (jimmc414/Kosmos, 594 stars) and PDF (guyi-a/pi-ling, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF?

codewhale-hq (a GitHub organization) maintains it in codewhale-hq/Codewhale, which has 41,067 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on October 7, 2026.

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