Content
77%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 index-style skill: a clearly sequenced 11-phase loop with explicit validation gates, and a progressive-disclosure structure where every link resolves to a real one-level-deep reference file. The one real weakness is repetition — the mandate to read the references is hammered out in multiple emphatic blocks that could be consolidated without losing force.
Suggestions
Consolidate the repeated 'read the references' exhortations (the 🚨 section, the gate rule paragraph, the 'If you cannot honestly say...' line, and the closing tools paragraph) into a single authoritative statement to cut padded emphasis.
Trim duplicated framing between the header note ('Ninety percent of what you need to know lives in references/') and lines like 'The references are the skill. This file is an index.' — one of these suffices.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The index-only design is efficient and the gotcha blurbs (e.g. 'tsx + node inspect CLI has a silent source-map failure') are non-obvious value, but the 'read the references' exhortation is repeated roughly five times ('READ THE REFERENCES. THIS IS NOT OPTIONAL', 'Every reference below is mandatory', the gate rule, 'If you cannot honestly say you just opened the reference... open it now', 'Failing to use these tools... is a process failure'), which is padded emphasis that could be tightened to one statement. It sits at the anchor of mostly efficient with some unnecessary repetition, not the 'minor instances' level of a 4. | 3 / 5 |
Actionability | The body gives mostly executable guidance: a copy-paste-ready discriminator pipeline ('du -h ./target' plus "strings -n 12 ./target | rg -iE 'bun|node_modules|webpack|...'"), a concrete gate rule, a numbered 'What to Do Right Now' sequence, and precise per-phase entry points. It is not a 5 because most actual commands live in the reference files, so the body itself contains only a few executable snippets rather than examples covering the common cases. | 4 / 5 |
Workflow Clarity | The 11-phase loop (0–10) is clearly sequenced with an explicit per-phase reference, and validation checkpoints are explicit: root cause confirmed only when 'toggling the suspected cause toggles the bug', the fix 'locked by a failing proof', cleanup verified by 'git diff shows only fix + test', and 'four evidence gates before declaring done'. Feedback loops are built in (Oracle Triple 'after 2 consecutive failed rounds', flaky-triage read before Phase 2), matching the anchor for clear sequence with explicit validation steps and feedback loops. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: the body is a pure index and every cited path (6 runtimes, 6 tools, 9 methodology files, references/scripts/dap.mjs) exists exactly where linked, one level deep with no orphaned or buried references. Situation-to-file mapping tables (runtime table, specialist-tool table, phase table, cross-cutting table) make navigation trivial, matching the anchor for a clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 17 / 20 Passed |