Content
100%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.
An exemplary short skill body: lean, executable, with a clear single-action workflow and a well-structured two-file progressive disclosure that keeps the overview uncluttered. No significant weaknesses across any dimension.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and direct — executable commands, minimal prose, no explaining of what markdown is or how libraries work — and lines like "Relative paths resolve against the caller's cwd and `~` expands" earn their place. Matches the anchor for lean, efficient content that assumes Claude's competence. Not 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Three concrete executable commands with real flags (--workspace/--surface/--window) plus a copy-paste-ready AGENTS.md snippet give fully executable, common-case coverage. Matches the anchor for copy-paste-ready commands covering common cases. Not 4 because the examples cover the common cases with specific, working flags. | 5 / 5 |
Workflow Clarity | As a single-purpose skill (open a .md file), the workflow is unambiguous with a meaningful pre-step ("Write the full plan file first, then open it, so the panel never shows a partially written file") and clear post-open guidance (overwrite/append freely triggers re-render). The simple-skill exception applies; no destructive/batch validation cap is relevant. Not 4 because the single action is unambiguous with a real pre-step. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a "Deep-dive references" table pointing to two real, one-level-deep files (references/commands.md and references/live-reload.md), each clearly signaled with a "When to Use" column; bulk command syntax and reload internals are correctly split out into those files. Matches the anchor for a clear overview with well-signaled one-level-deep references. Not 4 because navigation is clean and references are genuinely one level deep (verified the files exist and contain the deferred detail). | 5 / 5 |
Total | 20 / 20 Passed |