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 strong, highly actionable body: exact MCP verb syntax, an explicit staged workflow with RED/GREEN validation feedback loops, and a clean two-file reference split. The main weakness is redundancy — several rules (reference path semantics, the import-vs-npx gate) are stated twice or more, which inflates the token budget without adding guidance.
Suggestions
Deduplicate the reference-path rules: state the backtick-path vs `[[wiki-link]]` and global-references-dangle guidance once (Stage 5, where files are written) and drop the near-verbatim repeat in Stage 3.
Tighten Stage 1's gate paragraph: the 'do not run `npx skills add`… import through OpenKnowledge' instruction appears twice within the same stage — merge into one statement of the rule and its reason.
Trim the Reminders section of points already enforced inline (e.g. the parenthetical re-statement of the Stage 1 gate) so each reminder adds a rule the stages don't already carry.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — imperative, no explanation of concepts the agent already knows — but it repeats itself: the reference-path/graph rules (backtick path vs `[[wiki-link]]`, global references not being graph docs) appear nearly verbatim in both Stage 3 and Stage 5, the 'import via OpenKnowledge, not `npx skills add`' instruction is stated twice within Stage 1, and the Reminders section re-litigates the Stage 1 gate. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 2 because there is no padding or explanation of known concepts, just duplication. | 3 / 5 |
Actionability | Guidance is copy-paste ready throughout: exact verb signatures (`write({ skill: { name, description, body, scope } })`, `edit({ skill: { name, file, find, replace } })`, `install({ name, add, remove, mode, convert, source })`), a concrete scope table with example folder paths, and a precise frontmatter contract (name 'lowercase letters, digits, hyphens; ≤64; equals the directory', description '≤1024 chars, no XML tags, no version field'). This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Stages 1–8 are explicitly ordered ('Work the stages below in order, but jump to where the user already is') with validation checkpoints and feedback loops: the Stage 1 reuse gate with a hard STOP condition, the Stage 4 RED baseline, and Stage 6's GREEN eval with 'patch any loophole and re-test'. This matches 'Clear sequence with explicit validation steps; feedback loops for error recovery'; score 4 would require missing checkpoints, and none are missing. | 5 / 5 |
Progressive Disclosure | Both body references point at real, verified bundle files — `references/description-optimization.md` (Stage 7) and `references/pressure-testing.md` (Stage 6) — signaled with clear backticked paths, one level deep, with the depth genuinely split out of the ~228-line body. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'; there is no inline bulk that belongs in a reference file. | 5 / 5 |
Total | 18 / 20 Passed |