Agent skill

PDF

by prapaa-ai in prapaa-ai/agav

Extract text from, merge, split, and fill PDF files. An agent skill from prapaa-ai/agav.

Apache-2.0Auto-check passedDocuments & Office

Install PDF

skills CLI
$ npx skills add prapaa-ai/agav --skill pdf -a claude-code

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

GitHub CLI
$ gh skill install prapaa-ai/agav 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/prapaa-ai/agav.git skills-src && mkdir -p .claude/skills && cp -r skills-src/source/skills/bundled/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
147
Token cost
~407 tokens
SKILL.md length
215 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Apache-2.0

At a glance

Extract text from, merge, split, and fill PDF files. An agent skill from prapaa-ai/agav.

  • Works in 7 steps: Determine the task → Check that pypdf is available: run… → Never modify a PDF in place. Write… → …
  • Tasks that involve PDF
  • Calls python and pip

What it does

PDF is an agent skill from prapaa-ai/agav. Extract text from, merge, split, and fill PDF files

Its SKILL.md is about 410 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering PDF. It works with pypdf. The repository describes itself as: Terminal-native AI coding assistant for real repositories. Inspect code, edit files, run tests, and verify changes from the CLI. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve PDF

Example prompts

  • “/pdf”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): read_file, write_file, run_command, find_files, list_directory

Workflow steps

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

  1. Determine the task
  2. Check that pypdf is available: run python -c "import pypdf". If it fails, install it with pip install pypdf (requires user approval) and…
  3. Never modify a PDF in place. Write output to a new file (merged.pdf, page-3.pdf, filled-form.pdf) and keep the original untouched.
  4. Before merging or splitting, confirm the page order and selection with the user (e.g. "pages 1, 3, 7-9 in this order").
  5. For scanned documents where read_file shows images instead of text, say so plainly: text extraction requires OCR, which this skill does…
  6. After writing output, verify the new file opens (PdfReader succeeds) and report: page count, output path, and anything skipped (encrypted…
  7. If the user wants a Word or PowerPoint file instead of PDF manipulation, hand off to the docx or pptx skill.

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • read_file
    • write_file
    • run_command
    • find_files
    • list_directory

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

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

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

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 prapaa-ai/agav at commit 9e9582a, republished under its Apache-2.0 licence (© prapaa-ai). 215 words, ~407 tokens.

Download SKILL.mdSave it as .claude/skills/pdf/SKILL.md (or your agent's skills folder).
name
pdf
description
Extract text from, merge, split, and fill PDF files
allowed-tools
read_file, write_file, run_command, find_files, list_directory
version
1.0.0
invocation
both
tags
documents, pdf

PDF Handling (pdf)

Read, extract, merge, split, and fill PDF files.

Instructions

  1. Determine the task:
    • Read/Extract: use agav's read_file tool first — it renders PDF pages directly. Fall back to Python (pypdf) for programmatic text extraction across many pages.
    • Merge/Split/Rotate: use pypdf (PdfWriter, PdfReader).
    • Fill forms: use pypdf to inspect field names (get_fields()), report them to the user, then fill with the user's values.
  2. Check that pypdf is available: run python -c "import pypdf". If it fails, install it with pip install pypdf (requires user approval) and tell the user if installation is not possible.
  3. Never modify a PDF in place. Write output to a new file (merged.pdf, page-3.pdf, filled-form.pdf) and keep the original untouched.
  4. Before merging or splitting, confirm the page order and selection with the user (e.g. "pages 1, 3, 7-9 in this order").
  5. For scanned documents where read_file shows images instead of text, say so plainly: text extraction requires OCR, which this skill does not perform. Do not guess at invisible content.
  6. After writing output, verify the new file opens (PdfReader succeeds) and report: page count, output path, and anything skipped (encrypted pages, unreadable fields).
  7. If the user wants a Word or PowerPoint file instead of PDF manipulation, hand off to the docx or pptx skill.

© prapaa-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in source/skills/bundled/pdf of prapaa-ai/agav.

Open the folder on GitHubat commit 9e9582a

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 skillprapaa-ai/agav147—~407Automated safety check: PassApache-2.0
PDFnuoyimanaituling/manus-x830—~985Automated safety check: PassNone
PDFeinverne/dotfiles12147 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 47 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 22 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 prapaa-ai/agav

All 12 skills in this repo
  • Skill Creator

    prapaa-ai/agav

    Guide for authoring a new agav skill (SKILL.md). An agent skill from prapaa-ai/agav.

    147 GitHub stars~792 tokensUpdated today
    Auto-check passed
  • Git Commit

    prapaa-ai/agav

    Generate a commit message from staged changes. An agent skill from prapaa-ai/agav.

    147 GitHub stars~358 tokensUpdated today
    Auto-check passed
  • Data Clean

    prapaa-ai/agav

    Clean up and analyze CSV/Excel data for non-analysts. An agent skill from prapaa-ai/agav.

    147 GitHub stars~479 tokensUpdated today
    Auto-check passed
  • File Organizer

    prapaa-ai/agav

    Clean up a messy folder with a dry-run plan before moving anything

    147 GitHub stars~460 tokensUpdated today
    Auto-check passed
  • XLSX

    prapaa-ai/agav

    Create, read, and edit Excel .xlsx spreadsheets and CSV files

    147 GitHub stars~486 tokensUpdated today
    Auto-check passed
  • Code Review

    prapaa-ai/agav

    Review code changes for bugs, security issues, and improvements

    147 GitHub stars~384 tokensUpdated today
    Auto-check passed

Works with

Questions about PDF

What does PDF do?

Extract text from, merge, split, and fill PDF files. An agent skill from prapaa-ai/agav. PDF is an agent skill from prapaa-ai/agav.

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 prapaa-ai/agav --skill pdf -a claude-code`. Or copy the skill folder (source/skills/bundled/pdf in prapaa-ai/agav) 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 prapaa-ai/agav --skill pdf -a codex`. Or copy the skill folder (source/skills/bundled/pdf in prapaa-ai/agav) 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 prapaa-ai/agav --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 the command-line tools its instructions call (python and pip). Our summary lists: Python 3. Its frontmatter pre-approves these tools: read_file, write_file, run_command, find_files, list_directory.

Does PDF access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. 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 Apache-2.0 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 407 tokens (SKILL.md is roughly 1.6k 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?

prapaa-ai (a GitHub organization) maintains it in prapaa-ai/agav, which has 147 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 8, 2026.

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