CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pdf-merger

Merge multiple PDF files into single document with customizable options. Supports page selection, bookmarks, and metadata. Use when combining PDFs, creating documents from multiple sources, or organizing PDF collections.

Quality

79%

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 ./skills/skill-builder-generic/examples/pdf-merger-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 well-organized, token-efficient body with concrete executable commands for the main merge flows. The main defects are a batch operation with no validation checkpoint, and a reference layer that is mostly broken — two of three referenced files, plus the repair script and --compress flag, do not exist in the bundle.

Suggestions

Add a post-merge verification step (e.g., open the output or check its page count against the inputs) — batch operations without a validation checkpoint cap workflow clarity at 3.

Fix the reference layer: either add references/advanced-merging.md and references/page-selection.md to the bundle or remove those links, since only references/pdf-libraries-comparison.md currently exists.

Reconcile Troubleshooting with the actual script: remove the --compress flag and scripts/repair-pdf.py references (or implement them), as neither exists in the bundle or the documented options.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no explanations of concepts Claude already knows (no "what is a PDF" padding), matching the efficient anchor with minor trims possible. It is not a 5 because the Overview near-duplicates the frontmatter description and the "Features" checklist ("✓ Bookmark generation", "✓ Metadata customization") restates what "Script Options" already documents.

4 / 5

Actionability

Concrete, copy-paste-ready commands cover the common cases (basic merge, selective merge with page syntax, bookmarks, metadata), matching the mostly-executable anchor. It misses score 5 because "Use `--compress` flag" and "`python scripts/repair-pdf.py input.pdf`" reference a flag and a script that do not exist in the bundle, so those instructions are not executable as written.

4 / 5

Workflow Clarity

Merging multiple input files is a batch operation, and the body contains no validation or verification step (e.g., confirm the output opens or the page count is as expected) — only reactive troubleshooting after failure. Per the batch-operation rule this caps workflow clarity at 3 even though the single-purpose commands themselves are unambiguous.

3 / 5

Progressive Disclosure

Scoring against the actual bundle: of the referenced paths, only "references/pdf-libraries-comparison.md" exists; "references/advanced-merging.md", "references/page-selection.md", and "scripts/repair-pdf.py" are broken links that dead-end navigation. Section structure and one-level-deep signaling are good, but the majority of referenced files being missing drops this below the 'minor organization gaps' anchor.

3 / 5

Total

14

/

20

Passed

Description

87%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 description that clearly states both capabilities and explicit usage triggers in third person, with good natural-language keywords. The only weaknesses are the vague filler phrase "with customizable options" and the absence of the ".pdf" extension keyword.

DimensionReasoningScore

Specificity

"Merge multiple PDF files into single document" plus "Supports page selection, bookmarks, and metadata" lists several concrete capabilities, matching the anchor for several specific actions with minor gaps. It falls short of the comprehensive anchor because "with customizable options" is generic filler that adds no concrete action, unlike the score-5 example's fully enumerated capability list.

4 / 5

Completeness

Explicitly answers what ("Merge multiple PDF files into single document... Supports page selection, bookmarks, and metadata") and when ("Use when combining PDFs, creating documents from multiple sources, or organizing PDF collections") with concrete trigger phrases, matching the top anchor's structure exactly.

5 / 5

Trigger Term Quality

Includes natural terms users would say — "PDF files", "combining PDFs", "organizing PDF collections", "bookmarks" — giving good keyword coverage with synonyms (merge/combining). Not score 5 because the ".pdf" file extension and common phrasings like "join PDFs" are missing, whereas the top anchor explicitly includes extensions.

4 / 5

Distinctiveness Conflict Risk

A clear niche (PDF merging) with distinct triggers ("combining PDFs", "organizing PDF collections") that would not fire for extraction, form-filling, or non-PDF document skills. The trigger terms are all PDF-specific, matching the clear-niche anchor with minimal conflict risk.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 4 missing

Warning

Total

14

/

16

Passed

Repository

fernandezbaptiste/Skrillz

Path

skills/skill-builder-generic/examples/pdf-merger-skill/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.