Content
88%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 highly actionable, well-validated workflow: concrete commands, a deterministic bundled script with a documented output contract, explicit error handling, and honest data-sufficiency thresholds. The only weaknesses are mild duplication of the meeting-count thresholds and a monolithic body that could split the metric reference and output templates into a separate file.
Suggestions
State the ≥5-meeting and ≥3-per-tag thresholds once (Phase 2b) and have the Gotchas entry reference them instead of repeating them verbatim.
Move the per-meeting JSON field table and/or the two output templates to a references/ file (e.g., OUTPUT_FORMATS.md) to shorten SKILL.md to an overview plus navigation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes competence — commands, flags, exit codes, and thresholds are stated without tutorial padding — but there is duplication: the ≥5-meeting behavioral threshold and the ≥3-per-tag outcome threshold each appear in both Phase 2b and Gotchas, and some coaching-philosophy prose ("The point is not to roast you…") could be trimmed. It is noticeably above anchor 3 (only minor tightening needed), short of anchor 5 due to the repeated threshold statements. | 4 / 5 |
Actionability | Fully executable throughout: exact commands ("minutes list --content-type meeting --limit 5"), a copy-paste stdin pipeline invoking the verified bundled script with the --self flag, a complete JSON output field table, exit-code-specific recovery (exit 3 names found speaker labels to retry with), and concrete output templates. This matches the anchor-5 'copy-paste ready, common cases covered' example. | 5 / 5 |
Workflow Clarity | Phases 0→3 are clearly sequenced with explicit validation checkpoints ("Require exit status 0", "Require both sides of the pipeline to exit successfully"), an error-recovery loop for exit code 3, data-sufficiency thresholds that force honest reporting below them, and a no-diarization failure path ("Don't compute talk-time on a transcript without speakers"). This is the anchor-5 pattern of sequence + validation + feedback loops for a batch operation. | 5 / 5 |
Progressive Disclosure | The single bundle file (scripts/mirror_metrics.py — verified to exist and to produce the documented fields, filler/hedge lists, and outcome tags) is referenced cleanly one level deep with its output contract documented inline. However, all mode details, metric tables, and output templates live inline in a ~230-line body with no content split into reference files. Good structure, minor organization gap — anchor 4 rather than 5, where the body is a longer 'everything inline' spec. | 4 / 5 |
Total | 18 / 20 Passed |