Free agents + LAUNCH30: 30% off paid agents until 31 Dec 2026 (one-time purchases only) See free agents
Oarsman AI Sign in

Inventory Reorder Planner Pro / Docs

Inventory Reorder Planner Pro: setup guide

A reorder plan for every SKU: safety stock, reorder point, days of cover and order quantity rounded to MOQ and packs, with purchase-order drafts per supplier and slow and dead stock flagged.

Who it is for: Owners and operations staff at small shops and D2C brands who reorder stock from suppliers by feel or a spreadsheet.

Format: Claude skill pack · Version: 1.0.0 · Tested on: Python 3.13.5 (standard library only)

What it does

It totals sales per SKU per day over the history window (days with no sales count as zero), then takes the average and standard deviation. Safety stock is z × deviation × √lead time and the reorder point is average × lead time + safety stock. When stock on hand plus on order is at or below the reorder point it orders enough for the lead time plus your cover days, raised to the MOQ and rounded up to whole packs, and groups the lines into one purchase order draft per supplier.

What you need

  • Claude.ai with code execution switched on (or Claude Code, or just Python 3.10+)
  • A sales export and a stock list

5-minute setup

  1. Claude.ai: open Settings → Capabilities → Skills, click Upload skill and pick claude-ai-upload/inventory-reorder-planner-pro.zip.
  2. Claude Code: copy the folder skills/inventory-reorder-planner-pro into ~/.claude/skills/.
  3. Start a new chat. Attach your file and say: "Use inventory-reorder-planner-pro. Here are 90 days of sales and my stock list; what should I order this week at a 97.5% service level?".
  4. Claude runs the script and gives you the files listed under Outputs. Check them before you act on them.

Try it with the sample

Run the sample (fictional shop, 30 days of sales):

python3 skills/inventory-reorder-planner-pro/scripts/core.py samples/sales.csv samples/stock.csv --out out

You should see 1 SKU to order now (MUG-01: 72 units after the MOQ and packs of 12, cost 324.00), 1 stock-out risk, 1 SKU with no sales and 1 SKU sold but not in the stock list.

Settings you can change

Option Default What it is
sales, stock (required) Sales export and stock list
--service 95 Service level: 80, 85, 90, 95, 97.5, 98 or 99
--cover 30 Days of stock to buy beyond the lead time
--lead 14 Lead time for SKUs without one
--days (all) Use only the last N days of sales
--us-dates off Read 03/04/2026 as March 4
--out out Output folder

What goes in and what comes out

Inputs: Sales export with date, SKU and quantity; Stock list with SKU and on hand (lead time, supplier, cost, MOQ and pack size optional)

Outputs: reorder-plan.csv; po-.csv purchase order drafts; report.md

AI disclosure and limits

This product does not call an AI model at run time. It was built by Oarsman AI's AI agents and checked by the automated tests shipped with it.

Limits: - Assumes the history window is typical; promotions and seasons skew the average. - One stock location per SKU. - Lead times are taken as fixed.

Not tested by us: - Seasonal or promotion-driven demand (the plan assumes the history window is typical) - Multi-location stock - XLSX inputs in the shipped tests (CSV only)

Files

  • oarsman-inventory-reorder-planner-pro-v1.0.0.zip
  • CHANGELOG.md
  • QA-REPORT.json
  • README.md
  • SPEC.md
  • SUPPORT.md
  • TROUBLESHOOTING.md
  • VERSION
  • VIDEO-SCRIPT.md
  • claude-ai-upload
  • diagram.mmd
  • diagram.png
  • preview.png
  • samples
  • skills
  • tests

Help

Self-serve: see TROUBLESHOOTING.md (fixes and FAQ). There is no call, chat or email support. Fixes ship as new versions at your download link. Refund: 14 days, works as described, through the checkout platform.