pdf

Process PDF files - extract text, create PDFs, merge documents. Use when user asks to read PDF, create PDF, or work with PDF files.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/pdf/SKILL.md

Quality

Content

76%Weight 40%Scale 1-5

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

The content is highly actionable with complete, executable examples covering the core PDF operations and a useful library reference table. Its main weakness is the absence of validation/verification checkpoints for batch operations like merging and splitting.

Suggestions

Add explicit validation steps (e.g., verify the merged PDF opens and has the expected page count) after merge/split batch operations.

Include a brief error-recovery loop for failed text extraction (e.g., fall back to OCR when extraction returns empty).

Trim the conversational intro line ("You now have expertise in PDF manipulation") to improve token efficiency.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean executable code with minimal explanatory padding, though the intro line ("You now have expertise in PDF manipulation") and multiple labeled options add minor fluff.	4 / 5
Actionability	Copy-paste-ready code blocks cover the common cases (extract, create via three methods, merge, split) with concrete install hints, matching the fully-executable anchor.	5 / 5
Workflow Clarity	Tasks are organized by section but merging and splitting are batch operations with no validation or verify-retry checkpoints, which the rubric caps at 3.	3 / 5
Progressive Disclosure	A single well-organized SKILL.md with clear section headers and a library table; no bundle files exist so references are not applicable, and structure is good but not split across files.	4 / 5
	Total	16 / 20 Passed

Description

75%Weight 40%Scale 1-5

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 solid and well-structured, explicitly stating both capabilities and trigger conditions in a PDF-specific niche. It falls just short of top marks because its trigger vocabulary and action coverage are slightly less comprehensive than the exemplary anchors.

Suggestions

Add the missing actions (e.g., split PDFs, fill forms) to the capability list for comprehensive coverage.

Broaden trigger terms to include synonyms and extensions such as "PDFs", ".pdf", and "forms".

Tighten the "when" clause to reference specific tasks (e.g., "extract, merge, or split PDFs") rather than the generic "work with PDF files".

Dimension	Reasoning	Score
Specificity	Lists three concrete actions ("extract text, create PDFs, merge documents") which matches the several-specific-actions anchor, but is not comprehensive since splitting, forms, and image conversion are absent.	4 / 5
Completeness	Both what (extract/create/merge) and when ("Use when user asks to read PDF, create PDF, or work with PDF files") are explicit, but the trigger list is narrower than the level-5 anchor which includes forms and document extraction.	4 / 5
Trigger Term Quality	Natural trigger phrases like "read PDF", "create PDF", and "work with PDF files" are present, but synonyms ("PDFs") and the ".pdf" extension are missing.	4 / 5
Distinctiveness Conflict Risk	Clearly a PDF-specific niche with distinct triggers, but the broad phrase "work with PDF files" leaves minor overlap risk with general document skills.	4 / 5
	Total	16 / 20 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: shareAI-lab/learn-claude-code
Path: skills/pdf/SKILL.md
Commit: 0dcafa2

Reviewed: 8 days 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.