pdf

Read, extract (text/tables), create, merge/split/rotate, watermark, encrypt, fill, and render-to-image .pdf files. Use whenever the user uploads a .pdf or asks to produce, edit, or pull data out of one.

Quality

91%

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

83%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.

A highly actionable, code-dense skill body that picks the right library per task and stays mostly lean. Its main weaknesses are a few verbose explanatory passages and the absence of explicit verification checkpoints on the destructive merge/split/encrypt workflows.

Suggestions

Add a short 'Verify' step after merge/split/encrypt/rotate operations (re-open the output with PdfReader and assert page count / is_encrypted) to mirror the form-filling verification pattern.

Trim the prose in the CJK and scanned-PDF sections to the essential gotchas; the code already carries most of the instruction.

Consider moving the long CJK font-registration block into a references/ file and keeping only the 'register a CJK font first' rule inline, improving progressive disclosure.

Dimension	Reasoning	Score
Conciseness	Largely lean and code-forward, but the CJK section and a few prose explanations (e.g., the sandbox/OCR honesty paragraphs) carry slightly more explanation than strictly necessary, keeping it just short of the fully lean anchor.	4 / 5
Actionability	Every section gives copy-paste-ready, executable Python covering the common cases (extract, tables, merge/split/rotate, watermark, encrypt, forms fillable+flat, render-to-image), with concrete library calls and parameters.	5 / 5
Workflow Clarity	Sequences are clear and the forms section includes an explicit 'Verify' checkpoint, but batch/destructive operations like merge/split/encrypt lack a re-open-and-validate feedback loop, which is a minor validation gap rather than the full checklist pattern.	4 / 5
Progressive Disclosure	No bundle files exist, yet the body is well organized into task-based sections with clear headers and an opening library-selection guide; minor gap is that the substantial CJK and forms content could live in reference files but is inlined.	4 / 5
	Total	17 / 20 Passed

Description

100%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.

A strong, concise description that clearly states a comprehensive set of concrete PDF actions and pairs them with an explicit 'Use whenever...' trigger clause. It is in third person, avoids fluff, and reads as a model example.

Dimension	Reasoning	Score
Specificity	Lists many concrete actions — 'extract (text/tables)', 'create', 'merge/split/rotate', 'watermark', 'encrypt', 'fill', and 'render-to-image' — giving comprehensive coverage of PDF capabilities.	5 / 5
Completeness	Explicitly states both the 'what' (the enumerated PDF operations) and the 'when' ('Use whenever the user uploads a .pdf or asks to produce, edit, or pull data out of one'), matching the top anchor.	5 / 5
Trigger Term Quality	Uses natural terms users say ('PDF', '.pdf', 'forms' via 'fill', 'produce', 'edit', 'pull data out') including the file extension, matching the comprehensive-anchor example.	5 / 5
Distinctiveness Conflict Risk	Scoped tightly to .pdf files with a clear niche and explicit trigger phrasing, so minimal overlap with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: HKUDS/DeepTutor
Path: deeptutor/skills/builtin/pdf/SKILL.md
Commit: 3e82f13

Reviewed: 2 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.