CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

inventory-demand-planning

Codified expertise for demand forecasting, safety stock optimisation, replenishment planning, and promotional lift estimation at multi-location retailers.

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/inventory-demand-planning/SKILL.md

The canonical home for this skill is inventory-demand-planning in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 strong, highly actionable expertise skill: nearly every section converts domain knowledge into specific formulas, thresholds, and situation-to-action tables, and the reference bundle is properly tiered with real, clearly signaled one-level-deep files. The main improvement opportunities are trimming textbook explanations of standard forecasting/inventory theory Claude already knows and removing the duplicated When to Use section.

Suggestions

Cut or compress the textbook scaffolding in Core Knowledge — Holt/Holt-Winters mechanics, STL descriptions, MAPE/WMAPE definitions, EOQ and ABC basics — keeping only the retail-specific calibrations (parameter ranges, thresholds, typical lift/dip magnitudes) that Claude would not know.

Remove the duplicate closing "When to Use" section (or merge it into the opening one) to eliminate redundancy and sharpen the top-level trigger guidance.

DimensionReasoningScore

Conciseness

The body is dense with genuine practitioner calibration Claude would not know (lift ranges 15–40% for TPR, post-promo dip at 30–50% of lift, markdown delay costing 3–5 margin points), but the Core Knowledge section spends many lines explaining textbook concepts Claude already knows — Holt/Holt-Winters mechanics, STL, MAPE/WMAPE definitions, the EOQ formula and ABC analysis basics — and the "When to Use" section appears twice (opening and closing) with overlapping content. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than the noticeably-verbose anchor 2, because the standard theory is consistently interwoven with non-obvious retail-specific guidance.

3 / 5

Actionability

For an instruction-only skill the guidance is fully decision-ready: exact formulas (`SS = Z × σ_d × √(LT + RP)`, `EOQ = √(2DS/H)`, IP definition), concrete thresholds (tracking signal ±4, bias ±5%, WMAPE <25%), situation-to-action decision tables for method selection, service levels, and markdown timing, and specific escalation timelines. Specific examples cover the common cases directly. Not a 4 because there are no meaningful gaps — every framework maps a condition to an executable action with numbers attached.

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with checkpoints: the method-selection table pairs each demand pattern with a review trigger (e.g., "Tracking signal exceeds ±4"), the slow-mover kill decision is an ordered flag→markdown→escalate→hard-exit-date sequence, and the escalation tables give trigger/action/timeline triplets that function as validation checkpoints. It is not a 5 because these are parallel frameworks rather than one workflow with explicit validate→fix→retry feedback loops, and steps like the markdown decision rely on the planner to sequence monitoring without stated cadence in a few places.

4 / 5

Progressive Disclosure

The bundle is well structured: SKILL.md holds summaries with three real, one-level-deep references — edge-cases.md, communication-templates.md, decision-frameworks.md (all verified to exist with substantive content) — each clearly signaled inline ("Full analysis in [edge-cases.md]") and again in the Additional Resources section with purpose statements. It falls short of a 5 due to minor organization gaps: the Core Knowledge and Decision Frameworks sections run ~150 lines of detailed inline content that partially overlaps what decision-frameworks.md exists to hold, and the duplicated "When to Use" sections create a small navigation wrinkle.

4 / 5

Total

16

/

20

Passed

Description

66%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 specific, well-targeted description that names four concrete capability domains with strong natural trigger terms and a clear retail planning niche. Its main weakness is the complete absence of a 'when to use' clause, which caps completeness; a single appended sentence of trigger conditions would move it substantially.

Suggestions

Append an explicit trigger clause, e.g. "Use when forecasting product demand, calculating safety stock or reorder points, planning replenishment cycles, estimating promotional lift and post-promo dips, or performing ABC/XYZ inventory segmentation."

Convert capability nouns into actions and add missing coverage: "Forecast demand, calculate safety stock and reorder points, plan replenishment and promotions, classify inventory (ABC/XYZ)."

Add natural synonyms users would say — "inventory planning", "demand planning", "stockouts", "purchase orders" — to widen trigger coverage without adding length.

DimensionReasoningScore

Specificity

The description lists several specific capabilities — "demand forecasting, safety stock optimisation, replenishment planning, and promotional lift estimation" — with minor gaps (e.g., ABC/XYZ segmentation and markdown planning from the body are absent). It stops short of a 5 because these are noun-phrase domains under "Codified expertise for" rather than concrete actions like 'compute safety stock' or 'estimate promotional lift', and it is not a comprehensive coverage of what the skill actually does.

4 / 5

Completeness

It has a clear 'what' (codified expertise for four named planning domains) but no 'when' at all — there is no "Use when..." clause or equivalent explicit trigger guidance in the description, which per the judging guidelines caps completeness at 3. It is not a 4 because 'when' is entirely absent rather than merely imprecise; the 'When to Use' sections live in the body, not the description.

3 / 5

Trigger Term Quality

Good keyword coverage of natural phrases a demand planner would actually say: "demand forecasting", "safety stock", "replenishment planning", "promotional lift". Not a 5 because common synonyms users might use are missing — e.g., "inventory planning", "demand planning", "stockouts", "purchase orders", "inventory optimization" — while anchor-5 examples include full synonym sets.

4 / 5

Distinctiveness Conflict Risk

The niche is well carved — the combination of "safety stock optimisation, replenishment planning, and promotional lift estimation at multi-location retailers" is clearly distinct from generic skills. Minor overlap risk remains with closely related general forecasting or supply-chain skills via the leading broad term "demand forecasting"; it is a clear niche but not the minimal-conflict anchor-5 case.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/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.