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

Securityby

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

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.

The body is concise and highly actionable with copy-paste commands for common cases, but it is held back by a missing validation checkpoint for a batch operation and by three broken reference links pointing to files absent from the bundle.

Suggestions

Add a verification step after merging (e.g., confirm the output PDF opens and reports the expected page count) so the batch workflow has an explicit validation checkpoint.

Create the missing referenced files (references/advanced-merging.md, references/page-selection.md, scripts/repair-pdf.py) or remove the links to them so all signaled references resolve to real bundle files.

Trim the footer metadata (Version, Last Updated, Example Type) and the redundant checkmark feature list to tighten token efficiency, or move version info to a dedicated section.

Dimension	Reasoning	Score
Conciseness	The body is lean and action-oriented — no conceptual padding about what PDFs are — with short command blocks and a compact feature list; minor trimming opportunities remain in the redundant checkmark feature list and the version/last-updated/Example-Type footer metadata, which is why it is not a 5.	4 / 5
Actionability	Provides concrete, copy-paste-ready bash commands across Quick Start and multiple use cases covering the common cases (basic, selective, page ranges, metadata, bookmarks); not a 5 because the page-selection syntax points to a non-existent references/page-selection.md and the bundled merge-pdfs.py is only a stub that does not actually parse or merge.	4 / 5
Workflow Clarity	The merge operation is a single clear command, but merging multiple inputs is a batch operation with no validation or verification step (e.g., confirm all inputs were processed, verify output opens) and no error-recovery feedback loop, so per the rubric's batch-operation cap workflow clarity cannot exceed 3.	3 / 5
Progressive Disclosure	Section structure is good (Overview, Quick Start, Use Cases, Script Options, Advanced, Troubleshooting) and references are clearly signaled with markdown links, but 3 of the 4 referenced paths do not exist in the bundle (references/advanced-merging.md, references/page-selection.md, scripts/repair-pdf.py), so navigation breaks and it lands at 3 rather than 4.	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 what the skill does and when to use it, with concrete capabilities and natural trigger phrases in third-person voice. The main gap is slightly limited keyword variety rather than any structural weakness.

Dimension	Reasoning	Score
Specificity	Names the PDF domain and several concrete actions — 'Merge multiple PDF files', 'page selection, bookmarks, and metadata' — matching the score-4 anchor of several specific actions with minor coverage gaps; not a 5 because coverage is merge-centric rather than comprehensive across many distinct operations.	4 / 5
Completeness	Explicitly answers both what ('Merge multiple PDF files into single document with customizable options. 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 score-5 anchor.	5 / 5
Trigger Term Quality	Includes natural phrases users would say — 'combining PDFs', 'creating documents from multiple sources', 'organizing PDF collections', plus 'PDF files'/'PDFs' — giving good keyword coverage; not a 5 because it omits the .pdf extension and common synonyms like 'join'.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (PDF merging) with distinct, specific triggers that are unlikely to fire for unrelated skills, matching the score-5 anchor of a clear niche with minimal conflict risk.	5 / 5
	Total	18 / 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
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
Commit: 93ed392

Reviewed: 1 day 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.