inventory-demand-planning

Codified expertise for demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation at multi-location retailers. Informed by demand planners with 15+ years experience managing hundreds of SKUs. Includes forecasting method selection, ABC/XYZ analysis, seasonal transition management, and vendor negotiation frameworks. Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/inventory-demand-planning/SKILL.md

The canonical home for this skill is tdg-personal/inventory-demand-planning

Quality

Content

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

A rich, domain-specific knowledge skill with strong actionable decision frameworks, formulas, and tables, plus a clear sequenced workflow with review and feedback checkpoints. It is weakened by verbosity from explaining standard statistical concepts and by a monolithic structure that inlines content which could be split into reference files.

Suggestions

Trim or remove definitional explanations of concepts Claude already knows (e.g., what MAPE/bias/moving averages/exponential smoothing are) and keep only the practitioner-specific thresholds and decision rules.

Split the large reference-like sections (Decision Frameworks, Key Edge Cases, Escalation Protocols, Communication Patterns) into separate files in references/ and link to them one level deep from SKILL.md to improve progressive disclosure.

Add an explicit 'validate forecast before generating POs' checkpoint in the How It Works sequence to strengthen the validation feedback loop for the batch replenishment operation.

Dimension	Reasoning	Score
Conciseness	The 245-line body is mostly efficient practitioner knowledge (Z-scores, policy matrix, lift percentages, markdown timing rules), but it also defines standard statistical concepts Claude already knows (MAPE, bias, moving averages, exponential smoothing, the EOQ formula) and could be tightened.	3 / 5
Actionability	Concrete, usable guidance abounds — explicit safety stock formulas, a forecast-method-by-demand-pattern decision table, markdown timing matrix, slow-mover kill criteria, and escalation triggers with timelines — but some sections (Role and Context, tone calibration) are descriptive rather than directly actionable.	4 / 5
Workflow Clarity	The 'How It Works' section gives a clear 6-step sequence with a planner-review checkpoint (step 5) and a monitor/adjust feedback loop (step 6), and decision tables add explicit review triggers; the batch PO operation does have validation so it is not capped at 3.	4 / 5
Progressive Disclosure	The skill is a monolithic 245-line SKILL.md with no bundle files and no in-skill references; substantial content that could live in separate files (decision frameworks, edge cases, escalation protocols, communication templates) is inlined, though section headers provide reasonable structure.	3 / 5
	Total	14 / 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, specific description that clearly states capabilities and provides an explicit 'Use when' trigger clause for retail inventory demand planning. It is in third person and avoids vague fluff. Minor keyword synonyms could be added for fuller trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions — 'demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation' plus 'forecasting method selection, ABC/XYZ analysis, seasonal transition management, and vendor negotiation frameworks' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	It explicitly answers both 'what' (codified expertise for forecasting, safety stock, replenishment, promo lift) and 'when' with a concrete 'Use when...' trigger clause, matching the 5-anchor pattern.	5 / 5
Trigger Term Quality	The 'Use when forecasting demand, setting safety stock, planning replenishment, managing promotions, or optimizing inventory levels' clause supplies good natural keyword coverage, but a few common planner phrases (stockouts, purchase orders, lead time) are absent.	4 / 5
Distinctiveness Conflict Risk	The retail multi-location demand-planning niche with specific triggers (ABC/XYZ, safety stock, replenishment, promo lift) is clearly distinct from other skills with minimal conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

87%

Warnings & errors only

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

Criteria	Description	Result
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
Commit: 06c5e11

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.