pdf

Read, create, merge, split, fill, watermark, stamp, secure, inspect, render, and visually verify PDF files, including AcroForm workflows.

Quality

87%

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

100%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 an efficient, well-structured overview: executable commands, a clear validated workflow, and one-level-deep references to a real forms.md and bundled scripts.

Dimension	Reasoning	Score
Conciseness	The body is lean and operational throughout — dependency install commands, a helper catalog, and executable invocations — with no teaching of concepts Claude already knows, matching the 5-anchor's 'every token earns its place'.	5 / 5
Actionability	It provides copy-paste-ready executable commands for common cases (pdf_read --json, pdf_page_image -o rendered --pages 1-3, pdf_merge, pdf_split) plus --help guidance, matching the fully-executable 5-anchor.	5 / 5
Workflow Clarity	The five-step Workflow includes explicit validation checkpoints — 'Re-read the output to verify' (step 3) and 'Render every changed page ... and inspect' (step 4) — plus reporting limitations, satisfying the validation-required cap and matching the 5-anchor.	5 / 5
Progressive Disclosure	The body is a concise overview that signals a one-level-deep reference ('read references/forms.md through skill_view') and lists bundled scripts, with the referenced file verified to exist; this matches the 5-anchor's clear, well-signaled navigation.	5 / 5
	Total	20 / 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 highly specific and clearly niched, but it omits any explicit 'when to use' trigger clause, which limits its completeness and leaves some natural trigger terms uncovered.

Suggestions

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

Add natural synonyms and the file extension (e.g. 'PDFs', '.pdf', 'forms') to broaden trigger-term coverage.

Dimension	Reasoning	Score
Specificity	The description enumerates over a dozen concrete actions ('Read, create, merge, split, fill, watermark, stamp, secure, inspect, render, and visually verify'), matching the comprehensive-coverage anchor rather than the 4-anchor's 'minor gaps'.	5 / 5
Completeness	It gives a clear, comprehensive 'what' but contains no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	It includes natural terms 'PDF files' and 'AcroForm workflows', but lacks common synonyms and extensions a user would say ('PDFs', '.pdf', generic 'forms'), so it falls below the comprehensive 5-anchor.	4 / 5
Distinctiveness Conflict Risk	The PDF/AcroForm scope is a clear niche with distinct triggers and minimal overlap with other skills, matching the 5-anchor; it is more decisive than the 4-anchor's 'minor overlap risk'.	5 / 5
	Total	17 / 20 Passed

Validation

87%

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

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
metadata_field	'metadata' should map string keys to string values	Warning

	Total	14 / 16 Passed

Repository: EKKOLearnAI/hermes-studio
Path: packages/ekko-agent/skills/pdf/SKILL.md
Commit: 07ccb17

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