Content
72%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable and well-organized, with concrete templates, exact paths, and clear subcommand logic. The main weakness is redundancy across the duplicated overview sections and the absence of explicit validation feedback loops for the destructive archive/write operations.
Suggestions
Collapse the duplicated '# Matter Workspace' overview and the repeated disabled-state explanation into a single section; reference it instead of restating the `/cold-start-interview --redo` guidance twice.
Add an explicit validation step to the `close` and `new` workflows — e.g., after archiving, confirm the source path is gone and the archived path exists; after writing matter.md, verify the file parses before reporting success.
De-duplicate the slug rules (currently stated in both the 'Notes' and 'Storage layout' sections) to a single authoritative location.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of explaining concepts Claude already knows, but the body carries redundancy — a duplicated '# Matter Workspace' overview, the disabled-state explanation repeated in both 'Instructions' and the second section, and slug rules stated twice — that could be tightened. | 2 / 3 |
Actionability | Concrete and copy-ready throughout: exact storage paths, a fill-in matter.md template, a history.md seed, table column specs for `list`, and explicit per-subcommand file operations. | 3 / 3 |
Workflow Clarity | Steps are well sequenced and include confirmation checkpoints ('Show the user what changed and confirm before writing'), but destructive/batch operations like `close` (archive move) and `new` (writing files) lack an explicit validate→fix→retry feedback loop, which caps this dimension per the rubric. | 2 / 3 |
Progressive Disclosure | No bundle files exist, yet the skill is appropriately sectioned (Subcommand logic, Storage layout, templates, Cross-matter context, What this skill does not do) with one-level internal navigation and no nested references — well-organized for a self-contained skill under the rubric's simple-skill note. | 3 / 3 |
Total | 10 / 12 Passed |