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.
A well-engineered instruction skill: a concrete, gated six-step flow with real safeguards against clobbering, disciplined reference usage verified against the actual bundle, and near-complete actionability. The only improvement area is trimming repetition of the external-repo rule and moving some pattern backstory into the existing reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — the P1–P8 philosophy items each drive behavior and it explicitly says "Don't recite these — embody them". However, the never-write-into-the-app-codebase rule is repeated in four places (Preconditions, Step 0, Invocation & output contract, Hard nevers), and background passages like "The bookkeeping that makes humans abandon wikis... is exactly what an LLM is good at" could be trimmed into the reference file. Mostly efficient with minor over-explanation, matching anchor 4 rather than 5. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: an exact directory tree ("wiki/{concepts,entities,workflows,sources,indexes,inbox}/", "_meta/ingest-log.md"), per-step interview questions with concrete examples ("SNF survey readiness", "event-driven backend architecture"), exact file provenance ("render assets/WIKI-CONVENTIONS.md.template", commands "from assets/commands/"), and exact command forms ("/ingest <path-or-url>", "/query \"<question>\""). Per the scoring notes, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Steps 0–5 are clearly sequenced with explicit validation checkpoints: the explain→confirm→act→feedback loop is stated up front, Step 2 says "Stop and wait for approval, unless --yolo was passed", Step 4 says "Confirm with the user before committing", and the plan-pass has a loop ("Apply edits, re-emit, loop until approved"). Risky operations (targeting an existing path) are guarded by refuse-to-clobber and the diff-based re-run procedure — feedback loops are present, matching anchor 5. | 5 / 5 |
Progressive Disclosure | Structure matches anchor 5: three one-level-deep references, each existing in the bundle and each loaded at the point of need (two "Read first, before talking to the user"; "load references/domain-discovery.md when you reach Step 1"), with stated purpose for each ("so you can explain what an LLM Wiki is", "the disciplines nothing you scaffold may drop"). Bulk material is appropriately split into assets/ templates and command files, keeping SKILL.md a navigable overview. | 5 / 5 |
Total | 19 / 20 Passed |