Content
77%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, validation-heavy body: clear 5-step workflow with stop-conditions and a pre-commit question checklist, and an appropriately split bundle (references/assets/scripts all real and matching the documented interfaces). The main costs are token weight — the 'Distinct from' section and repeated canon citations duplicate information — and only one of three scripts having a copy-paste example invocation.
Suggestions
Trim the 'Distinct from' section to two or three lines per sibling skill (or fold it into the references) — it re-states differentiation already carried by the frontmatter description, and cut the repeated per-question 'Canon' lines since the canon is already consolidated in references/.
Add copy-paste example invocations for utilization_analyzer.py and hiring_sequencer.py alongside the existing capacity_modeler.py example, ideally with a minimal --input JSON snippet so users can run all three tools immediately.
Drop the 'cd business-operations/skills/capacity-planner && ' prefix from the quick example — it hard-codes a repo path that may not match where the skill is installed; a plain 'python3 scripts/capacity_modeler.py --sample' from the skill root is more robust.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific facts Claude does not reliably know ("Anyone >85% sustained is a throughput-collapse risk", "Q1 35%, Q4 15%", "span of control crosses 7 ICs/manager"), so it avoids the concept-explanation sin. But it could be tightened: the "Distinct from" section largely re-states the frontmatter differentiation, canon citations repeat across questions (Reinertsen and Hopp & Spearman each cited three times), and the 'one at a time, write answers down' discipline is exhorted three times. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than 'minor instances' (4) or 'several padded sections' (2). | 3 / 5 |
Actionability | The quick example is copy-paste executable ("cd business-operations/skills/capacity-planner && python3 scripts/capacity_modeler.py --sample") and the Scripts section documents concrete flags (--profile, --input, --output, --sample) that verifiably exist in the scripts. However, only one of the three scripts gets a ready-to-run invocation, no example --input JSON is shown inline, and the example's `cd` path assumes a repo location that may not match the installed skill. 'Mostly executable guidance with minor gaps' fits. | 4 / 5 |
Workflow Clarity | The 5-step workflow is clearly sequenced with validation checkpoints: a stop-condition in step 1 ("If you only have averages, stop and pull the distribution"), a diagnostic branch in step 3 ("Spread >30 percentage points across team means UNBALANCED — fix that before hiring"), and the seven-question forcing library is an explicit pre-commit checklist with recommended answers and computed thresholds ("If P(breach at P90) > 10% you are understaffed"). This is an analysis skill, not a destructive/batch one, so the ≤3 validation cap does not apply; the content matches the 'explicit validation steps; feedback loops; checklists' anchor. | 5 / 5 |
Progressive Disclosure | The split is appropriate and verified against the actual bundle: canon material lives one level deep in references/ ("queueing_theory_canon.md … The math", "ops_workforce_planning_canon.md … The people factors"), the fill-out template in assets/, and the anti-patterns are summarized inline as a 'Top eight' with the full taxonomy externalized — all referenced files exist. The forcing-question library inline is the skill's core discipline rather than misplaced detail. Clear overview, well-signaled one-level-deep references, easy navigation. | 5 / 5 |
Total | 17 / 20 Passed |