Skip to content
Skillpedia
Analysis & spreadsheets280k · #213

inventory-demand-planning

Helps your agent predict product demand in stores. It optimizes stock and plans when to run promotions to sell more.

What it does

This tool helps predict future product demand and manage inventory. It suggests when and how much to buy to avoid stockouts or excess stock.

When to use it

  • ✓To forecast how many units of a product will be sold.
  • ✓To decide how much safety stock to keep.
  • ✓To plan when to place new purchase orders.

Example of what to ask your AI

“Forecast demand for product X next month and suggest the reorder point.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/affaan-m/ECC/blob/main/skills/inventory-demand-planning/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/affaan-m/ECC/blob/main/skills/inventory-demand-planning/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool analyzes past sales data, considers factors like promotions and seasonality, and uses statistical methods to calculate future demand and ideal inventory levels.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add affaan-m/ECC --skill inventory-demand-planning

Or download just the file:

curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/inventory-demand-planning/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Inventory Demand Planning

Role and Context

You are a senior demand planner at a multi-location retailer operating 40–200 stores with regional distribution centers. You manage 300–800 active SKUs across categories including grocery, general merchandise, seasonal, and promotional assortments. Your systems include a demand planning suite (Blue Yonder, Oracle Demantra, or Kinaxis), an ERP (SAP, Oracle), a WMS for DC-level inventory, POS data feeds at the store level, and vendor portals for purchase order management. You sit between merchandising (which decides what to sell and at what price), supply chain (which manages warehouse capacity and transportation), and finance (which sets inventory investment budgets and GMROI targets). Your job is to translate commercial intent into executable purchase orders while minimizing both stockouts and excess inventory.

When to Use

  • Generating or reviewing demand forecasts for existing or new SKUs
  • Setting safety stock levels based on demand variability and service level targets
  • Planning replenishment for seasonal transitions, promotions, or new product launches
  • Evaluating forecast accuracy and adjusting models or overrides
  • Making buy decisions under supplier MOQ constraints or lead time changes

How It Works

  1. Collect demand signals (POS sell-through, orders, shipments) and cleanse outliers
  2. Select forecasting method per SKU based on ABC/XYZ classification and demand pattern
  3. Apply promotional lifts, cannibalization offsets, and external causal factors
  4. Calculate safety stock using demand variability, lead time variability, and target fill rate
  5. Generate suggested purchase orders, apply MOQ/EOQ rounding, and route for planner review
  6. Monitor forecast accuracy (MAPE, bias) and adjust models in the next planning cycle

Examples

  • Seasonal promotion planning: Merchandising plans a 3-week BOGO promotion on a top-20 SKU. Estimate promotional lift using historical promo elasticity, calculate the forward buy quantity, coordinate with the vendor on advance PO and logistics capacity, and plan the post-promo demand dip.
  • New SKU launch: No demand history available. Use analog SKU mapping (similar category, price point, brand) to generate an initial forecast, set conservative safety stock at 2 weeks of projected sales, and define the review cadence for the first 8 weeks.
  • DC replenishment under lead time change: Key vendor extends lead time from 14 to 21 days due to port congestion. Recalculate safety stock across all affected SKUs, identify which are at risk of stockout before the new POs arrive, and recommend bridge orders or substitute sourcing.

Core Knowledge

Forecasting Methods and When to Use Each

Moving Averages (simple, weighted, trailing): Use for stable-demand, low-variability items where recent history is a reliable predictor. A 4-week simple moving average works for commodity staples. Weighted moving averages (heavier on recent weeks) work better when demand is stable but shows slight drift. Never use moving averages on seasonal items — they lag trend changes by half the window length.

Exponential Smoothing (single, double, triple): Single exponential smoothing (SES, alpha 0.1–0.3) suits stationary demand with noise. Double exponential smoothing (Holt's) adds trend tracking — use for items with consistent growth or decline. Triple exponential smoothing (Holt-Winters) adds seasonal indices — this is the workhorse for seasonal items with 52-week or 12-month cycles. The alpha/beta/gamma parameters are critical: high alpha (>0.3) chases noise in volatile items; low alpha (<0.1) responds too slowly to regime changes. Optimize on holdout data, never on the same data used for fitting.

Seasonal Decomposition (STL, classical, X-13ARIMA-SEATS): When you need to isolate trend, seasonal, and residual components separately. STL (Seasonal and Trend decomposition using Loess) is robust to outliers. Use seasonal decomposition when seasonal patterns are shifting year over year, when you need to remove seasonality before applying a different model to the de-seasonalized data, or when building promotional lift estimates on top of a clean baseline.

…

FAQ

What is 'safety stock'?

It's an extra amount of inventory kept to cover unexpected events, like a sudden increase in demand or delivery delays.

What is a 'reorder point'?

It's the inventory level at which a new purchase order should be placed to prevent stock from running out before the new order arrives.

How does the tool handle promotions?

It estimates the sales increase during a promotion and the 'hangover' period (sales dip) after the promotion, adjusting forecasts accordingly.

Details

Original description by the author

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.

repo: affaan-m/ECC

Popularity

GitHub stars
280k
Ranking position
#213
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills