pdf

Manipulate PDF files — extract text, count pages, render thumbnails, merge or split documents. Use for PDF-specific operations that don't fit `markdown-converter` (general read) or `pandic-office` (write from markdown).

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is lean and highly actionable with executable commands and code throughout. The main gap is the absence of verification steps for the batch merge/split operations, which caps workflow clarity.

Suggestions

Add a quick verification step after merge/split (e.g., `pdfinfo merged.pdf | grep Pages` or check that page count matches) so batch operations have an explicit checkpoint.

Consider factoring the repeated `/workspace/$(basename "$PWD")/` path prefix into a short variable at the top of each snippet to reduce noise and error risk.

Dimension	Reasoning	Score
Conciseness	Lean body that assumes Claude's competence — it lists shipped tools and jumps to executable recipes without explaining what a PDF is or how libraries work; every section earns its place.	3 / 3
Actionability	Provides fully executable, copy-paste-ready commands (pdftotext, pdfinfo, pdftoppm) and complete pypdf Python snippets for merge, split, and metadata edits.	3 / 3
Workflow Clarity	Each operation is presented as a clear single recipe, but batch operations like split (per-page files) and merge have no verification checkpoint confirming the output, which caps clarity at 2 per the batch-operations guideline.	2 / 3
Progressive Disclosure	Self-contained skill with no bundle files and well-organized sections (Common operations subsections plus a "When NOT to use" routing section); appropriate for a compact single-file skill needing no external references.	3 / 3
	Total	11 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise, specific, and clearly distinguishes the skill from related ones. It answers both what and when with natural trigger language in third-person voice.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "extract text, count pages, render thumbnails, merge or split documents" — matching the top anchor for specific concrete actions.	3 / 3
Completeness	Explicitly states both what it does (manipulate/extract/count/render/merge/split) and when to use it via the "Use for PDF-specific operations..." trigger clause.	3 / 3
Trigger Term Quality	Uses natural terms users would say ("PDF files", "extract text", "count pages", "merge or split documents"); coverage is strong though it omits minor variations like "PDFs" or ".pdf".	3 / 3
Distinctiveness Conflict Risk	Explicitly carves out a niche by contrasting with `markdown-converter` (general read) and `pandic-office` (write), giving it clear distinct triggers unlikely to conflict.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: Team-Commonly/commonly
Path: backend/commonly-bundled-skills/pdf/SKILL.md
Commit: 69b6005

Reviewed: about 18 hours ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.