inventory-item-management

Creates and updates inventory item brain pages with SKU master data, stock levels, and reorder points.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping SKU master data accurate in a gbrain knowledge base is error-prone when done by hand — duplicate SKUs, missing fields, and inconsistent frontmatter break downstream inventory workflows. This Skill standardizes how inventory item records are created, read, and updated under procurement/items/<SKU>.md. ## Core Features & Use Cases - SKU Record Creation: Gathers item details, checks for duplicates via proc_get_item, and writes a compliant frontmatter page with stock, cost, reorder point, vendor, and bin location. - Record Updates: Modifies stock levels, reorder points, or vendor assignments on existing SKUs, using proc_update_stock for quantity changes. - Search & Audit: Lists and filters inventory by category or below-reorder status for audits and stock verification. - Use Case: A procurement manager says "Add SKU-099, a USB-C Hub, with 50 units in stock" — the Skill verifies the SKU doesn't exist, creates the brain page with full frontmatter, and confirms the new stock level. ## Quick Start Ask the agent to add a new inventory item with its SKU, name, category, unit cost, initial stock, reorder point, preferred vendor, and bin location.

Frequently Asked Questions about inventory-item-management

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

FAQPage Schema
How do I add a new SKU to an inventory management system?

Provide the SKU, item name, category, unit cost, initial stock, reorder point, preferred vendor, and bin location. The Skill calls proc_get_item to confirm the SKU does not already exist, then creates a frontmatter page at procurement/items/<SKU>.md in gbrain.

How do I update stock levels or reorder points on an existing item?

The Skill retrieves the current record with proc_get_item, applies changes to the relevant frontmatter fields, and calls proc_update_stock when the quantity changes. Note that proc_update_stock changes quantity only; unit cost is edited directly on the page.

Can I list inventory items below their reorder point?

Yes. Call proc_list_inventory with the below_reorder filter, or filter by search term or category. Results are formatted as a table showing SKU, item name, category, quantity, unit cost, reorder point, and status.

Why does creating an inventory item fail with a duplicate SKU?

The Skill always calls proc_get_item before creating a record and aborts if the SKU already exists. This prevents duplicate master records; update the existing item instead of recreating it.

When should I not use this inventory item skill?

Do not use it for recording stock movements such as receives, issues, or damage — that belongs to stock-movement-audit. It also does not generate reorder purchase orders, which is handled by reorder-alert-watchdog.