Content
85%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A highly actionable, well-sequenced procedural skill with strong validation and error-recovery guidance for a risky operation. Its main weakness is progressive disclosure: the REMOVE.md reference is broken and no supporting bundle files exist.
Suggestions
Create the referenced REMOVE.md (or remove the link) so the one external reference resolves — currently it points at a missing file.
Consider moving the Troubleshooting section and the long block-rule/credential shell one-liners into a references/ file that SKILL.md points to, reducing body length while keeping the procedural spine inline.
Add a short 'What this skill does / does not do' summary near the top so the overview is scannable before the directive-heavy steps begin.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and assumes Claude's competence about NanoClaw/OneCLI/ncl; the prose present is mostly non-obvious domain rationale (vault semantics, block-rule naming) rather than generic padding, though a few explanatory passages could still be trimmed. | 4 / 5 |
Actionability | Fully executable throughout: concrete shell commands with real flags and jq pipelines, directive fences with variable substitution, and copy-paste-ready examples covering the common install/sign-in/scope cases. | 5 / 5 |
Workflow Clarity | Clear multi-step sequence with explicit validation checkpoints (`effect:check`, `validate:` regexes, signed_in branching) and feedback loops (stop-and-retry on pre-flight failure, a full Troubleshooting section) — appropriate for a money-spending, real-people-reaching operation. | 5 / 5 |
Progressive Disclosure | Well-sectioned structure with a clearly signaled one-level reference to REMOVE.md, but no bundle files exist and the referenced REMOVE.md is missing (broken link), and most detail (troubleshooting, credential logic) is inlined rather than offloaded. | 3 / 5 |
Total | 17 / 20 Passed |