CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-macos-statusbar

Add a macOS menu bar status indicator for NanoClaw. Shows a bolt icon with a green/red dot indicating whether NanoClaw is running, with Start, Stop, and Restart controls. macOS only.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/add-macos-statusbar/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 efficient, highly actionable install runbook: exact commands, a complete plist, and a genuine pre-flight/verify structure. Weak spots are minor — no failure-recovery guidance in the Verify phase, a couple of trimmable filler lines, and no overview of the bundle's file layout.

Suggestions

Add a short failure-recovery loop to Phase 3: if the launchctl column shows '-' instead of a PID, direct Claude to check logs/statusbar.error.log and re-run launchctl load after fixing.

Trim filler lines such as 'This produces a small native binary at dist/statusbar' and the Docker Desktop comparison to tighten token efficiency.

Add a one-line bundle map (e.g., source at add/src/statusbar.swift, uninstall guide at REMOVE.md) near the top so the file layout is navigable at a glance.

DimensionReasoningScore

Conciseness

The body is command-first and lean — pre-flight checks, swiftc invocation, full plist, launchctl commands — with almost no explanation of concepts Claude already knows. A few lines could be trimmed ('similar to how Docker Desktop appears in the menu bar', 'This produces a small native binary at dist/statusbar'), so it fits 'efficient; minor instances of over-explanation that could be trimmed' (4) rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: 'swiftc -O -o dist/statusbar "${CLAUDE_SKILL_DIR}/add/src/statusbar.swift"', 'xattr -cr dist/statusbar', a complete launchd plist XML block with explicit substitution instructions for {PROJECT_ROOT} and {HOME}, and exact verify/uninstall commands. This matches the anchor-5 fully-executable example.

5 / 5

Workflow Clarity

A clearly sequenced three-phase workflow with real checkpoints: platform check, 'which swiftc', 'launchctl list | grep com.nanoclaw.statusbar' to skip if already installed, and a Verify phase checking that the first column shows a PID (not '-'). What keeps it below anchor 5 is the missing error-recovery feedback loop — no guidance for what to do when verification fails (e.g., inspecting logs/statusbar.error.log) — which fits anchor 4's 'most checkpoints present; minor validation gaps'.

4 / 5

Progressive Disclosure

Good structure with clear phase headers, the bulky Swift source correctly externalized to add/src/statusbar.swift, the uninstall guide split out to a clearly signaled one-level-deep reference ('To uninstall, follow [REMOVE.md](REMOVE.md)'), and the inline plist justified as core content. It is not the ideal anchor-5 overview-with-references shape (no section explicitly maps what lives where), and the referenced files are not present in this bundle, so anchor 4's 'most content is appropriately placed; references mostly clear' is the best fit.

4 / 5

Total

17

/

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 concrete, specific, and clearly scoped to a niche task with no conflict risk. Its main weakness is the complete absence of a 'Use when...' trigger clause, which caps completeness at 3 and slightly weakens trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants a menu bar icon/status indicator for NanoClaw on macOS, or asks to start, stop, or monitor the NanoClaw service from the menu bar.'

Include natural synonyms users might say — 'status bar', 'menu bar icon', 'NSStatusItem' — to broaden trigger matching beyond the exact phrasing.

Optionally mention the View Logs / uninstall capability so the description covers what the skill actually delivers end-to-end.

DimensionReasoningScore

Specificity

Concrete actions are named: 'Add a macOS menu bar status indicator for NanoClaw', 'Shows a bolt icon with a green/red dot indicating whether NanoClaw is running', and 'Start, Stop, and Restart controls'. Several specific actions with minor gaps (View Logs and uninstall are in the body but not the description), which fits the 'lists several specific actions; minor gaps in coverage' anchor rather than the comprehensive anchor 5.

4 / 5

Completeness

The 'what' is clear (menu bar status indicator with dot status and Start/Stop/Restart controls), but there is no 'Use when...' clause or equivalent explicit trigger guidance; 'macOS only' is a platform constraint, not a trigger. Per the judging guideline, a missing 'Use when...' clause caps completeness at 3 — matching the 'clear what, when missing or only weakly implied' anchor.

3 / 5

Trigger Term Quality

Natural keywords include 'macOS', 'menu bar', 'status indicator', 'NanoClaw', 'running', 'Start, Stop, and Restart' — good coverage of what a user would say. A few natural terms are missing (e.g., 'status bar' as a synonym for 'menu bar', 'NSStatusItem', 'menu bar icon'), so it matches anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

A very clear niche — macOS menu bar indicator for NanoClaw specifically — with distinct trigger terms ('menu bar status indicator', 'NanoClaw', 'Start, Stop, and Restart'). Minimal conflict risk with any other skill, matching the anchor-5 example of a clear niche with distinct triggers.

5 / 5

Total

16

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

nanocoai/nanoclaw

Path

.claude/skills/add-macos-statusbar/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.