Name: pdf-official
Rating: 55.2 (1 reviews)
Author: administrakt0r

pdf-official

This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see reference.md. If you need to fill out a PDF form, read forms.md and follow its instructions.

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/pdf-official/SKILL.md

The canonical home for this skill is pdf-official in administrakt0r/AI-Agents-Safe-Coding-Skills

Quality

Content

72%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 body is a strong, actionable PDF reference with executable code for the common operations, but it lacks validation checkpoints for its batch operations and its progressive-disclosure references point to non-existent files while ignoring the real scripts/ bundle. Adding verification steps and fixing/aligning the references would lift the weaker dimensions.

Suggestions

Add validation/verification after batch operations, e.g. after merge verify page count with PdfReader('merged.pdf'), and after split confirm all expected page files were written.

Fix broken references: either create reference.md and forms.md, or repoint the body to the existing scripts/ (e.g. fill_fillable_fields.py, extract_form_field_info.py) instead of forms.md.

Remove the Overview paragraph that duplicates the frontmatter description, and trim trivial inline comments like '# Save' and '# Add a line'.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean executable code without concept-explanation padding, but includes minor trimmable noise such as trivial comments ('# Save', '# Add a line') and an Overview that duplicates the frontmatter description verbatim.	4 / 5
Actionability	It provides copy-paste-ready, executable code and commands across the common cases (merge, split, extract text/tables, create PDFs, OCR, watermark, password protection) plus a Quick Reference table mapping tasks to tools, matching the fully-executable anchor.	5 / 5
Workflow Clarity	Each operation is shown as a concrete single action, but batch operations (merge over multiple files, split into per-page files, OCR over pages) include no validation or verification checkpoints, so workflow clarity is capped at 3 per the rubric's batch-operation rule.	3 / 5
Progressive Disclosure	Section structure and signaling are reasonable ('see reference.md', 'read forms.md'), but those referenced files do not exist in the bundle and the available scripts/ form-filling files are never referenced, so navigation is partially broken and real bundle content is not surfaced.	3 / 5
	Total	15 / 20 Passed

Description

53%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 identifies a clear PDF-processing niche and uses appropriate third-person voice, but it relies on generic 'operations' language rather than concrete actions and lacks an explicit 'Use when...' trigger clause, capping completeness. Add specific verbs (extract, merge, split, fill forms) and a natural trigger phrase to reach the top anchors.

Suggestions

Replace 'essential PDF processing operations' with concrete verbs: 'Extract text and tables from PDFs, merge and split documents, fill forms, create PDFs.'

Add an explicit trigger clause: 'Use when working with PDF files, .pdf attachments, forms, or document extraction.'

Include natural synonyms/extensions users say ('PDFs', '.pdf', 'merge documents') to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and the tool categories ('essential PDF processing operations using Python libraries and command-line tools') plus one concrete action ('fill out a PDF form'), but does not enumerate specific operations like extract, merge, or split, so it is not comprehensive.	3 / 5
Completeness	It states a clear 'what' (PDF processing operations) but has no 'Use when...' trigger clause; the narrow conditional 'If you need to fill out a PDF form' is not general trigger guidance, so completeness is capped at 3 per the rubric guideline.	3 / 5
Trigger Term Quality	It includes 'PDF' and 'PDF form' but omits common natural variations users say such as 'PDFs', '.pdf', 'merge documents', or 'document extraction', matching the 'some relevant keywords but missing synonyms' anchor.	3 / 5
Distinctiveness Conflict Risk	The scope is PDF-specific ('PDF processing operations', 'PDF form'), giving it a clear niche with minimal conflict risk, though the thin trigger phrases keep it just below the fully-distinct anchor 5.	4 / 5
	Total	13 / 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: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills-claude/skills/pdf-official/SKILL.md
Commit: 57c135b

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