Content
78%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 highly actionable with a clear sequenced workflow and exemplary progressive disclosure via real bundle files. Its main weakness is conciseness: core rules are reinforced across three sections, producing noticeable token redundancy.
Suggestions
Consolidate the 70/30 blend, CoV thresholds, cohort-leak timing, and assumption-block-is-theatre rules into a single canonical section; have the Anti-patterns and Forcing-question library reference it instead of restating it.
Add an explicit validation/verification checkpoint between workflow steps (e.g., "review the leaky-cohort callout and CoV bands before assembling the deck") to close the validate-fix-retry loop.
Consider extracting the seven-question grilling library into a `references/grill_questions.md` file so the main SKILL.md stays a lean overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and free of basic-concept padding, but the same handful of principles — the 70/30 blend, CoV thresholds, cohort-leak-surfaces-in-2-3-quarters, and the "assumption block is theatre" rule — are restated across the Assumptions, Anti-patterns, and Forcing-question library sections, which could be tightened. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands with complete flags — `scripts/bookings_forecaster.py --input intake.json --profile saas --output markdown` and the parallel invocations for the other two scripts — plus a concrete intake step and noted `--help`/`--sample` affordances. | 5 / 5 |
Workflow Clarity | A clearly numbered Step 1–5 sequence with concrete per-step commands, built-in guardrails ("The CLI refuses to omit the assumption block") and a grilling gate ("Lock 1-3 before opening 4-7"); verification exists via script-emitted flags and callouts but an explicit validate-fix-retry checkpoint loop is absent. | 4 / 5 |
Progressive Disclosure | Clear overview body pointing to a well-signaled, one-level-deep bundle: dedicated `## Scripts` and `## References` sections list the real `scripts/*.py`, `references/*.md`, and `assets/forecast_intake_template.md` files with one-line descriptions, all verified present on disk. | 5 / 5 |
Total | 17 / 20 Passed |