Content
96%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 tight, highly actionable skill body: concrete commands, verify-first workflows with graceful failure handling in every section, and zero filler. The only gap is organizational — it is slightly long for a single SKILL.md and some operational detail could be split into a reference file for cleaner progressive disclosure.
Suggestions
Consider moving the New section's config-section-header taxonomy ('# --- Vault-specific ---' handling rules) and the List section's display-formatting example into a short reference file, keeping SKILL.md as a leaner overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is purely operational — no concept explanations, no padding; the CONFIG_DIR snippet and commands are load-bearing. Only trivial duplication of the @name override rule (prose + dispatch row), which keeps it at the 5 anchor rather than dropping to 4. | 5 / 5 |
Actionability | Copy-paste-ready commands cover the common cases: the CONFIG_DIR resolution one-liner, 'ln -sf', 'readlink', and 'cp'; the List/Show/New sections give concrete instruction-only guidance (comment-line labels, API_KEY/SECRET redaction, section-header taxonomy) that is fully actionable. | 5 / 5 |
Workflow Clarity | Every section has an explicit verify-first checkpoint with error recovery: Switch verifies the config exists and falls back to List, New aborts on name collision, Show handles a missing file, and List handles a broken symlink ('(none active)'). This matches the 5 anchor's explicit validation and feedback loops. | 5 / 5 |
Progressive Disclosure | Structure is good — a dispatch table routes to four clean sections and the single external reference (llm-wiki/SKILL.md) is clearly signaled and one level deep. At ~105 body lines it exceeds the <50-line simple-skill exception, and inline detail like the config-section-header taxonomy and List display formatting could live in a reference file, matching the 4 anchor. | 4 / 5 |
Total | 19 / 20 Passed |