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.
The body is a dense, well-sequenced, actionable planning skill: a numbered workflow with stop-checkpoints, named deterministic scripts with flags, explicit assumptions, anti-patterns, and sharp sibling-skill boundaries. Its main weaknesses are a triple-repeated discipline instruction, canon citations duplicated from the references, an inlined ~90-line forcing-question library, and — most seriously — referenced scripts/references/assets that are absent from the provided bundle, which breaks both the workflow steps and the progressive-disclosure structure.
Suggestions
Ship the referenced bundle files with the skill: scripts/capacity_modeler.py, scripts/utilization_analyzer.py, scripts/hiring_sequencer.py, references/queueing_theory_canon.md, references/ops_workforce_planning_canon.md, references/capacity_anti_patterns.md, and assets/capacity_brief_template.md — none exist in the provided bundle, yet every workflow step depends on them.
Move the ~90-line Forcing-question library to its own reference file (e.g. references/forcing_questions.md) and keep a one-line pointer plus the discipline rule in SKILL.md so the main file reads as an overview.
State the grill discipline once (in the forcing-question library header) instead of three times (Workflow step 5, library header, closing note), and drop the per-question 'Canon' lines that duplicate references/queueing_theory_canon.md and references/ops_workforce_planning_canon.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and fragment-style ('Stdlib only', bare numeric thresholds, no basic-concept padding), matching 'efficient; minor instances of over-explanation that could be trimmed'. The discipline instruction 'One question at a time. Do not skip ahead. Answers must be written down' is repeated three times (Workflow step 5, the library header, and the closing note), and 'Why it's the first question' re-explains Goldratt's single-binding-constraint idea Claude already knows; per-question 'Canon' citations also duplicate references/queueing_theory_canon.md. Not 5 because of that repetition and the Goldratt/Frei re-explanation; not 3 because there is no broad explanatory padding of known concepts. | 4 / 5 |
Actionability | Concrete, mostly executable guidance: a copy-paste quick example ('cd business-operations/skills/capacity-planner && python3 scripts/capacity_modeler.py --sample'), named scripts with flags ('--profile', '--input <path> (JSON)', '--output {markdown,json}', '--sample', '--help'), and specific thresholds ('Anyone >85% sustained', 'span of control crosses 7 ICs/manager', 'front-load hires (Q1 35%, Q4 15%)'). Scored 4 rather than 5 because no real-parameter invocation is shown inline — running with actual demand/AHT/SLA inputs relies on --help/--sample and the absent assets/capacity_brief_template.md. | 4 / 5 |
Workflow Clarity | A five-step numbered workflow with an explicit early stop-checkpoint ('If you only have averages, stop and pull the distribution'), risk flagging ('Anyone >85% sustained is a throughput-collapse risk', 'Spread >30 percentage points ... means UNBALANCED'), and the forcing-question walk acting as a validation checklist with threshold-based verdicts ('If P(breach at P90) > 10% you are understaffed at the sizing point'). This is sizing math, not a destructive/batch operation, so the validation cap does not apply; sequence, checkpoints, and a written-answer gate before committing the plan match the anchor-5 example. | 5 / 5 |
Progressive Disclosure | In-body organization is well-signaled — dedicated Scripts, References, and Assets sections, one level deep, each annotated with scope ('Erlang-C sizing with shrinkage adjustment', 'The math', '20-minute fill-out template'). However, none of the seven referenced bundle files exist in the provided bundle (scripts/capacity_modeler.py, scripts/utilization_analyzer.py, scripts/hiring_sequencer.py, references/queueing_theory_canon.md, references/ops_workforce_planning_canon.md, references/capacity_anti_patterns.md, assets/capacity_brief_template.md), so the deep content cannot actually be reached, and the ~90-line Forcing-question library is inlined in SKILL.md rather than split into a reference. Better organized than anchor 3's 'references not clearly signaled', but dangling references and inlined reference-grade content keep it below anchor 4's 'appropriately placed' and anchor 5's 'easy navigation'. | 3 / 5 |
Total | 16 / 20 Passed |