supply-chain-optimizer
Supply chain analysis, inventory optimization, logistics planning, vendor evaluation, and demand forecasting frameworks. Use when analyzing supply chains, optimizing inventory, or evaluating suppliers.
Best use case
supply-chain-optimizer is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Supply chain analysis, inventory optimization, logistics planning, vendor evaluation, and demand forecasting frameworks. Use when analyzing supply chains, optimizing inventory, or evaluating suppliers.
Teams using supply-chain-optimizer should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/supply-chain-optimizer/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How supply-chain-optimizer Compares
| Feature / Agent | supply-chain-optimizer | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Supply chain analysis, inventory optimization, logistics planning, vendor evaluation, and demand forecasting frameworks. Use when analyzing supply chains, optimizing inventory, or evaluating suppliers.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Supply Chain Optimizer Comprehensive frameworks for supply chain analysis, inventory management, logistics optimization, and vendor evaluation. ## Supply Chain Mapping Template ### End-to-End Supply Chain Map ``` RAW MATERIALS → SUPPLIERS → MANUFACTURING → DISTRIBUTION → CUSTOMER MAPPING STEPS: 1. Identify all nodes (suppliers, plants, warehouses, customers) 2. Map material flows between nodes 3. Map information flows (orders, forecasts, POs) 4. Map financial flows (payments, invoicing) 5. Record lead times at each stage 6. Identify bottlenecks and single points of failure NODE DETAIL TEMPLATE: | Node | Type | Location | Lead Time | Capacity | Utilization | | -------------- | ---------- | --------- | --------- | -------- | ----------- | | | Supplier | | | | | | | Plant | | | | | | | Warehouse | | | | | | | DC | | | | | ``` ## Inventory Optimization ### Economic Order Quantity (EOQ) ``` EOQ = sqrt(2DS / H) Where: D = Annual demand, S = Ordering cost/order, H = Holding cost/unit/year Total Cost = (D/Q)S + (Q/2)H + DC Example: D=10,000, S=$50, H=$5 → EOQ = 447 units, 22.4 orders/year ``` ### Safety Stock & Reorder Point ``` SAFETY STOCK: SS = z x sigma_dLT REORDER POINT: ROP = (Avg Daily Demand x Lead Time) + Safety Stock SERVICE LEVEL FACTORS: | Service Level | z-Score | Use Case | | ------------- | ------- | ----------------- | | 90.0% | 1.28 | Basic coverage | | 95.0% | 1.65 | Standard | | 99.0% | 2.33 | High service | | 99.9% | 3.09 | Critical items | ``` ### Inventory KPI Dashboard | Metric | Formula | Target | | --------------------- | ---------------------------------------- | --------------- | | Inventory Turns | COGS / Average Inventory | Industry-specific | | Days of Supply | Average Inventory / (COGS / 365) | Minimize | | Fill Rate | Orders Filled Complete / Total Orders | 97%+ | | Stockout Rate | Stockout Events / Total Demand Events | < 2% | | Carrying Cost % | Holding Costs / Average Inventory Value | 15-30% | | Dead Stock % | No-movement Items / Total SKUs | < 5% | | Inventory Accuracy | Correct Counts / Total Counts | 99%+ | | GMROI | Gross Margin / Average Inventory Cost | > 2.0 | ## ABC-XYZ Analysis Framework ``` ABC CLASSIFICATION (Value): A Items: Top 20% of SKUs = ~80% of annual consumption value → Tight control, frequent review, accurate forecasts B Items: Next 30% of SKUs = ~15% of value → Moderate control, periodic review C Items: Bottom 50% of SKUs = ~5% of value → Minimal control, simple replenishment rules XYZ CLASSIFICATION (Demand Variability): X: Coefficient of Variation < 0.5 → Stable, predictable demand Y: CV between 0.5 and 1.0 → Some variation, trend/seasonal Z: CV > 1.0 → Highly irregular, sporadic demand COMBINED MATRIX: | Class | AX | AY | AZ | | ----- | ---------- | ------------ | ------------- | | Strat | JIT/Kanban | Forecast | Order on demand| | Class | BX | BY | BZ | | Strat | Reorder pt | Buffer stock | Min/Max | | Class | CX | CY | CZ | | Strat | Bulk buy | Periodic rev | Eliminate? | ``` ## Vendor Scorecard ### Supplier Evaluation Matrix | Criteria | Weight | Score (1-5) | Weighted Score | Notes | | ------------------ | ------ | ----------- | -------------- | ----- | | Quality (PPM) | 25% | | | | | Delivery (OTIF) | 20% | | | | | Pricing | 20% | | | | | Responsiveness | 10% | | | | | Financial Health | 10% | | | | | Innovation | 5% | | | | | Sustainability | 5% | | | | | Risk Profile | 5% | | | | | **Total** | 100% | | **__ / 5.0** | | ``` RATING SCALE: 4.5-5.0 Strategic Partner — expand relationship 3.5-4.4 Preferred Supplier — maintain, develop 2.5-3.4 Approved Supplier — improvement plan required < 2.5 Probation / Exit — find alternative ``` ### Supplier Performance Tracking | KPI | Target | Q1 Actual | Q2 Actual | Q3 Actual | Q4 Actual | Trend | | ------------------- | ------- | --------- | --------- | --------- | --------- | ----- | | On-Time Delivery | 98%+ | | | | | | | Quality (PPM) | < 500 | | | | | | | Lead Time (days) | | | | | | | | Price Variance | +/- 2% | | | | | | | Response Time (hrs) | < 24 | | | | | | | Corrective Actions | < 2/qtr | | | | | | ## Total Cost of Ownership (TCO) ``` TCO = Acquisition Costs + Operating Costs + Disposal Costs ACQUISITION COSTS: Purchase price + Shipping / freight + Customs / duties / tariffs + Procurement labor + Quality inspection + Supplier qualification = Total Acquisition OPERATING COSTS (over useful life): Maintenance & repair + Inventory carrying cost + Warranty claims + Downtime cost (if component fails) + Training / support + Quality failures (scrap, rework) = Total Operating DISPOSAL COSTS: Decommissioning + Recycling / disposal fees + Environmental compliance = Total Disposal TCO = Total Acquisition + Total Operating + Total Disposal ``` ### TCO Comparison Template | Cost Element | Supplier A | Supplier B | Supplier C | | -------------------- | ---------- | ---------- | ---------- | | Unit Price | | | | | Shipping | | | | | Duties / Tariffs | | | | | Quality Cost (est.) | | | | | Inventory Carry Cost | | | | | Lead Time Cost | | | | | Risk Premium | | | | | **Total TCO/Unit** | | | | | **Annual TCO** | | | | ## Demand Forecasting Methods | Method | Best For | Horizon | Data Required | | ------------------- | -------------------------- | ------------ | --------------------- | | Moving Average | Stable demand | Short-term | 3-12 periods history | | Exponential Smooth | Trend detection | Short-term | Recent weighted data | | Holt-Winters | Seasonal patterns | Medium-term | 2+ years seasonal | | Linear Regression | Trend with causal factors | Medium-term | Demand + drivers | | ARIMA | Complex time series | Short-medium | 50+ data points | | Machine Learning | Multi-variable patterns | Any | Large datasets | | Delphi / Expert | New products, disruptions | Long-term | Expert panel | ### Forecast Accuracy Metrics ``` MAD (Mean Absolute Deviation): MAD = (1/n) x SUM(|Actual - Forecast|) MAPE (Mean Absolute Percentage Error): MAPE = (1/n) x SUM(|Actual - Forecast| / Actual) x 100 BIAS (Tracking Signal): Bias = SUM(Actual - Forecast) / MAD Target: Between -4 and +4 ACCURACY BENCHMARKS: | Forecast Horizon | Good MAPE | Acceptable MAPE | | ---------------- | --------- | --------------- | | 1 month | < 15% | < 25% | | 3 months | < 25% | < 35% | | 6 months | < 30% | < 45% | | 12 months | < 35% | < 50% | ``` ## Logistics Optimization ### Transportation Mode Selection | Mode | Cost/Unit | Speed | Capacity | Best For | | -------- | --------- | --------- | --------- | ----------------------------- | | Truck | Medium | Fast | Medium | Regional, door-to-door | | Rail | Low | Slow | Very High | Bulk, long-distance domestic | | Ocean | Very Low | Very Slow | Very High | International, bulk cargo | | Air | Very High | Very Fast | Low | High-value, urgent, perishable| | Intermodal | Low-Med | Medium | High | Long-distance, cost-effective | ### Warehouse Layout Optimization ``` SLOTTING STRATEGY: Fast movers (A items) → Near shipping dock, prime pick locations Medium movers (B items) → Middle zones Slow movers (C items) → High racks, far locations LAYOUT PRINCIPLES: 1. Minimize travel distance for highest-velocity items 2. Group items frequently ordered together 3. Separate receiving and shipping areas 4. Reserve staging areas for cross-docking 5. Maintain clear aisle widths for equipment ``` ## Lead Time Analysis ``` TOTAL LEAD TIME: Order Processing Time + Supplier Manufacturing Time + Transportation Time + Receiving / Inspection Time + Internal Processing Time = Total Lead Time LEAD TIME VARIABILITY: Track actual vs. quoted lead times over 12+ orders Calculate standard deviation Use for safety stock calculations LEAD TIME REDUCTION STRATEGIES: | Strategy | Typical Reduction | Effort | | --------------------- | ----------------- | --------- | | Vendor-managed inv. | 30-50% | Medium | | Local sourcing | 40-70% | High | | Process automation | 10-30% | Medium | | Blanket POs | 20-40% | Low | | Consignment stock | 50-80% | Medium | | 3PL consolidation | 10-25% | Low | ``` ## Supply Chain Risk Assessment ### Risk Identification Matrix | Risk Category | Risk Event | Likelihood | Impact | Score | Mitigation | | ---------------- | ----------------------- | ---------- | ------ | ----- | ---------------------- | | Supply | Single-source failure | | | | Dual-source | | Demand | Demand spike/collapse | | | | Buffer stock, flex | | Logistics | Port congestion | | | | Alternate routes | | Geopolitical | Tariffs, sanctions | | | | Nearshoring | | Natural Disaster | Earthquake, flood | | | | Geographic diversity | | Cyber | System breach | | | | Security protocols | | Quality | Batch failure | | | | Inspection, redundancy | | Financial | Supplier bankruptcy | | | | Financial monitoring | ``` RISK SCORING: Likelihood: 1 (Rare) to 5 (Almost Certain) Impact: 1 (Negligible) to 5 (Catastrophic) Risk Score = Likelihood x Impact ACTION THRESHOLDS: 20-25 Critical — immediate action, executive attention 12-19 High — mitigation plan required within 30 days 6-11 Medium — monitor quarterly, contingency plans 1-5 Low — accept or monitor annually ``` ## KPI Dashboard Template | Category | KPI | Target | | ---------- | ------------------------ | --------------- | | Cost | SC Cost as % of Revenue | 5-10% | | Cost | Cost per Order | Minimize | | Service | Perfect Order Rate | 95%+ | | Service | On-Time In-Full (OTIF) | 98%+ | | Service | Customer Fill Rate | 97%+ | | Efficiency | Inventory Turns | Industry-specific| | Efficiency | Cash-to-Cash Cycle | Minimize | | Efficiency | Warehouse Utilization | 85% | | Efficiency | Forecast Accuracy (MAPE) | < 20% | ## See Also - [Operations](../operations/SKILL.md) - [Finance](../finance/SKILL.md) - [Risk Management](../risk-management/SKILL.md)
Related Skills
blockchain-web3
Solidity smart contracts, Web3 development, DeFi protocols, NFTs, EVM chains, Hardhat/Foundry tooling, and blockchain security. Use when writing smart contracts, building dApps, auditing contract security, or integrating Web3 wallets.
example-skill
Example skill - replace with your skill's description and activation keywords
websockets-realtime
Real-time communication with WebSockets, Server-Sent Events, and related technologies. Use when building chat, live updates, collaborative features, or any real-time functionality.
video-production
Professional video production from planning to delivery. Use when creating video content, editing workflows, motion graphics, or optimizing video for different platforms.
ui-research
Research-first UI/UX design workflow. Use BEFORE any frontend visual work to research modern patterns, gather inspiration from real products, and avoid generic AI-generated looks. Mandatory prerequisite for quality UI work.
ui-animation
Motion design and animation for user interfaces. Use when creating micro-interactions, page transitions, loading states, or any UI animation across web and mobile platforms.
travel-planner
Travel destination research and daily itinerary creation with logistics planning, budget tracking, and experience optimization. Use when planning trips, creating travel itineraries, comparing destinations, or organizing travel logistics.
test-specialist
This skill should be used when writing test cases, fixing bugs, analyzing code for potential issues, or improving test coverage for JavaScript/TypeScript applications. Use this for unit tests, integration tests, end-to-end tests, debugging runtime errors, logic bugs, performance issues, security vulnerabilities, and systematic code analysis.
tech-debt-analyzer
This skill should be used when analyzing technical debt in a codebase, documenting code quality issues, creating technical debt registers, or assessing code maintainability. Use this for identifying code smells, architectural issues, dependency problems, missing documentation, security vulnerabilities, and creating comprehensive technical debt documentation.
tdd-workflow
Test-Driven Development workflow enforcement with RED-GREEN-REFACTOR cycle. Use when implementing features test-first or improving test coverage.
tauri-desktop
Tauri 2.0 project setup, Rust backend + web frontend, plugin system, IPC commands, security model, auto-update, and mobile support. Use when building lightweight cross-platform desktop or mobile apps with Tauri.
svelte-development
Svelte 5 development with runes ($state, $derived, $effect), SvelteKit full-stack framework, and modern reactive patterns. Use when building Svelte applications, implementing fine-grained reactivity, or working with SvelteKit routing and server functions.