CtrlK
BlogDocsLog inGet started
Tessl Logo

nano-pdf

Edit PDFs with natural-language instructions using the nano-pdf CLI.

63

2.61x
Quality

52%

Does it follow best practices?

Impact

81%

2.61x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/nano-pdf/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a concise, well-structured skill that efficiently communicates the core usage of nano-pdf. Its main weakness is the lack of concrete validation/verification steps for the output PDF and limited actionability beyond the single example. The page-numbering ambiguity note is helpful but could be more prescriptive.

Suggestions

Add a concrete verification step, e.g., 'Open the output PDF and confirm the edit on the target page' or provide a command to inspect the result programmatically.

Include a second example showing a different type of edit (e.g., adding text, removing an element) to broaden actionability.

DimensionReasoningScore

Conciseness

Very lean and efficient. Every line serves a purpose—no explanation of what PDFs are or how CLI tools work. The notes are practical and non-obvious (0-based vs 1-based page numbering gotcha).

3 / 3

Actionability

The example command is concrete and copy-paste ready, but there's only one example and no guidance on installation, error handling, or what happens with more complex edits. The 'sanity-check the output' note is vague—how should Claude verify the output?

2 / 3

Workflow Clarity

For a simple single-command skill this is mostly adequate, but the 'sanity-check the output' step lacks specifics on how to validate, and the page-number ambiguity note suggests a retry loop without explicit steps. A destructive file operation (editing a PDF) should have clearer validation guidance.

2 / 3

Progressive Disclosure

For a simple, single-purpose skill under 50 lines with no bundle files, the content is appropriately concise and well-organized with a quick start section and notes. No need for external references.

3 / 3

Total

10

/

12

Passed

Description

32%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and identifies the core domain (PDF editing) and tool (nano-pdf CLI), but it lacks specificity about what kinds of edits are supported and completely omits a 'Use when...' clause. Without explicit trigger guidance and more concrete action descriptions, Claude would struggle to reliably select this skill from a large pool.

Suggestions

Add a 'Use when...' clause specifying trigger scenarios, e.g., 'Use when the user asks to edit, modify, annotate, or update PDF files.'

List specific concrete actions the skill supports, e.g., 'Add text, remove pages, merge documents, annotate, fill forms in PDF files.'

Include natural keyword variations users might say, such as '.pdf', 'modify PDF', 'change PDF content', 'PDF pages'.

DimensionReasoningScore

Specificity

Names the domain (PDFs) and a general action (edit), and mentions the specific tool (nano-pdf CLI), but does not list multiple concrete actions like extracting text, filling forms, merging, etc.

2 / 3

Completeness

Describes what it does (edit PDFs) but has no explicit 'Use when...' clause or equivalent trigger guidance, which per the rubric should cap completeness at 2, and the 'what' is also quite thin, bringing this to a 1.

1 / 3

Trigger Term Quality

Includes 'PDFs' and 'edit' which are natural terms, but misses common variations like '.pdf files', 'modify PDF', 'update PDF', 'PDF editing', or specific operations users might request.

2 / 3

Distinctiveness Conflict Risk

The mention of 'nano-pdf CLI' adds some distinctiveness and the focus on editing PDFs is reasonably specific, but 'edit PDFs' could overlap with other PDF-related skills that also handle modification tasks.

2 / 3

Total

7

/

12

Passed

Validation

72%

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

Validation8 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

8

/

11

Passed

Repository
deepgram/dglabs-deepclaw
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.