forecast-accuracy-review

Evaluates demand forecast quality using WMAPE, bias, and Forecast Value Added against naive benchmarks.

30.5k|3.5k|Updated Jul 4, 2025
One-click install
npx skills add https://github.com/davila7/claude-code-templates --skill forecast-accuracy-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forecast-accuracy-review
Source: https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/operations/forecast-accuracy-review
Command: npx skills add https://github.com/davila7/claude-code-templates --skill forecast-accuracy-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Demand planners often cannot tell whether their forecasting process actually beats the free alternative of shipping last period's number. This Skill audits forecast accuracy honestly, exposing processes that destroy value despite looking good on blended metrics.

Core Features & Use Cases

  • Rolling-Origin Backtesting: Runs one-step-ahead forecasts over 6+ periods with expanding windows instead of relying on a single train/test split.
  • Honest Metrics: Computes WMAPE, bias, and a footnoted MAPE, with explicit handling of zero-actual periods and demand-pattern segmentation (smooth, erratic, intermittent, lumpy).
  • FVA Verdict: Quantifies Forecast Value Added as WMAPE(naive) minus WMAPE(candidate) per segment and overall, plainly stating when a process destroys value.
  • Use Case: A supply chain analyst suspects the new forecasting tool is not helping. Provide per-SKU demand history and forecast values, and receive a scoreboard showing the tool adds only 1 point of WMAPE improvement overall while destroying value on intermittent SKUs.

Quick Start

Evaluate the forecast accuracy of my demand planning process using the attached SKU-level sales history and forecast files, and tell me whether it beats a naive baseline.

Frequently Asked Questions about forecast-accuracy-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I measure forecast accuracy for demand planning?

Measure forecast accuracy with WMAPE (sum of absolute errors divided by sum of actuals) as the volume-weighted headline metric, plus bias to detect systematic over- or under-forecasting. Always compare against a naive last-period baseline using a rolling-origin backtest rather than a single train/test split.

What is Forecast Value Added and how is it calculated?

Forecast Value Added (FVA) equals WMAPE of the naive benchmark minus WMAPE of the candidate forecast, computed per segment and overall. A negative FVA means the forecasting process performs worse than simply shipping last period's number and is destroying value.

Why is MAPE misleading for intermittent demand?

MAPE is undefined on zero-actual periods, so silently dropping those periods fakes precision on intermittent SKUs. It is also asymmetric, capping under-forecast errors at 100% while over-forecast errors are unbounded, which rewards systematic under-forecasting.

How much demand history is needed for a forecast backtest?

At least 18 periods per SKU are needed for a meaningful rolling-origin backtest, with one-step-ahead forecasts over the last 6 or more periods using an expanding window. SKUs with less history should be flagged rather than scored.

When should I stop trying to improve a forecast model?

When WMAPE exceeds roughly 100% on lumpy demand segments, the honest recommendation is an inventory-policy answer such as safety buffers or make-to-order, not a better model. Forecasting cannot fix structurally unpredictable demand.