Content
67%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-structured advisory framework with genuinely actionable steps, embedded validation gates, and per-decision checklists. Its weaknesses are duplicated cost-of-delay messaging that could be trimmed, and a mismatch between the description's advertised regret-minimization pass and the body's actual six steps.
Suggestions
Cut or merge the 'Why These Decisions Are Hard' section and 'The Avoiding-It Test' cost-of-delay prose into a single short section — they repeat the same 'delay compounds the problem' message three times.
Either add the promised regret-minimization step to the framework or drop 'regret-minimization' from the description so the advertised methods match the body.
State how the Decision-Specific Frameworks relate to the six-step sequence (e.g. 'run the six steps, then the matching decision-specific checklist'), and consider moving them into one-level-deep reference files to shrink SKILL.md toward a true overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, but the "Why These Decisions Are Hard" section explains motivation Claude already understands, and "The Avoiding-It Test" section repeats the cost-of-delay point already made in Step 1's aftermath prose ("The longer you avoid a hard call, the worse the situation usually gets" vs. "Every month you wait, the problem compounds"). It is not a 2 because the core framework steps themselves are tight and free of padding; it is not a 4 because the duplicated avoidance messaging is a real trim opportunity. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: three specific 10/10/10 questions, the exact Andy Grove test question, a fill-in stakeholder impact table, five named communication-plan items, and per-decision question checklists with "The rule" heuristics. Not a 5 because some guidance remains abstract ("does that sentence ring true?"), the empty stakeholder table has no instructions on how to use the filled result, and the description's promised regret-minimization pass has no corresponding step in the body. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps with go/no-go checkpoints embedded (the Reversibility Test raises the certainty bar, the Pre-Announcement Test gates readiness, the Avoiding-It Test is a checklist). Not a 5 because the relationship between the six-step sequence and the decision-specific frameworks sections is never stated (does the user run the steps then the specific questions?), and Step 4's table output feeds into no explicit next action. Not a 3 because validation gates are explicit, not merely implicit. | 4 / 5 |
Progressive Disclosure | A single ~150-line file with well-organized headers and clearly signaled references ("See ../executive-mentor/references/hard_things.md — Co-Founder Conflicts for full framework"). Not a 5 because both references point outside this skill's bundle to a sibling skill's file, creating a fragile dependency that cannot be verified from the skill itself, and the decision-specific frameworks (co-founder, layoffs, pivot, product kill) are natural candidates for one-level-deep reference files. Not a 3 because what is present is well-signaled and appropriately concise. | 4 / 5 |
Total | 15 / 20 Passed |