CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

nanobot-document

Answer nanobot usage, configuration, and troubleshooting questions from its bundled documentation.

62

Quality

78%

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 ./nanobot/skills/nanobot-document/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

92%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 lean, highly actionable routing index with clear decision rules and fallbacks — near-perfect on conciseness, actionability, and workflow clarity. Its one material weakness is progressive disclosure: the entire skill is built around a reference bundle that is not present, breaking the navigation structure it exists to provide.

Suggestions

Ship or verify the references/ directory (quick-start.md, webui.md, provider-cookbook.md, providers.md, configuration.md, guides/README.md, troubleshooting.md, README.md) alongside SKILL.md so the topic table's links resolve.

Add a minimal inline quick-start snippet (or a note on what to do when references/ is missing) so the skill degrades gracefully when the bundle is absent.

DimensionReasoningScore

Conciseness

The ~24-line body is lean and every sentence carries non-obvious, nanobot-specific guidance ("Prefer documented WebUI steps when the setting has a graphical control", "Configuration examples are partial snippets to merge", "Links leaving `references/` refer to repository files that may not be bundled"). Nothing explains concepts Claude already knows and there is no padding, matching the score-5 anchor.

5 / 5

Actionability

As an instruction-only skill, its guidance is concrete and directly followable: a topic-to-entry-point table routing each question type to an exact file, an explicit load rule ("Load only the material needed"), a WebUI-vs-config decision rule with its exception, snippet-merge semantics, and a concrete fallback URL with an explicit version-mismatch instruction. Per the scoring notes, absence of code is not penalized when the guidance is this actionable, matching the score-5 anchor adapted to instruction skills.

5 / 5

Workflow Clarity

This is a simple, single-purpose skill and its single action — route the question to the right reference file and answer from it — is unambiguous, with explicit fallbacks (documentation index for "Other topics", published docs for missing bundled material). No destructive or batch operations are involved, so no validation cap applies; per the scoring note for simple skills this fits the score-5 anchor.

5 / 5

Progressive Disclosure

The one-level-deep topic table with clearly signaled references is structurally a 5, but none of the eight referenced files (references/quick-start.md, webui.md, provider-cookbook.md, providers.md, configuration.md, guides/README.md, troubleshooting.md, README.md) exist in the skill's bundle — the ./references/ directory is entirely absent — so the navigation targets cannot be verified and every link breaks at runtime in this layout. Scored at the midpoint: better than buried or inlined references (anchor 2), but not the verifiable, navigable split of anchor 4/5.

3 / 5

Total

18

/

20

Passed

Description

57%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 and is anchored to a distinct, named tool, so it will not trigger for the wrong skill. However, it lacks any explicit 'use when' trigger clause and misses the natural phrasings users would most likely say, leaving it at the midpoint of the rubric.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks about nanobot setup, configuration, WebUI, providers, or errors."

Include natural synonyms users would say — "set up", "install", "config", "error" — instead of only the formal "usage, configuration, troubleshooting".

Name a key concrete capability or two (e.g. WebUI setup, provider/model configuration) to sharpen both specificity and trigger coverage.

DimensionReasoningScore

Specificity

"Answer nanobot usage, configuration, and troubleshooting questions from its bundled documentation" names the domain and scopes it with three concrete topic areas, but the only action verb is the generic "answer ... questions". It matches the score-3 anchor (domain plus 1-2 concrete actions, not comprehensive) better than score 2, which would require a bare action with no topic enumeration, and less than score 4, which needs several distinct specific actions.

3 / 5

Completeness

The "what" is clear (answer usage/configuration/troubleshooting questions from bundled documentation), but there is no "Use when..." clause or equivalent explicit trigger guidance; the "when" is only weakly implied by the domain. Per the judging guideline, a missing 'Use when' clause caps completeness at 3, and the score-3 anchor (clear what, when missing or weakly implied) is the best fit.

3 / 5

Trigger Term Quality

"nanobot", "usage", "configuration", and "troubleshooting" are terms a user would plausibly say, but common variations and synonyms are missing: "set up"/"install", "config", "errors"/"help", "WebUI", "providers". This matches the score-3 anchor (relevant keywords but missing common variations) rather than score 4's good-but-not-full coverage.

3 / 5

Distinctiveness Conflict Risk

"nanobot" is a unique, named tool, giving the description a clear niche with a distinct trigger term and minimal conflict risk with other skills. It fits the score-5 anchor better than score 4, whose example ("Works with PDF and Word document files") still overlaps adjacent skills.

5 / 5

Total

14

/

20

Passed

Validation

87%

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

CriteriaDescriptionResult

relative_links

Relative link issues: 8 missing, 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 8 missing, 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository

HKUDS/nanobot

Path

nanobot/skills/nanobot-document/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.