Inventory Check

Inventory Check

Reads beer.md, spirits.md, and wine.md from the inventory directory. Compares each item's quantity against its reorder threshold. Reports items at or below threshold.

Read-only. Does not modify files or reach external services. No PII in output.

When to Use

• Daily morning check before opening (scheduled: 10:00 AM)
• Before placing vendor orders (Sunday/Monday)
• When a bartender reports running low on something
• After receiving a delivery, to confirm stock levels updated

Procedure

Run the skill from the repo root:

# Human-readable summary
python -m skills.inventory_check

# Structured JSON output (for automation)
python -m skills.inventory_check --format json

# Against a custom inventory directory
python -m skills.inventory_check --inventory-dir path/to/inventory --format json

Parse the JSON result:

• status: "ok" (nothing to reorder) or "warn" (items need attention)
• findings: array of LOWSTOCK items with category, item name, qty, reorderat
• data.items_scanned: total items checked
• data.low_stock: detailed list of low items

Exit Codes

| Code | Meaning | |------|---------| | 0 | All stock levels acceptable | | 1 | One or more items at or below reorder threshold | | 2 | Config error (bad arguments) | | 3 | Data error (can't read inventory files) | | 10 | Unexpected error |

Verification

After running, confirm:

• Exit code is 0 or 1 (not 2, 3, or 10)
• stdout is valid JSON (when using --format json)
• data.items_scanned > 0 (files were actually read)
• If exit code is 1, findings array is non-empty

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: cvander
• Source: cvander/Maya
• License: MIT

Install and usage instructions live in the source repository linked above.