Content
52%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 with genuinely useful strategic judgment (breakeven heuristics, role distinctions, tier tables) and clearly sequenced workflows. Its two real defects are the missing bundle — every referenced script and reference file is absent, making the calculators and deep-dives unusable as shipped — and underspecified JSON input formats that leave the runnable commands un-executable.
Suggestions
Ship the bundle: include the three scripts (model_buildvsbuy_calculator.py, ai_risk_classifier.py, ai_cost_economics.py) and four reference files referenced throughout, or strip the dangling pointers so SKILL.md is self-contained.
Add a concrete example use_case.json and workload.json (or a schema) so the calculator commands are copy-paste executable instead of the parenthetical field hints.
Trim the ~60-item Keywords section (it duplicates the description's triggers) and move perishable 2026 pricing/regulation specifics into the dated references with a snapshot date, keeping the body evergreen.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — dense tables (EU AI Act tiers, stage-to-role map) carry judgment Claude doesn't reliably hold. But the ~60-item Keywords section duplicates the description's trigger list with no operational value, and time-stamped specifics ("Frontier models 2026: Claude Sonnet 4.6 ~$3/$15 per M tokens", dated regulation status) will go stale without being quarantined in a dated/old-patterns section. Not 4: the keyword dump and perishable pricing are real trimming targets, not minor instances. | 3 / 5 |
Actionability | Quick Start and Workflows give concrete runnable commands ("python scripts/model_buildvsbuy_calculator.py path/to/use_case.json"), but the input format is underspecified — "Define use_case.json (volume, latency, accuracy, team size, budget)" is a field hint, not a schema or example — and none of the three referenced scripts exist in the bundle, so the commands cannot actually be executed as shipped. This is concrete-but-incomplete guidance with missing key details, matching anchor 3 rather than 4. | 3 / 5 |
Workflow Clarity | All four workflows have goals, durations, numbered steps, concrete commands, cross-checks with other advisor skills, and decision-logging steps — a clear sequence. Not 5: checkpoints are advisory cross-checks rather than explicit validation of tool output (e.g., no sanity-check step on the TCO or breakeven numbers the calculators emit). Not 3: these are non-destructive advisory workflows, so the validation cap doesn't apply, and most checkpoints are present. | 4 / 5 |
Progressive Disclosure | On paper the structure is good — clearly signaled, one-level-deep references ("See references/model_buildvsbuy_strategy.md for full decision tree") — but scoring against the actual bundle, no references/, scripts/, or assets/ directory exists: all four referenced .md files and all three referenced .py scripts are dangling paths. Navigation dead-ends at every pointer, so the promised deep content simply isn't there and the skill is effectively an unbacked monolith. This matches anchor 2's broken-structure level rather than 3, since the disclosure chain, not just signaling, is the problem. | 2 / 5 |
Total | 12 / 20 Passed |