warehouse-distribution

Manages inbound receiving, pick-pack-ship, cross-docking, and carrier dispatch for distribution centers.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill warehouse-distribution-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: warehouse-distribution
Source: https://github.com/tapway/shogun-os/tree/main/skills/retail/warehouse-distribution
Command: npx skills add https://github.com/tapway/shogun-os --skill warehouse-distribution-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Coordinating warehouse operations across receiving, putaway, picking, packing, cross-docking, and carrier dispatch is error-prone when done manually, leading to missed carrier cutoffs, inventory discrepancies, and delayed shipments. ## Core Features & Use Cases - Inbound Receiving: Verify purchase order quantities, record received items, and generate discrepancy reports for damaged or short shipments. - Wave-Based Picking: Generate optimized pick waves based on order priority, zone proximity, and carrier cutoff times. - Cross-Docking: Match inbound shipments to open store replenishment orders and manage staging lane allocation for direct transfers. - Carrier Dispatch: Assign outbound shipments to carriers by destination, service level, and pickup schedule, generating manifests and labels. - Use Case: A retail supply chain team receives PO-2026-0451 at dock 3, verifies 500 expected units against actual receipt, logs 5 short units and 3 damaged items, then generates a replenishment pick wave aligned to the 14:00 DHL cutoff. ## Quick Start Ask the agent to process an inbound receipt for a purchase order and generate a pick wave for store replenishment aligned to today's carrier cutoff.

Frequently Asked Questions about warehouse-distribution

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

FAQPage Schema
How do I process an inbound warehouse receipt against a purchase order?

Run the receive subcommand with the PO number and the --verify flag to check expected quantities against received items. The script returns a receipt record with discrepancies for short or damaged shipments and marks putaway status as pending.

How to generate a pick wave for store replenishment?

Use the pick-wave subcommand with --type store-replenishment and an optional --wave-size. The planner batches picks by order priority, zone proximity, and carrier cutoff times, rejecting waves that exceed the configured maximum size.

What is cross-docking and when should I use it?

Cross-docking transfers inbound shipments directly to outbound staging when they match open store replenishment orders, skipping storage. Use it when timing between inbound arrival and outbound carrier pickup is tight, since a 30-minute delay can miss the wave.

Does the warehouse distribution skill support multiple carriers?

Yes, carriers are defined in layout.yaml with their pickup times, such as DHL and SF Express. The dispatch subcommand assigns shipments by destination, service level, cost, and pickup schedule, then generates manifests.

Why does my pick wave request fail with a size error?

The wave size exceeds the configured maximum set by WAREHOUSE_MAX_WAVE_SIZE, which defaults to 500. Reduce the requested wave size or raise the limit, but note that oversized waves create zone congestion.

When should I not use warehouse distribution for inventory tasks?

Do not use it for store-level inventory management, which belongs to the store-replenishment skill. Also avoid wave planning without first checking carrier cutoff times, since missing a pickup window causes a 24-hour delay.