location-binning

Manages warehouse locations, bins, and shelf assignments in gbrain procurement pages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Warehouse teams lose track of where inventory items are physically stored, leading to picking delays and inaccurate capacity planning. This Skill keeps location and bin records in gbrain synchronized with item assignments so every SKU has a known shelf position. ## Core Features & Use Cases - Location & Bin CRUD: Create warehouse location pages under procurement/locations/<LOC-ID>.md with zone, capacity, and occupancy frontmatter. - Item Assignment & Relocation: Move items between bins by updating the item's location_id and both location pages' current_items lists atomically. - Capacity Utilisation Reporting: Generate per-zone tables showing capacity, items assigned, and utilisation percentage, flagging locations above 85%. - Use Case: A warehouse operator says "Move SKU-042 to shelf B2" and the Skill updates the item page plus the old and new location pages, confirming the relocation. ## Quick Start Ask the procurement-manager agent to create a new bin location called LOC-MAIN-A1 in the main warehouse with a capacity of 500 items.

Frequently Asked Questions about location-binning

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

FAQPage Schema
How do I create a new warehouse bin location in gbrain?

Provide a unique location ID, display name, zone, and capacity, and the Skill creates a page at procurement/locations/<LOC-ID>.md with frontmatter fields for zone, capacity, current_items, and status. Always verify the ID does not already exist before creating.

How to move an inventory item to a different shelf or bin?

The Skill retrieves the item page, updates its location_id frontmatter to the new bin, and updates the current_items lists on both the old and new location pages. Both location pages must be updated together to avoid stale occupancy data.

Can I report warehouse capacity utilisation by zone?

Yes, the Skill queries all procurement/locations pages, counts assigned items per location via reverse lookup, and formats a table with capacity, items assigned, and utilisation percentage. Locations above 85% capacity are flagged.

When should I not use location-binning for inventory tasks?

Do not use it for recording stock movements such as receives and issues; that belongs to the stock-movement-audit skill. Location-binning only tracks where items are stored, not transactional stock changes.

Why does my bin capacity report show wrong utilisation percentages?

Utilisation errors usually come from mixing capacity units, such as item counts versus cubic volume, across locations. Agree on a single capacity unit at setup so percentages remain meaningful.