CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

84%

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

71%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.

This is a high-quality domain knowledge skill: the decision frameworks, numeric thresholds, and edge cases are concrete and directly actionable, and the core workflow is clearly sequenced with review triggers and a monitor-and-adjust loop. The two weaknesses are token efficiency (textbook method/metric explanations that Claude already knows dilute the retail-specific heuristics) and structure (everything inlined in one long SKILL.md rather than splitting edge cases and reference tables into one-level-deep files).

Suggestions

Trim the educational primers (SES/Holt/Holt-Winters definitions, MAPE/bias definitions, the EOQ and textbook safety-stock derivations) down to just the retail-specific parameters, thresholds, and pitfalls — Claude already knows the textbook material.

Move the Key Edge Cases, Communication Patterns templates, and Escalation/KPI tables into separate reference files (e.g., references/edge-cases.md, references/escalation.md) and link them from SKILL.md, keeping the core method-selection and safety-stock frameworks inline.

Make the feedback loop explicit as a gated step: e.g., 'Only proceed to PO generation when holdout WMAPE is below the segment threshold; otherwise re-select the method per the fallback column'.

DimensionReasoningScore

Conciseness

The body mixes genuinely valuable codified heuristics (WMAPE thresholds, tracking-signal ±4 trigger, lift ranges, markdown timing rules) with textbook explanations Claude already knows, e.g. 'Single exponential smoothing (SES, alpha 0.1–0.3) suits stationary demand with noise', the standard 'SS = Z × σ_d × √(LT + RP)' derivation, 'EOQ = √(2DS/H)', and a definition of MAPE/Bias. It is mostly efficient but several definitional passages (forecasting-method primers, metric definitions, reorder-logic basics) could be trimmed to just the retail-specific thresholds and rules of thumb, matching the 'mostly efficient but includes some unnecessary explanation' anchor rather than the lean 4–5 anchors.

3 / 5

Actionability

As an instruction-only knowledge skill, the guidance is fully actionable: exact numeric triggers ('WMAPE > 25% for 4 consecutive weeks', 'tracking signal exceeds ±4', 'markdown when sell-through drops below 60% of plan'), concrete formulas inline, a complete method-selection table with primary/fallback methods and review triggers, a service-level matrix with Z-scores, and a 5-step promotional lift decision framework with a default dip profile ('40% of incremental lift, concentrated 60/30/10'). Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this specific, matching the top anchor.

5 / 5

Workflow Clarity

'How It Works' gives a clear 6-step sequence (collect signals → select method → apply lifts → compute safety stock → generate POs → monitor accuracy and adjust), with a genuine feedback loop in step 6 and per-method 'Review Trigger' columns that define when to re-select a model. It falls short of a 5 because the intermediate checkpoints are implicit rather than explicit validation steps (e.g., no 'verify forecast accuracy before generating POs' gate), matching the 'clear sequence with most checkpoints present; minor validation gaps' anchor. Note this is a planning/advisory skill, not a destructive or batch operation, so the missing-validation cap does not apply.

4 / 5

Progressive Disclosure

The file has good section structure (Core Knowledge, Decision Frameworks, Key Edge Cases, Communication Patterns, Escalation Protocols) with clear headers, so it is not a monolithic wall of text. However, the entire ~240-line knowledge base lives in a single SKILL.md with no references/ or other bundle files, and substantial content that would serve better as separately linked material is inlined — the eight edge cases, the communication templates, and the escalation/KPI tables. The body even notes 'Brief summaries are included here so you can expand them into project-specific playbooks if needed', acknowledging content that belongs at a deeper level. This matches the 'some structure but could be better organized; content that should be separate is inline' anchor.

3 / 5

Total

15

/

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: third-person, specific, and comprehensive on capabilities, with an explicit and well-phrased 'Use when...' trigger clause. The only gap is modest synonym coverage in the trigger terms (e.g., stockouts, SKU, buy plan) that would make retrieval even more robust.

Suggestions

Add one or two common synonyms to the trigger clause, such as 'preventing stockouts' or 'planning buys/open-to-buy', so the description also matches how merchandisers phrase these requests.

DimensionReasoningScore

Specificity

The description lists multiple concrete 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' — giving comprehensive coverage of the skill's actions with domain-specific terminology rather than generic language. It matches the anchor for multiple specific concrete actions with comprehensive coverage; nothing is vague or padded.

5 / 5

Completeness

Both questions are explicitly answered: the 'what' is 'Codified demand planning expertise for multi-location retailers' with an enumerated capability list, and the 'when' is an explicit 'Use when...' clause with five concrete trigger phrases. It clearly matches the top anchor; a 4 would require the 'when' to be less explicit or specific, which is not the case here.

5 / 5

Trigger Term Quality

'Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels' covers natural phrases a demand planner would say. It sits just below a 5 because common variations are missing — e.g., 'stockout', 'SKU', 'buy plan', 'open-to-buy', 'markdown' — so a few natural entry terms rely on the capability list rather than the trigger clause.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — demand planning and inventory optimization for multi-location retailers — with distinct triggers (safety stock, replenishment, promotional lift) that would not plausibly fire for unrelated skills. Overlap risk is limited to at most a near-identical inventory-planning skill, matching the 'clear niche with distinct triggers' 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

Path

skills/inventory-demand-planning/SKILL.md

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.