Content
50%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 body is well-organized and stylistically strong, with clearly signaled commands, references, and a defined output protocol. Its main weaknesses are duplicated command descriptions and persona padding, plus the fact that every referenced file — scripts, references, agents, and sibling SKILL.md files — is absent from the bundle, leaving both actionability and the disclosure chain incomplete.
Suggestions
Ship the referenced files (scripts/decision_matrix_scorer.py, scripts/stakeholder_mapper.py, references/hard_things.md, board_dynamics.md, crisis_playbook.md, agents/devils-advocate.md) in the bundle, or remove the pointers and inline the essential guidance.
Merge the "## Commands" table and "## Commands in Detail" into one section and drop the "## Keywords" section and the Grove/Horowitz anecdote to cut duplicated and non-instructional content.
Inline a short version of the "Internal Quality Loop" validation steps instead of deferring to an external agent-protocol SKILL.md, so the workflow has explicit checkpoints within this file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — punchy sections like "Voice" ("Direct. Uncomfortable when necessary. Not mean — honest.") and the command table earn their tokens — but there is real duplication and padding: the five commands are fully described twice ("## Commands" table and "## Commands in Detail"), a "## Keywords" section repeats trigger words the description already handles, and "## What This Isn't" plus the Andy Grove/Ben Horowitz anecdote are persona marketing rather than instruction. This fits the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened") better than 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Guidance is conceptually concrete for an instruction-only skill — severity ratings ("Critical / High / Medium"), "10/10/10 framework", "5 Whys without softening, contributing factors vs root cause, owners per change, verification dates", and a fixed output format ("Bottom Line → What (with confidence) → Why → How to Act → Your Decision"). But it is incomplete in execution: the Quick Start instructs "python scripts/decision_matrix_scorer.py" and "python scripts/stakeholder_mapper.py" yet no scripts/ directory exists in the bundle, and every command defers to "See ../challenge/SKILL.md"-style files that are also absent. That matches the 3 anchor ("some concrete guidance but incomplete... missing key details") rather than 4, where the gaps would be minor. | 3 / 5 |
Workflow Clarity | A recognizable sequence exists — read company-context.md first, route to the matching /em command, apply the Communication output format and confidence tags — and proactive triggers give explicit entry conditions. But checkpoints are implicit at best: the "Internal Quality Loop" validation is referenced via a missing external file ("see c-level-advisor/skills/agent-protocol/SKILL.md"), sub-command workflows are deferred to nonexistent sibling skills, and no verification step exists inside this file. This is the 3 anchor ("steps listed but validation gaps; sequence present but checkpoints missing or implicit"), not 4, since the actual validating detail is unavailable in the bundle. | 3 / 5 |
Progressive Disclosure | The body is well-sectioned and its references are clearly signaled with one-line descriptions ("references/hard_things.md — Firing, layoffs, pivoting...", "agents/devils-advocate.md — Always finds 3 concerns..."), all one level deep — better signaling than the 3 anchor describes. But scored against the actual bundle structure, none of the referenced files exist: no references/, scripts/, or agents/ directories and no ../challenge/SKILL.md siblings, so every navigation pointer in the file is broken within this bundle. The broken disclosure chain keeps it at 3 (structure present, organization incomplete) rather than 4; it is not 2 because the body itself is well-organized, not an inline dump of misplaced content. | 3 / 5 |
Total | 12 / 20 Passed |