CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-setup

Set up or reconfigure nanobot's upgrade skill.

60

Quality

76%

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/update-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

88%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 an exemplary procedural skill: fully executable commands, verbatim user-facing questions, decision tables for each install method, and a complete output template, all gated by explicit validation checkpoints and stop conditions. Only minor duplication of stop instructions and a marginally long inline template keep it from top marks on conciseness and progressive disclosure.

DimensionReasoningScore

Conciseness

The body is lean and directive — exact shell commands, verbatim questions, and compact tables — assuming Claude's competence with no conceptual padding. The only trimmable material is the twice-stated "If you cannot get a clear answer, stop" instruction and the duplicated wait-for-reply phrasing in Step 3, which keeps it just below anchor 5.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: best-effort clue commands with `|| true` guards, verbatim question strings, install-method-to-command and method-to-preflight tables, and a complete generated-skill template whose placeholders (EXTRAS, PREFLIGHT_CHECK, UPGRADE_COMMAND) are explicitly constructed in prior steps. Even quoting rules for paths with spaces and extras formatting are specified, leaving no gaps that would drop it to anchor 4.

5 / 5

Workflow Clarity

Five clearly sequenced steps with explicit validation checkpoints: check whether the target file exists plus user confirmation before overwriting, a CRITICAL gate blocking the write until the install method is user-confirmed, stop conditions for "not sure" and unclear answers, and confirmation only after write_file succeeds. Error-recovery paths cover rejected writes, failed clue commands, and preflight failure in the generated skill, satisfying anchor 5 rather than anchor 4.

5 / 5

Progressive Disclosure

A single well-organized file with clear per-step section headers, where every element (commands, questions, template) is needed on each run and no bundle files exist to reference. At roughly 130 lines with the full generated-skill template inlined, it is denser than a typical overview — the template could arguably live in a reference file — placing it at anchor 4 rather than 5, while its clean, unburied structure keeps it above anchor 3.

4 / 5

Total

18

/

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 states a clear, specific "what", but it omits any "when to use this" guidance and natural trigger phrases, so completeness and trigger quality are capped. It is distinct thanks to the nanobot-specific target, though it risks overlap with the sibling update skill's "upgrade" wording.

Suggestions

Add a 'Use when...' clause with explicit trigger phrases, e.g. "Use when the user wants to set up, initialize, or reconfigure nanobot's upgrade/update skill."

Include natural trigger terms and their synonyms — "update skill", "configure", "install method", "upgrade setup" — so users' actual phrasing matches the description.

State the concrete outcome to sharpen the "what", e.g. "Generates a personalized <agent-workspace>/skills/update/SKILL.md with the user-confirmed install method."

DimensionReasoningScore

Specificity

"Set up or reconfigure nanobot's upgrade skill" names the domain (nanobot's upgrade skill) and two actions ("Set up", "reconfigure"), but the actions are generic and what setup involves is left unstated. It exceeds anchor 2 (more than one minimal/generic action on a specific named target) but falls short of anchor 4 (no list of several specific actions).

3 / 5

Completeness

The "what" is clear and specific ("Set up or reconfigure nanobot's upgrade skill"), but there is no "Use when..." clause or any equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. Not anchor 4 because "when" is entirely absent rather than merely imprecise; not anchor 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

Relevant keywords appear ("Set up", "reconfigure", "upgrade", "nanobot") that a user might naturally say, but common variations and synonyms ("update", "configure", "install") are missing and no trigger phrases are given. Not anchor 4 because keyword coverage is thin with no synonyms; not anchor 2 because there are several relevant domain keywords rather than one or two generic ones.

3 / 5

Distinctiveness Conflict Risk

Naming the specific product ("nanobot") and the specific artifact ("upgrade skill") carves a clear niche with only minor overlap risk against the closely related generated "update" skill, whose triggers ("upgrade nanobot") share the word "upgrade". Not anchor 5 because no distinct triggers are stated; not anchor 3 because the target is far more specific than generic "works with X" anchors.

4 / 5

Total

13

/

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

HKUDS/nanobot

Path

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