CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pdf-sign

This skill should be used when the user asks to "sign this PDF", "fill in this form", "add my signature to", or mentions signing letters, claim forms, or contracts. Overlays a signature image, ticks checkboxes, and fills date/name/phone fields on scanned or digital PDFs using pymupdf, with OCR fallback for scanned documents.

75

Quality

94%

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

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

Excellent operational content: executable code, a verification-driven workflow with feedback loop, and dense gotchas covering real failure modes. The only structural note is that all content is inlined in a ~90-line body with no reference files, which is acceptable but just beyond the lean single-file ideal.

DimensionReasoningScore

Conciseness

The body is lean and dense — no explanation of what a PDF is or how pymupdf works; every section (image transparency, setup, approach, recipe, gotchas) carries operational value Claude doesn't already have. It matches anchor 5 ("every token earns its place"); there are no padded sections to trim for a 4.

5 / 5

Actionability

Fully executable guidance throughout: venv/pip/brew commands, the transparent-PNG conversion snippet, a copy-paste-ready pymupdf recipe covering the common cases (signature image placement, date text field, checkbox X, OCR textpage fallback), and the render-to-PNG verification command. This matches anchor 5; it exceeds anchor 4 because the code is complete and covers the standard cases, not just mostly executable.

5 / 5

Workflow Clarity

The 5-step workflow has an explicit validation checkpoint and feedback loop ("Render pages → view the PNGs → verify placement", "Iterate until correct"), reinforced by "Always render and visually verify each modified page" in the Approach section and the gotchas table for error recovery. It is non-destructive ("never overwrite the source"), matching anchor 5's explicit validation and feedback-loop requirement.

5 / 5

Progressive Disclosure

Sections are clearly organized with headers and a gotchas table, and no bundle files exist — everything lives inline, which is appropriate for a single-purpose skill. However, at ~90 lines of inline recipe + gotchas it exceeds the under-50-line simple-skill case that anchor 5 and the scoring note reserve for a 5, and the gotchas/recipe detail could plausibly live in a reference file; anchor 4 ("good structure, most content appropriately placed, minor organization gaps") is the best fit.

4 / 5

Total

19

/

20

Passed

Description

88%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 explicitly pairs concrete capabilities (signature overlay, checkbox ticks, field filling, OCR fallback, pymupdf) with natural quoted trigger phrases. Its only weakness is minor: a few common synonyms/extensions are absent, and "fill in this form" has slight overlap with generic PDF form-handling skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Overlays a signature image, ticks checkboxes, and fills date/name/phone fields on scanned or digital PDFs using pymupdf, with OCR fallback" — comprehensively covering the PDF signing/filling domain. It matches the anchor for comprehensive coverage of specific concrete actions; there are no meaningful gaps in the action list.

5 / 5

Completeness

Both questions are explicitly answered: "This skill should be used when the user asks to..." gives a fully explicit 'when' clause with concrete trigger phrases, and the second sentence gives a clear, specific 'what'. This matches anchor 5 directly; it is not anchor 4 because the 'when' is not merely present but specific and phrase-quoted.

5 / 5

Trigger Term Quality

Natural quoted trigger phrases ("sign this PDF", "fill in this form", "add my signature to") plus signing letters, claim forms, contracts, and PDFs give good-to-excellent coverage. It falls just below anchor 5 because a few natural terms and variations are missing (e.g. "e-sign", "initial", "autograph", the ".pdf" extension), which anchor 4 ("a few natural terms missing") describes better than anchor 5.

4 / 5

Distinctiveness Conflict Risk

PDF signing is a clear niche with distinct triggers (signature overlay, tick checkboxes), but "fill in this form" could also fire a general PDF form-filling/extraction skill, giving minor overlap risk with a closely related skill. This sits between anchor 4 ("minor overlap risk with closely related skills") and anchor 5 — the niche is distinct but not fully conflict-free, so 4 is the best fit.

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

dwmkerr/claude-toolkit

Path

plugins/dwmkerr/skills/pdf-sign/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.