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 disciplined, high-quality body: fully executable commands, a clearly sequenced workflow with exit-code checkpoints and explicit feedback loops, and a clean overview that offloads detail to real, well-signaled one-level-deep bundle files. The only blemish is minor redundancy — a duplicated metadata footer and a 'What this does' section that restates the description.
Suggestions
Remove the trailing 'Version / Build pattern' footer — it duplicates the frontmatter metadata verbatim and adds no guidance.
Merge the 'Portability' blockquote and 'What this does' section into a single short framing paragraph; both restate scope already covered by the description and the workflow section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — tight four-step workflow, a table instead of prose for scripts, no explanation of concepts Claude already knows — but there are minor trims available: the trailing "**Version:** 1.0.0 / **Build pattern:**" footer duplicates the frontmatter metadata verbatim, and "What this does" restates the description's scope. This fits score 4's 'minor instances that could be trimmed' rather than score 5's 'every token earns its place'; it is clearly leaner than score 3's unnecessary explanations. | 4 / 5 |
Actionability | All three commands are copy-paste ready with real flag values ("--attendees 6 --minutes 60 --avg-rate 90 --include-refocus --has-decision --has-agenda --has-owner", "--length 45 --topic 'Q3 pricing:Decide usage-based vs seat-based:15:maria'") and the examples cover the common cases for each script. Exit codes are documented so failures are actionable. This matches the fully-executable anchor rather than score 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The gate → agenda → run → extract sequence is explicit with validation checkpoints at every stage: gate exit codes (ASYNC exit 2, NOT-READY exit 3, MEET exit 0), an iteration feedback loop for the agenda ("Iterate — trim or split the named topic and re-run until it fits; the stop condition is exit 0"), and a completion check closing the loop for extraction ("the meeting is done when every action has an owner and a date"). No destructive/batch operations, so the score-3 cap does not apply. | 5 / 5 |
Progressive Disclosure | The body is a navigable overview with all 8 bundle files (3 references, 3 scripts, 2 assets) existing on disk, each listed with a one-line role description and clearly signaled links. References are one level deep — reference files only cross-link to siblings, not to further nested files — and the detailed canon is correctly split out of SKILL.md. Matches the well-signaled one-level-deep anchor. | 5 / 5 |
Total | 19 / 20 Passed |