pdf

PDF manipulation toolkit. Extract text/tables, create PDFs, merge/split, fill forms, for programmatic document processing and analysis.

Quality

63%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./bundled/skills/document-skills/pdf/SKILL.md

Quality

Content

57%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 a well-stocked, mostly executable PDF reference, but it is dragged down by an off-scope scientific-schematics section, broken references to missing files, and absent validation checkpoints for destructive/batch operations.

Suggestions

Remove or relocate the 'Visual Enhancement with Scientific Schematics' section and its non-existent generate_schematic.py command; it is off-scope padding for a PDF manipulation skill.

Add validation/verification checkpoints to destructive and batch workflows (e.g. verify merged page count, confirm encryption by reopening with the password, validate filled form fields).

Either provide reference.md and forms.md as real bundle files or remove the dangling 'see forms.md'/'consult reference.md' pointers so one-level-deep navigation is intact.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient code with little prose, but the ~30-line 'Visual Enhancement with Scientific Schematics' section is off-scope padding referencing a non-existent script, matching the score-3 anchor of 'mostly efficient but includes some unnecessary explanation'.	3 / 5
Actionability	Extensive copy-paste-ready code across pypdf, pdfplumber, reportlab, CLI tools, OCR, watermark and encryption covers common cases, matching score-4; the broken generate_schematic.py reference prevents a clean 5.	4 / 5
Workflow Clarity	Destructive/batch operations (merge, split, encrypt, overwrite, form filling) appear with no validation or verification checkpoints, so per the feedback-loop cap workflow_clarity cannot exceed 3 despite clear per-task organization.	3 / 5
Progressive Disclosure	Sectioning and a quick-reference table give reasonable structure, but referenced files reference.md and forms.md do not exist in the bundle and the unrelated scientific-schematics content is inlined, fitting the score-3 anchor of 'some structure but references not clearly signaled'.	3 / 5
	Total	13 / 20 Passed

Description

70%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 specific and clearly PDF-niched, but it lacks an explicit 'Use when...' trigger clause, capping completeness at 3. Adding concrete trigger phrases and common synonyms/file extensions would raise the score.

Suggestions

Add an explicit trigger clause, e.g. 'Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.'

Include natural synonyms and the file extension, e.g. 'PDF files, PDFs, .pdf', to broaden trigger term coverage.

Mention OCR/scanned-PDF and image extraction to move specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Quotes 'Extract text/tables, create PDFs, merge/split, fill forms' — several specific concrete actions matching the score-4 anchor; just short of 5 because OCR/image conversion is absent.	4 / 5
Completeness	Clear 'what' is present but there is no 'Use when...' trigger clause; the closing 'for programmatic document processing and analysis' is a weak purpose statement, so per the missing-trigger cap completeness stays at 3.	3 / 5
Trigger Term Quality	Contains 'PDF', 'text/tables', 'forms', 'merge/split' but omits natural synonyms 'PDFs', 'PDF files', '.pdf', 'document extraction', so it matches the score-4 anchor rather than comprehensive score-5.	4 / 5
Distinctiveness Conflict Risk	'PDF manipulation toolkit ... fill forms, merge/split' carves a clear PDF-specific niche with distinct triggers and minimal overlap risk, matching the score-5 anchor.	5 / 5
	Total	16 / 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
referenced_paths_exist	Referenced path issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: foryourhealth111-pixel/Vibe-Skills
Path: bundled/skills/document-skills/pdf/SKILL.md
Commit: d5ae560

Reviewed: 1 day 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.