update-setup

One-time setup wizard for the nanobot upgrade skill. Triggers: setup update, configure update, 设置更新, 初始化更新.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./nanobot/skills/update-setup/SKILL.md

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 a tight, fully executable setup wizard with concrete commands, tables, and exact prompts, sequenced over five steps with strong validation checkpoints and feedback loops. Its only soft spots are minor trimmable prose and an organization that, while clear, keeps everything inline at ~124 lines.

Dimension	Reasoning	Score
Conciseness	The body is mostly exact commands, tables, and prompt templates with little concept explanation (e.g. 'nanobot --version', the method→command table), matching 'efficient; minor instances of over-explanation'; not a 5 because prose like 'These commands are best-effort; if one fails, keep going and show the useful output' could be trimmed.	4 / 5
Actionability	Provides copy-paste-ready exec commands, exact one-at-a-time question prompts, a method→upgrade-command table, a method→preflight table, and a full generated SKILL.md template, matching 'fully executable; copy-paste ready code or commands; specific examples cover the common cases'.	5 / 5
Workflow Clarity	Five clearly sequenced steps with explicit validation checkpoints and feedback loops — Step 1 checks existing and asks 'Reconfigure?', Step 3 has a CRITICAL 'do not write until confirmed' guardrail, the generated skill runs a preflight check, and Step 5 confirms only after write_file succeeds — matching 'clear sequence with explicit validation steps; feedback loops for error recovery'.	5 / 5
Progressive Disclosure	Well-organized into five labeled step sections with no nested references and no bundle files to navigate, matching 'good structure; most content is appropriately placed; minor organization gaps'; not a 5 because at ~124 lines the under-50-line simple-skill exception does not apply and the command tables / generated template could arguably live in separate reference files.	4 / 5
	Total	18 / 20 Passed

Description

70%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 third-person, concise, and pairs a clear purpose with an explicit Triggers list including bilingual synonyms. It is held back from the top band by a single named action and a terse 'what' that omits the generation outcome.

Suggestions

Expand the 'what' to state the concrete outcome, e.g. 'Generates a personalized nanobot upgrade skill in the agent workspace' so the action is comprehensive rather than single.

Add a couple more natural trigger variants (e.g. 'nanobot setup', '初始化nanobot') to round out trigger coverage.

Consider a brief 'Use when...' phrasing alongside 'Triggers:' to make the invocation context unambiguous.

Dimension	Reasoning	Score
Specificity	Quotes 'One-time setup wizard for the nanobot upgrade skill' — names the domain plus one concrete action (setup wizard), matching the 'names domain and 1-2 concrete actions' anchor; it is not a 2 because 'setup wizard' is a concrete action rather than generic, and not a 4 because only one action is named with no comprehensive coverage.	3 / 5
Completeness	Answers 'what' ('One-time setup wizard for the nanobot upgrade skill') and 'when' (explicit 'Triggers:' list), so the missing-trigger cap does not apply; it is not a 5 because the 'what' is terse and does not spell out that it generates a personalized upgrade skill.	4 / 5
Trigger Term Quality	Quotes 'Triggers: setup update, configure update, 设置更新, 初始化更新' — four natural trigger phrases including bilingual synonyms, matching 'good keyword coverage; a few natural terms missing'; not a 5 because common variations like 'nanobot setup' or '初始化nanobot' are absent.	4 / 5
Distinctiveness Conflict Risk	Targets a clear nanobot niche with distinct setup/configure triggers, matching 'mostly distinct; minor overlap risk'; not a 5 because 'setup update'/'configure update' could marginally overlap with a generic update skill.	4 / 5
	Total	15 / 20 Passed

Validation

100%

Warnings & errors only

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
Commit: 6eccc28

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.