Content
77%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 clearly sequenced with solid validation checkpoints, but the body is longer than necessary due to duplicated subcommand/disabled-state content across its two sections and keeps all templates inline rather than splitting them into reference files.
Suggestions
Collapse the two parallel sections into one: keep a single subcommand-logic block and remove the duplicated 'Instructions' dispatch and disabled-state prose (it already appears under 'Matter Workspace').
Move the matter.md and history.md templates into a references/ file (e.g. references/matter-template.md) and link to it, so the SKILL.md body stays an overview and progressive disclosure becomes one level deep.
De-duplicate the slug rule and the 'do not delete, archive' note so each appears once.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Operational and largely lean, but the body carries two parallel sections (the /matter-workspace command block and the 'Matter Workspace' reference) that duplicate subcommand logic, the disabled-state explanation, and the 'Slugs are lowercase with hyphens' rule. | 2 / 3 |
Actionability | Concrete file paths, exact storage layout, complete matter.md/history.md templates, and a dispatch table make the guidance copy-paste ready; absence of code is fine for this instruction-only skill. | 3 / 3 |
Workflow Clarity | Each subcommand has numbered steps with explicit checkpoints — slug-uniqueness and existence checks, 'confirm before writing', 'do not auto-switch — ask', and offer-to-create fallbacks — providing clear validation and error-recovery loops. | 3 / 3 |
Progressive Disclosure | Well-sectioned with clear headers, but everything (templates, storage layout, cross-matter policy) is inline in a single ~185-line file with no bundle files or one-level-deep references to split out the templates. | 2 / 3 |
Total | 10 / 12 Passed |