CtrlK
BlogDocsLog inGet started
Tessl Logo

nano-pdf

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

79

2.61x
Quality

76%

Does it follow best practices?

Impact

81%

2.61x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./openclaw/skills/nano-pdf/SKILL.md

The canonical home for this skill is nano-pdf in Hung-Reo/hungreo-openclaw

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 a model of a lean, simple skill: one executable command with a realistic example, plus two operational notes that provide both error recovery (page-numbering retry) and output validation (sanity-check before sharing). No bundle files exist and none are needed; nothing is missing for the skill's single purpose.

DimensionReasoningScore

Conciseness

The body is 12 lines with zero padding: one sentence of purpose ('Use `nano-pdf` to apply edits to a specific page in a PDF'), one executable command, and two high-value operational notes. It assumes Claude's competence and never explains concepts Claude already knows, matching 'lean and efficient; every token earns its place'. There is nothing to trim, so it cannot be 4 ('minor instances of over-explanation').

5 / 5

Actionability

The Quick start gives a fully executable, copy-paste-ready command with a realistic concrete example ('nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results'..."'), and the notes supply the exact operational details (page-numbering ambiguity and its remedy) needed to run it successfully. This matches anchor 5 ('fully executable; copy-paste ready commands; specific examples cover the common cases') rather than 4, which allows 'minor gaps'.

5 / 5

Workflow Clarity

This is a simple single-purpose skill where the single action is unambiguous, satisfying the simple-skill exception; moreover it goes further than required by including an explicit feedback loop ('if the result looks off by one, retry with the other') and a validation checkpoint ('Always sanity-check the output PDF before sending it out'). This matches anchor 5's 'explicit validation steps; feedback loops for error recovery' — without the validation note it would have been capped at 3 as a document-manipulation skill.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references, and no bundle files exist (references/, scripts/, assets/ are absent, and the body references none). Per the guideline, 'for skills under 50 lines with no need for external references, progressive disclosure can score 5 with just well-organized sections' — the body has a clear title, a one-line purpose statement, and a well-labeled Quick start section, so nothing is inlined that belongs in a separate file.

5 / 5

Total

20

/

20

Passed

Description

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

The description is concise and clearly states what the skill does, with a reasonably distinct niche. Its main weaknesses are the complete absence of any 'Use when' trigger guidance and thin natural-keyword coverage (no 'PDF files', '.pdf', or edit-task synonyms), leaving a user to guess when to invoke it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants to modify, retitle, or fix text in a PDF with a natural-language instruction.'

Broaden natural keyword coverage with synonyms and file extensions, e.g. mention 'PDF files', '.pdf', 'update/change PDF text'.

Optionally name the concrete edit capabilities supported (text changes, titles, typo fixes) to strengthen specificity.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "Edit PDFs with natural-language instructions using the nano-pdf CLI" — which matches the '1-2 concrete actions, but not comprehensive' anchor. It is more specific than anchor 2 ('Processes PDF files') because it specifies the mechanism (natural-language instructions via a CLI), but it does not list several actions or coverage (no mention of what kinds of edits are supported), so it is not anchor 4.

3 / 5

Completeness

The 'what' is clear ('Edit PDFs with natural-language instructions using the nano-pdf CLI') but there is no 'Use when...' clause or equivalent explicit trigger guidance, which the guidelines state caps completeness at 3. It is not anchor 4 because 'when' is entirely absent rather than present-but-vague, and not anchor 2 because the 'what' is concrete, not vague.

3 / 5

Trigger Term Quality

Natural terms present are 'Edit PDFs' and 'natural-language instructions', but common variations and synonyms are missing: no 'PDF files', '.pdf', 'modify', or task phrases like 'change text in a PDF'. This matches anchor 3 ('Some relevant keywords but missing common variations or synonyms'); it falls short of anchor 4's 'good keyword coverage' exemplified by multiple terms like 'PDF files, forms, document extraction'.

3 / 5

Distinctiveness Conflict Risk

The description carves a fairly distinct niche (natural-language PDF editing via a specific CLI), so it is 'mostly distinct; minor overlap risk' with other PDF/document skills (e.g., a general PDF-reading or document-editing skill could also match 'edit PDFs'). It is not anchor 5 because it lacks the explicit trigger phrases that would fully separate it from similar skills, and not anchor 3 because it is more specific than 'Works with document files'.

4 / 5

Total

13

/

20

Passed

Validation

81%

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

Validation — 13 / 16 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

13

/

16

Passed

Repository
trpc-group/trpc-agent-go
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.