Content
92%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 instruction-only skill body: highly actionable mode routing and load rules, explicit validation and error-reporting checkpoints, and textbook progressive disclosure with correctly gated, verified bundle files. The only weakness is minor redundancy from restating a few prohibitions and boundaries in multiple sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, assumes Claude's competence throughout — no explanation of what AGENTS.md, compaction, or symlinks are — and every section carries operational rules. Falls short of the 5 anchor only due to minor repetition that could be trimmed: the prohibition on substituting a `rules/` directory or repository `AGENTS.md` appears in both "Resolve the index" and the inventory step, and the metadata-only read boundary is stated then restated for `status` and setup. | 4 / 5 |
Actionability | Although code-free, the guidance is fully executable for an instruction skill: a numbered index-resolution order with explicit tie-breakers ("An explicit request selects this invocation's path without rewriting the persistent pointer"), a mode table with entry and done-when conditions, and exact selection rules ("Load every rule in its always-on group, plus each conditional rule whose documented trigger matches"). Matches the top anchor for concrete, case-covering guidance. | 5 / 5 |
Workflow Clarity | Clear sequences with explicit validation checkpoints and feedback loops: report-and-ask on ambiguity ("report the problem and ask for the intended path"), error reporting instead of silent assumptions ("If either path cannot be resolved or read, report that error rather than assuming equality or a mismatch"), a pass/fail definition for `status`, and a done-when checklist per mode including "discovery is verified in a fresh session, or reported untested". Setup's write operations are guarded (links must resolve "without replacing other files"), so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | Clear overview with well-signaled references, all verified to exist: onboarding.md is gated to four modes ("For `setup`, `fine-tune`, `link-dot-files`, or `update`, read..."), public-example.md is gated to "only when the user wants a sample rule set", and the body explicitly notes "Startup and reload need neither reference". References are one level deep — onboarding.md's link to public-example.md is also directly reachable from SKILL.md — and evals live in assets/ with an author-only gate, so nothing is buried. | 5 / 5 |
Total | 19 / 20 Passed |