Content
63%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.
The retro workflow itself is exceptionally actionable — exact commands, schemas, output templates, and error paths throughout — with a well-sequenced multi-mode flow. However, the file is bloated with framework boilerplate unrelated to the retrospective task and is a single 56KB monolith with no progressive disclosure, which hurts token efficiency and navigability.
Suggestions
Move the generic framework sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, Completion Status Protocol, Plan Status Footer, preamble/telemetry shell) out of SKILL.md into a shared reference file the skill points to, keeping only retro-specific instructions inline.
Split the ~330-line Global Retrospective Mode (discovery flow, personal card template, JSON schema) and the snapshot schemas into a separate reference file referenced from the main workflow, shrinking SKILL.md to an overview plus the core Steps 1-14.
Fix the internal inconsistencies: two commands in Step 1 are both numbered "# 12", and Step 14's narrative cites "Trends vs Last Retro (from Step 11)" when that data is loaded in Step 12.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~1190-line body pads the retro task with large framework boilerplate — a 45-line preamble shell block, the multi-section "Voice" persona, the "Boil the Lake" essay promo, telemetry/AskUserQuestion/Contributor/Plan Status sections — plus duplicate numbering (two commands labeled "# 12") and a mislabeled cross-reference ("from Step 11" for data computed in Step 12). Several sections are unnecessary or unrelated to the task, matching the 2 anchor rather than 3's "some unnecessary explanation". | 2 / 5 |
Actionability | Every step ships copy-paste-ready bash commands, argument validation with exact usage text, concrete JSON snapshot schemas, formatted output templates (leaderboard, personal card, trends tables), and binary fallback chains with explicit placeholder substitution (SKILL_NAME, OUTCOME, USED_BROWSE). Fully executable guidance covering the common cases — the 5 anchor; not 4 since gaps are negligible. | 5 / 5 |
Workflow Clarity | Steps 0-14 are clearly sequenced with distinct Global and Compare flows, and validation checkpoints are explicit (invalid argument → show usage and stop; zero commits → suggest different window; no discovery binary or zero sessions → message and stop; compare only when prior window matches). Minor gaps — the duplicate "12" commands, the "from Step 11" mislabel, and absent feedback/retry loops — keep it at 4 rather than 5; the skill is read-only analysis so the destructive-operation cap does not apply. | 4 / 5 |
Progressive Disclosure | This is a single monolithic file with no bundle files at all: the retro workflow, global mode, JSON schemas, and generic framework policy are all inlined. Header navigation is good and there are no nested or broken references (so above 2's "minimal structure"), but substantial content that clearly belongs in separate files is inline — the 3 anchor. | 3 / 5 |
Total | 14 / 20 Passed |