CtrlK
BlogDocsLog inGet started
Tessl Logo

nano-pdf

Edit text in existing PDFs via natural-language prompts.

61

Quality

73%

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 ./skills/productivity/nano-pdf/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

93%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 content is exemplary for a simple single-purpose skill: lean, fully executable, well-organized, and including a verification note for an inherently destructive operation. The only gap is that verification is advisory rather than an explicit workflow checkpoint.

DimensionReasoningScore

Conciseness

The body is lean: a one-line intro, install commands, a usage signature, three examples, and operational notes — no padding explaining what a PDF is or how libraries work, and nearly every token earns its place.

5 / 5

Actionability

It provides copy-paste-ready commands (`uv pip install nano-pdf`, the `nano-pdf edit <file.pdf> <page_number> "<instruction>"` signature) and three concrete examples covering common cases (title, date, client name).

5 / 5

Workflow Clarity

The single action is unambiguous and a verification checkpoint exists ("Always verify the output PDF after editing ... use read_file to check file size"), plus retry guidance (±1 page); it is not a 5 because verification is advisory rather than an explicit step and there is no structured validate-fix-retry loop.

4 / 5

Progressive Disclosure

Under 50 lines with no need for external references and four well-organized sections (Prerequisites, Usage, Examples, Notes), satisfying the simple-skill exception for a top score.

5 / 5

Total

19

/

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 clearly states what the skill does but lacks any explicit "when to use it" guidance and only sparse natural-language trigger terms, capping both completeness and trigger-term quality. It is specific enough to be distinct from sibling PDF skills.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user wants to change, update, or fix text inside an existing PDF without re-creating it."

Expand trigger terms with user-natural synonyms and the file extension: "edit text in PDFs, change or fix wording in a PDF, .pdf files".

Optionally note what it does NOT do (merge/split/forms) to further reduce overlap with the pdf skill.

DimensionReasoningScore

Specificity

"Edit text in existing PDFs via natural-language prompts" names the PDF domain and one concrete action (editing text) plus the mechanism, but does not enumerate several actions as required for a 4.

3 / 5

Completeness

The "what" is clear (edit text in existing PDFs via NL prompts) but there is no "Use when..." or equivalent trigger clause, which per the rubric caps completeness at 3.

3 / 5

Trigger Term Quality

It includes "PDFs" and "Edit text" but omits common natural variations users would say ("change", "update", "fix") and the .pdf extension; "natural-language prompts" is a feature term, not a user trigger.

3 / 5

Distinctiveness Conflict Risk

"Edit text in existing PDFs" carves a narrow niche distinct from extraction/structural PDF skills, with only minor overlap risk against the closely related pdf skill.

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.

Validation13 / 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
NousResearch/hermes-agent
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.