Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clear sequenced workflow and thorough edge-case handling, but it is over-long for a single file and keeps large render templates inline with no reference split-out. Tightening prose and moving the verbatim output blocks into reference files would lift the two mid-tier dimensions.
Suggestions
Trim explanatory rationale such as 'This is the first impression...' and 'The user has been working...' to directive statements, cutting roughly 30-50 lines of meta-commentary.
Move the full NARRATIVE/CONTEXTUAL/COMPACT output templates into reference files (e.g., references/narrative.md, references/contextual.md) and keep SKILL.md as an overview that signals them one level deep, improving progressive disclosure.
Consolidate the repeated command-listings across the three mode templates into a single shared reference block referenced by each mode to reduce duplication.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~340-line body is mostly efficient but carries unnecessary meta-commentary (e.g., 'This is the first impression. The user is new or nearly new. Explain what the system IS before listing what it DOES') and repeated verbatim output blocks that could be tightened, matching the 'mostly efficient but could be tightened' anchor rather than the lean top anchor. | 2 / 3 |
Actionability | Concrete executable bash counting commands, explicit mode-determination and suggestion decision tables, and exact copy-paste-ready render templates make the guidance fully actionable, matching the top anchor for an instruction-only skill. | 3 / 3 |
Workflow Clarity | A clear five-step sequence (Gather vault state → Resolve vocabulary → Determine mode → Discover commands → Render) with explicit decision tables and an Edge Cases section covering missing files and pre-init invocation matches the clear-sequence anchor; no destructive operation requires validation feedback loops. | 3 / 3 |
Progressive Disclosure | There are no bundle files and the entire body is a monolithic ~340-line SKILL.md with the large output templates inline, matching the 'some structure but content that should be separate is inline' anchor rather than a well-split overview with one-level-deep references. | 2 / 3 |
Total | 10 / 12 Passed |