pdf-specialist-skill

pdf-specialist-skill is a skill for OpenCode from darellchua2/opencode-config-template. It costs 43 tokens per session (5,140 once invoked), scanned B, original, Apache-2.0.

A toolkit for creating, reading, editing, analyzing, and converting PDF files. PDF is a document format commonly used for fixed-layout files and forms.

In plain words
What is it for?
Use it to extract text and tables, merge or split pages, fill forms, add watermarks, encrypt files, run OCR on scans, convert pages to images, and create PDFs.
Why use it?
It handles PDF tasks that ordinary text editors do not, including scanned documents, forms, page operations, and embedded images.

Skill for OpenCode

Written for OpenCode: installed under .opencode/. Also seen: mentions OpenCode.

Good fit Use it to extract text and tables, merge or split pages, fill forms, add watermarks, encrypt files, run OCR on scans, convert pages to images, and create PDFs.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/darellchua2/opencode-config-template/pdf-specialist-skill
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add darellchua2/opencode-config-template --skill pdf-specialist-skill
Clone the repo
git clone --depth 1 https://github.com/darellchua2/opencode-config-template

Made for: OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pdf-specialist-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/darellchua2/opencode-config-template/pdf-specialist-skill/github.svg)](https://agentmods.dev/skills/darellchua2/opencode-config-template/pdf-specialist-skill)
Your own site
<a href="https://agentmods.dev/skills/darellchua2/opencode-config-template/pdf-specialist-skill"><img src="https://agentmods.dev/badge/skills/darellchua2/opencode-config-template/pdf-specialist-skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pdf-specialist-skill

Your own site · 80×15
<a href="https://agentmods.dev/skills/darellchua2/opencode-config-template/pdf-specialist-skill"><img src="https://agentmods.dev/badge/skills/darellchua2/opencode-config-template/pdf-specialist-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,140 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.05140
Opus 5 $0.00022 $0.02570
Sonnet 5 $0.00009 $0.01028
Haiku 4.5 $0.00004 $0.00514

Measured 5d ago against content hash 53e54d529641, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade B, and why

pdf-specialist-skill scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

The scan reads SKILL.md. This mod also ships 9 executable files (scripts/check_bounding_boxes.py, scripts/check_fillable_fields.py, scripts/convert_pdf_to_images.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo apt-get install poppler-utils qpdf pdftk
opencode_app/.opencode/skills/pdf-specialist-skill/SKILL.md · 733 lines

How it starts

The opening of the file, as written. The whole thing — 733 lines — stays where its author put it; the contents beside it link to each section on GitHub.

What I do

  • Extract text and tables from PDFs using pypdf, pdfplumber, or command-line tools (pdftotext)
  • Merge, split, and manipulate PDF files (rotate pages, add watermarks, encrypt/decrypt)
  • Fill PDF forms (fillable fields via pypdf, non-fillable via text annotations)
  • Convert PDFs to images and extract embedded images using poppler-utils
  • Create new PDFs from scratch using reportlab (professional reports, tables, complex layouts)
  • Perform OCR on scanned PDFs using pytesseract to make them searchable

When to use me

Use me when you need to work with PDF files:

  • PDF manipulation: Merge multiple PDFs, split into single pages, rotate pages, add watermarks
  • Text/table extraction: Extract text from digital PDFs, extract tabular data as structured data
  • PDF creation: Generate new PDFs from scratch, create reports with tables and formatting
  • Form filling: Fill fillable PDF forms or add text annotations to non-fillable forms
  • Image operations: Convert PDF pages to images, extract embedded images, create validation images with field overlays
  • OCR processing: Make scanned PDFs searchable by performing optical character recognition
  • Encryption: Add password protection to PDFs or decrypt password-protected files
  • Metadata handling: Read or modify PDF metadata (title, author, subject, creator)

Do NOT use me when:

  • Primary deliverable is a Word document (.docx)
  • Primary deliverable is a spreadsheet (Excel, CSV)
  • Task is general coding unrelated to PDF processing

Prerequisites

Required Tools

  • LibreOffice (for PDF conversion tasks)
    • Automatically configured by scripts/soffice.py on first run
    • Handles sandboxed environments with Unix socket restrictions

Python Libraries

  • pypdf: Basic PDF operations (merge, split, rotate, metadata, encryption)
  • pdfplumber: Advanced text and table extraction with precise coordinates
  • reportlab: Create new PDFs from scratch with professional formatting
  • pypdfium2: Fast PDF rendering and image generation (optional, advanced)
  • pdf2image: Convert PDF pages to PNG images for visual analysis
  • pytesseract: OCR on scanned PDFs (optional)
  • Pillow: Image processing for validation images

Read the full file on GitHub · 733 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 733 lines · 43 tokens per session scan B 53e54d529641

Subscribe to this mod's changes

pdf-specialist-skill is a skill published in the GitHub repository darellchua2/opencode-config-template (6 stars, last pushed 2d ago), licensed Apache-2.0. It adds 43 tokens to every session and 5,140 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

pdf-processing

Process and extract information from PDF documents. Use this skill when the user asks to read, analyze, or extract data from PDF files.

MervinPraison/PraisonAI · 30 tokens

nano-pdf

Edit PDFs with natural-language instructions using the nano-pdf CLI. Modify text, fix typos, update titles, and make content changes to specific pages without manual editing.

graniet/kheish · 34 tokens

pdf_convert

Convert between PDF and image formats. Use when: user asks to convert PDF pages to images (PNG/JPEG) or combine images into a PDF. NOT for: text extraction (use pdfreader), PDF editing, or document format conversion (DOCX/HTML).

ericwang915/PythonClaw · 56 tokens

pdf_merge

Merge multiple PDF files into a single PDF. Use when: user asks to combine, join, or concatenate PDFs. Supports page selection and ordering. NOT for: splitting PDFs, editing content, or converting formats.

ericwang915/PythonClaw · 45 tokens

pdf_protect

Add or remove password protection on PDF files. Use when: user asks to encrypt, password-protect, unlock, or decrypt a PDF. Supports owner and user passwords with permission controls. NOT for: digital signatures, certificate-based encryption, or DRM.

ericwang915/PythonClaw · 54 tokens

pdf_reader

Extract text content from PDF files. Use when: user asks to read, extract, or analyze content from a PDF document. Supports multi-page extraction, page ranges, and metadata. NOT for: scanned/image PDFs (OCR), PDF editing, or creating PDFs.

ericwang915/PythonClaw · 55 tokens