CtrlK
BlogDocsLog inGet started
Tessl Logo

inventory-demand-planning

Codified demand planning expertise for multi-location retailers: demand forecasting method selection, ABC/XYZ segmentation, safety stock and reorder-point optimization, promotional lift and post-promo dip estimation, and seasonal transition and markdown timing. Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels.

69

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews 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, expert-level playbook with genuinely actionable formulas, thresholds, and decision tables, and a clear workflow with monitoring feedback loops. Its main weaknesses are moderate verbosity in restating forecasting-method textbook concepts and a monolithic single-file structure that inlines edge cases and communication templates instead of splitting them into reference files.

Suggestions

Split the 'Key Edge Cases', 'Communication Patterns', and 'Escalation Protocols' sections into one-level-deep reference files (e.g., references/edge-cases.md, references/communication-templates.md) and link them from SKILL.md, turning the 240-line monolith into a navigable overview.

Trim the 'Forecasting Methods and When to Use Each' primers to just the selection guidance (when to use each method and its pitfalls), since Claude already knows what moving averages, Holt-Winters, and STL are — keep only the retail-specific calibration.

Add an explicit validation checkpoint in 'How It Works' between forecast generation and PO routing (e.g., 'verify WMAPE and bias against targets before routing suggested POs') to close the workflow's feedback loop at the decision point.

DimensionReasoningScore

Conciseness

The bulk of the body is high-value domain calibration (Z-scores by segment, 'typical lifts: 15–40% for TPR only... 300–500%+ for doorbuster', 'every week of delay in markdown initiation costs 3–5 percentage points of margin'), but the Forecasting Methods section partially restates textbook knowledge Claude already has (explaining what Holt's and Holt-Winters add, defining MAPE and tracking signal). Most explanations carry a practical caveat that earns their tokens, so this sits at the score-4 anchor ('efficient; minor instances of over-explanation') rather than the score-5 'every token earns its place'.

4 / 5

Actionability

Guidance is fully concrete and executable for an instruction-only skill: explicit formulas ('SS = Z × √(LT_avg × σ_d² + d_avg² × σ_LT²)', 'IP = On-Hand + On-Order − Backorders − Committed'), a demand-pattern method-selection table with fallbacks and review triggers, banded markdown/sell-through decision tables, and timeline-bound escalation triggers. Per the rubric's code_vs_instruction note, the absence of code is not penalized — this matches the score-5 anchor's 'specific examples cover the common cases'.

5 / 5

Workflow Clarity

'How It Works' lays out a clear six-step sequence ending in a monitoring feedback loop (step 6: 'Monitor forecast accuracy (MAPE, bias) and adjust models in the next planning cycle'), and the method-selection table defines explicit review triggers. However, there is no explicit validation checkpoint mid-flow (e.g., verify forecast accuracy before step 5 routes purchase orders), which places it at the score-4 anchor ('most checkpoints present; minor validation gaps') rather than score 5.

4 / 5

Progressive Disclosure

This is a 240-line single-file skill with no bundle files (no references/, scripts/, or assets/ exist). Internal sectioning is good, but content that clearly belongs in separate files — eight edge cases, communication templates, escalation matrices — is fully inlined, and 'Additional Resources' points to nothing concrete ('Pair this skill with your SKU segmentation model...'). This matches the score-3 anchor ('content that should be separate is inline' with some structure) rather than score 4, since references are not merely unclear — there are none.

3 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it clearly and explicitly states both what the skill does and when to use it, with specific, third-person capability statements and a natural trigger clause. The only weakness is that a few natural synonyms (e.g., 'demand planning', 'stockout', 'reorder point', 'markdown') are missing from the trigger list.

DimensionReasoningScore

Specificity

The description enumerates five concrete, distinct capabilities ('demand forecasting method selection, ABC/XYZ segmentation, safety stock and reorder-point optimization, promotional lift and post-promo dip estimation, and seasonal transition and markdown timing') in third-person voice, comprehensively covering the stated domain with no notable gaps.

5 / 5

Completeness

Both questions are answered explicitly: the 'what' via the enumerated capability list and the 'when' via a concrete 'Use when forecasting demand, setting safety stock, planning replenishment...' trigger clause — an exact match to the score-5 anchor.

5 / 5

Trigger Term Quality

'Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels' provides natural phrases users would say, but common synonyms like 'demand planning', 'stockout', 'reorder point', 'markdown', and 'SKU' are absent — good coverage with a few natural terms missing, matching the score-4 anchor rather than the comprehensive score-5 anchor.

4 / 5

Distinctiveness Conflict Risk

'Codified demand planning expertise for multi-location retailers' plus niche terminology (ABC/XYZ segmentation, post-promo dip, markdown timing) establishes a clear niche with distinct triggers; only trivial overlap with a generic forecasting skill, so it sits at the score-5 anchor rather than the score-4 'minor overlap' anchor.

5 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository
affaan-m/ECC
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.