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

76%

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

The canonical home for this skill is pdf-merger in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

61%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, action-oriented body whose basic workflow is fully self-contained, but it is undermined by bundle drift: three of five referenced files don't exist, and documented flags (--title/--author/--subject/--compress) are absent from the script. The batch merge operation also lacks any validation step, capping workflow clarity.

Suggestions

Create the missing referenced files (references/page-selection.md, references/advanced-merging.md) or remove those pointers and inline the essential syntax — especially page-selection syntax, which is currently available nowhere.

Add a verification step after merging (e.g. open the output or check its page count equals the sum of selected input pages) to give the batch operation a validation checkpoint.

Reconcile the Script Options block and Troubleshooting section with the actual script: either implement --title/--author/--subject/--compress and scripts/repair-pdf.py or remove them from the documentation.

DimensionReasoningScore

Conciseness

The body is lean: commands with one-line setups, a compact options block, no explanation of concepts Claude already knows. Minor trimmable padding exists — the Overview repeats the description and the "Features" checklist ("✓ Merge unlimited PDFs", "✓ Bookmark generation") restates what the use cases and Script Options already show — matching anchor 4's 'minor instances of over-explanation'.

4 / 5

Actionability

All examples are concrete, copy-paste-ready commands (e.g. "python scripts/merge-pdfs.py --input cover.pdf content.pdf appendix.pdf --output document.pdf") covering the common cases. It stops short of 5 because documented options are inconsistent with the bundle: "--title/--author/--subject" appear in the body but not in the script, "--compress" is recommended in Troubleshooting but absent from both the Script Options block and the script, and "scripts/repair-pdf.py" does not exist.

4 / 5

Workflow Clarity

The single merge command is unambiguous, but merging multiple input files is a batch operation and the body includes no validation/verification step (e.g. confirm the output opens or has the expected page count), so per the rubric's batch-operation cap workflow_clarity cannot exceed 3. The Troubleshooting cause/fix pairs show some error-recovery awareness, which keeps it at the anchor-3 'sequence present but checkpoints missing' level rather than 2.

3 / 5

Progressive Disclosure

Scored against the actual bundle: of the five referenced paths, only scripts/merge-pdfs.py and references/pdf-libraries-comparison.md exist — references/page-selection.md ("See references/page-selection.md for syntax"), references/advanced-merging.md, and scripts/repair-pdf.py are missing. The sectioning pattern is right (lean overview pointing to one-level-deep references), but three dead pointers mean the promised advanced content is unreachable, a material navigation failure below the midpoint.

2 / 5

Total

13

/

20

Passed

Description

83%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 with a clear what/when structure, third-person voice, and natural trigger phrases. Its only weaknesses are the vague "customizable options" filler and a couple of trigger phrases broad enough to overlap with related skills.

DimensionReasoningScore

Specificity

"Merge multiple PDF files into single document" plus "Supports page selection, bookmarks, and metadata" lists several concrete capabilities, matching the 'lists several specific actions; minor gaps' anchor. It falls short of the 5 anchor because "with customizable options" is generic filler and coverage omits capabilities like compression that the body claims.

4 / 5

Completeness

It clearly answers "what" ("Merge multiple PDF files... Supports page selection, bookmarks, and metadata") and "when" with an explicit trigger clause ("Use when combining PDFs, creating documents from multiple sources, or organizing PDF collections") containing three concrete trigger scenarios, matching the anchor-5 example pattern. Not 4 because the 'when' clause is already explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Natural user phrases are present — "combining PDFs", "creating documents from multiple sources", "organizing PDF collections", "PDF files", "PDFs" — giving good coverage. Missing a few natural variations like the ".pdf" extension and "join/combine documents", so it sits at anchor 4 rather than the comprehensive synonym coverage of 5; well above the sparse keyword coverage of 3.

4 / 5

Distinctiveness Conflict Risk

The merging niche is distinct with dedicated triggers ("combining PDFs"), but "organizing PDF collections" and "creating documents from multiple sources" could plausibly fire for general PDF-manipulation or file-organization skills — minor overlap risk with closely related skills, matching anchor 4. It is more distinct than the broad 'works with document files' of anchor 3, but lacks the minimal-conflict precision of anchor 5.

4 / 5

Total

17

/

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

.claude/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.