Content
70%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.
Well-structured body with an explicit, validation-rich workflow and concrete command examples, but its value is undermined because all referenced bundle files (scripts, references, assets) are missing, breaking both executability and navigation.
Suggestions
Ship the referenced bundle files (scripts/meeting_cost_calculator.py, agenda_builder.py, action_item_extractor.py, references/*.md, assets/*.md) so the command examples are actually runnable and the links resolve.
Remove the duplicated Distinct-From and version/build-pattern footer text that restate the frontmatter distinct_from and metadata to tighten conciseness.
If any referenced file is intentionally omitted, replace the dead links with a note or inline the minimal needed content rather than pointing at non-existent paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean with tight sections, a script table, and no padding about concepts Claude already knows; held at 4 rather than 5 because the "Distinct From" section and the version/build-pattern footer duplicate the frontmatter distinct_from and metadata, and the "What this does" intro is mildly editorial. | 4 / 5 |
Actionability | Provides concrete command lines with full flag syntax (e.g. "--attendees 6 --minutes 60 --avg-rate 90 --include-refocus --has-decision --has-agenda --has-owner") and a worked topic format, but the referenced scripts (scripts/meeting_cost_calculator.py, agenda_builder.py, action_item_extractor.py) are absent from the bundle so the commands are not actually executable — a missing-key-detail gap matching the 3 anchor rather than a minor 4 gap. | 3 / 5 |
Workflow Clarity | A clear gate → agenda → run → extract sequence with explicit exit-code validation checkpoints (exit 2/3/0), feedback loops ("re-run until it fits; the stop condition is exit 0"), and a Rules checklist plus a completion check ("done when every action has an owner and a date") — matches the 5 anchor; not capped at 3 because validation is present and the skill is not destructive/batch. | 5 / 5 |
Progressive Disclosure | Structure and signaling are good — a Scripts table plus clearly labeled References and Assets lists, one level deep — but every referenced path (scripts/*.py, references/*.md, assets/*.md) points to a file that does not exist in the bundle, so navigation is broken; this drops it to 3 rather than 4-5 because the disclosure structure is not actually functional. | 3 / 5 |
Total | 15 / 20 Passed |