CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

update-nanoclaw

Efficiently bring upstream NanoClaw updates into a customized install, with preview, selective cherry-pick, and low token usage.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/update-nanoclaw/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong, highly actionable procedure with excellent sequencing and validation checkpoints for a risky git operation. Its main weakness is redundancy: the front-half overview and token-usage sections restate the detailed steps and could be cut or collapsed.

Suggestions

Remove or drastically shrink the 'About / How it works' overview that duplicates Steps 0-8, keeping at most a 3-4 line summary.

Fold the 'Token usage' section into the operating principles to avoid restating the same points twice.

DimensionReasoningScore

Conciseness

The detailed Step 0-8 procedure is lean and command-driven with no explanations of concepts Claude already knows, but the 'About / How it works' overview (~45 lines) and 'Token usage' section substantially duplicate the detailed steps and operating principles. This is 'mostly efficient but could be tightened' rather than 2, since the bulk of the body earns its place, and not 4 because the duplicated overview is more than a minor trim.

3 / 5

Actionability

Commands are copy-paste ready and cover the common cases end to end: the chained dry-run 'git merge --no-commit --no-ff upstream/$UPSTREAM_BRANCH; git diff --name-only --diff-filter=U; git merge --abort', timestamped backup branch/tag creation, cherry-pick continue/abort, validation commands, and the CHANGELOG diff for '[BREAKING]' entries.

5 / 5

Workflow Clarity

Steps 0-8 are clearly sequenced with explicit validation checkpoints: dirty-tree preflight stop, backup before any change, dry-run conflict preview with abort option, npm run build/test validation, and a rebase abort after more than 3 conflict rounds. The destructive-operation validation cap does not apply because validation is thorough, so this is not 4.

5 / 5

Progressive Disclosure

Good structure with clear step sections and a well-signaled, one-level-deep reference ('.claude/skills/update-nanoclaw/diagnostics.md' with instructions to read and follow it). Not 5 because the opening overview duplicates the detailed steps instead of pointing to them, which is a minor organization gap; not 3 because content placement and the reference signaling are otherwise appropriate.

4 / 5

Total

17

/

20

Passed

Description

62%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 specific and highly distinctive thanks to the named product, but it omits any 'when to use' trigger guidance and lacks common natural phrasings like 'sync' or 'update my fork'. Adding an explicit trigger clause and a couple of user-voiced synonyms would raise it substantially.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user asks to update, sync, or pull upstream changes into their NanoClaw install/fork.'

Include natural user phrasings such as 'sync', 'update my install', and 'pull upstream changes' alongside the current git jargon.

Mention the merge and conflict-resolution capabilities (e.g. 'resolves merge conflicts while preserving local customizations') to round out coverage.

DimensionReasoningScore

Specificity

Names the domain ('upstream NanoClaw updates into a customized install') and several concrete actions ('preview, selective cherry-pick'), matching 'lists several specific actions; minor gaps in coverage'. It is not 5 because merge, conflict resolution, and validation are unmentioned, and not 3 because it goes beyond 1-2 actions.

4 / 5

Completeness

The 'what' is clear (bring upstream updates into a customized install with preview and cherry-pick), but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Terms like 'upstream updates', 'cherry-pick', and 'customized install' are relevant, but common natural phrases users would say ('sync', 'update my fork', 'pull upstream changes', 'merge') are missing — matching 'some relevant keywords but missing common variations or synonyms' rather than the good-but-incomplete coverage of a 4.

3 / 5

Distinctiveness Conflict Risk

'NanoClaw' names a specific product, giving the skill a clear niche with distinct triggers and minimal conflict risk; no other skill would plausibly trigger on this description. Not 4, since even 'minor overlap with closely related skills' is implausible given the explicit product name.

5 / 5

Total

15

/

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

jbaruch/nanoclaw-telegram

Path

.claude/skills/update-nanoclaw/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.