Content
82%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 well-organized, highly actionable skill body that mostly assumes Claude's competence and provides concrete worked examples. Its main weaknesses are a missing referenced template file, an implicit rather than explicit validation checkpoint, and minor content duplication with the reference file.
Suggestions
progressive_disclosure: The referenced templates/board-deck-template.md (cited in the References section and in frontmatter frameworks) does not exist in the bundle — either add the template file or remove the broken reference and the board-deck-template entry from frameworks.
workflow_clarity: Add an explicit pre-send validation checkpoint that converts the Common Mistakes table into a gated checklist (e.g., verify every metric has a target and status, every variance has a one-sentence cause, every ask is person-assigned).
conciseness: Consolidate the Delivering Bad News material with the overlapping How to Present Bad News section in references/deck-frameworks.md into one location to remove duplication.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and directive with tight constraints ("3 sentences. No more.", "6-8 metrics max") and no padding of concepts Claude already knows, but the Delivering Bad News section overlaps with the same topic in references/deck-frameworks.md and a few aphoristic lines could be trimmed. | 4 / 5 |
Actionability | Highly concrete, instruction-only guidance with copy-paste-ready worked examples (the Good executive summary, the metrics table, the ARR waterfall, the 5-step bad-news framework) and specific rules ("One sentence on each variance", forecast must have a confidence level) that cover the common cases. | 5 / 5 |
Workflow Clarity | Clear sequencing throughout (ordered 1-11 deck structure, 4-Act narrative, 5-step bad-news framework) and the Common Mistakes table functions as a checklist, but there is no explicit validate-before-send checkpoint or feedback loop in the build flow. | 4 / 5 |
Progressive Disclosure | Good overall structure with SKILL.md as an overview and a clearly signaled one-level-deep reference (references/deck-frameworks.md) with detailed benchmarks appropriately split out, but the referenced templates/board-deck-template.md does not exist in the bundle, leaving a broken reference. | 4 / 5 |
Total | 17 / 20 Passed |