CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pdf-processing

Extract text from PDFs, fill forms, and merge documents

Quality

61%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./examples/skills/sample_skills/pdf-processing/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

36%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 admirably lean and well-sectioned but contains almost no executable guidance: no libraries, code, or concrete commands, and the sole pointer to detailed documentation (reference.md) is a dead link with no bundle files present. It reads as a capability brochure rather than an instructive skill.

Suggestions

Add concrete, executable examples naming specific tools (e.g., a pdfplumber or pypdf snippet for extraction and a merge command) to fix the actionability score of 1.

Replace the vague Usage one-liners with sequenced steps including validation (e.g., verify output opens and page counts match) for the file-writing merge/split operations.

Fix or remove the dangling reference.md link — either ship the referenced file in a references/ directory or inline the essential API details.

DimensionReasoningScore

Conciseness

The body is short, assumes Claude's competence, and explains nothing Claude already knows (no "what a PDF is" padding), close to the lean score-5 anchor. One minor instance of trimmable framing remains — "This skill helps you work with PDF documents" and "use the appropriate tools" add little beyond the frontmatter — matching the score-4 anchor of minor over-explanation that could be trimmed.

4 / 5

Actionability

The Usage section gives only abstract directions — "Read the PDF and parse its content", "Identify form fields and fill them programmatically", "Combine multiple documents in the desired order" — with no library names, code, or commands, matching the score-1 anchor ("Use a PDF library to extract the text content from the document and process it as needed"). It is not a 2 because even high-level tool hints are absent, and the only detailed material is a link to reference.md, which does not exist in the bundle.

1 / 5

Workflow Clarity

The numbered Usage list is a task-dispatch overview, not a sequenced workflow — each entry is a vague one-liner ("parse its content") with no validation or checkpoints for file-writing operations like merging and splitting, matching the score-2 anchor ("1. Open the document 2. Make changes 3. Save and close"). Not a 3 because the steps themselves are contentless rather than merely lacking validation.

2 / 5

Progressive Disclosure

Sections are well-labeled and the single reference ("See [reference.md](reference.md) for detailed API documentation") is clearly signaled and one level deep, but no references/, scripts/, or assets/ bundle exists, so reference.md is a dangling link — the promised detail layer is absent, leaving structure that only partly works. This sits between the score-2 anchor (references effectively unusable) and score-4 anchor (references mostly clear with only minor gaps), so 3 is the best fit.

3 / 5

Total

10

/

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.

A strong, concise capability statement with concrete third-person actions and a clear PDF niche. Its main deficiency is the missing "Use when..." trigger clause, which caps completeness at 3 and slightly weakens trigger-term coverage.

Suggestions

Append an explicit trigger clause such as "Use when working with PDF files or when the user mentions PDFs, forms, or document extraction" to raise completeness from 3.

Mention the split capability ("split PDFs into pages") so the description matches the body's advertised capabilities and improves coverage.

Add natural keyword variants like "PDF files" or ".pdf" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Extract text from PDFs, fill forms, and merge documents" lists three concrete, specific actions in third person, matching the score-4 anchor ("Extracts text from PDF files, fills forms, converts pages to images"). Not a 5 because coverage has gaps: the splitting capability advertised in the body is omitted and table extraction is absent, so it falls short of the comprehensive multi-action anchor.

4 / 5

Completeness

The description answers "what" clearly ("Extract text from PDFs, fill forms, and merge documents") but contains no "Use when..." clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3. It exactly matches the score-3 anchor example and is not a 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Natural terms present include "PDFs", "forms", "extract text", and "merge documents", giving good keyword coverage comparable to the score-4 example ("PDF files, forms, document extraction"). Not a 5 because common variations and extensions like "PDF files", ".pdf", or "document extraction" are missing; clearly above score 3 since multiple user-natural phrases appear rather than just the domain.

4 / 5

Distinctiveness Conflict Risk

The scope is a clear PDF-specific niche with concrete operations ("fill forms", "merge documents"), mirroring the score-5 anchor's action list, so conflict with non-PDF skills is minimal. Not below 5 because unlike the score-4 example ("Works with PDF and Word document files"), there is no overlap with adjacent document formats.

5 / 5

Total

16

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

PrefectHQ/fastmcp

Path

examples/skills/sample_skills/pdf-processing/SKILL.md

Reviewed

Table of Contents

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.