Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, well-structured skill that provides clear decision criteria, executable commands, and a worked example. Its main strengths are the unambiguous two-path decision tree, concrete bash commands, and the explicit confidence-threshold contract with downstream skills. Minor weaknesses include some verbosity in explanatory passages (e.g., why subagents help with context windows) and inline content (seasonal table, promo handling) that could be split into referenced files for better progressive disclosure.
Suggestions
Trim the 'Why a subagent' paragraph — Claude understands context window tradeoffs; a single sentence ('Subagent gets its own context for the ~90-row history') suffices.
Consider moving the seasonal calendar table and promotional handling details into separate referenced files (e.g., SEASONAL.md, PROMO_HANDLING.md) to keep the main skill leaner and improve progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining basic concepts, but some sections are slightly verbose — e.g., the 'Why a subagent' paragraph explains context window management which Claude already understands, and the promotional handling section could be tightened. Overall reasonable but not maximally lean. | 2 / 3 |
Actionability | Provides concrete, executable bash commands for both single-SKU and batch forecasting, specifies exact decision criteria (flags, horizon thresholds), includes a worked example with real JSON output, and gives precise fallback behavior with confidence thresholds. The guidance is copy-paste ready and leaves no ambiguity about what to do. | 3 / 3 |
Workflow Clarity | The two-path decision tree is clearly defined with explicit boolean conditions. Validation is built in via confidence thresholds and the escalation contract (confidence < 0.6 → escalate). The fallback when callable_agents is unavailable includes a specific confidence cap. The worked example demonstrates the full decision chain including the error-recovery path (malformed JSON = error, not guess). | 3 / 3 |
Progressive Disclosure | The skill references external scripts (rolling_mean.py, batch_days_of_cover.py) and another skill (reorder-policy), which is good progressive disclosure. However, no bundle files were provided to verify these references exist, and the content is fairly long (~100 lines) with the seasonal calendar table and promotional handling sections that could potentially be split into referenced files. The structure is reasonable but not optimally layered. | 2 / 3 |
Total | 10 / 12 Passed |