# Inventory Check

> Scan inventory markdown for items at or below reorder threshold.

- **Type:** Skill
- **Install:** `agentstack add skill-cvander-maya-inventory-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cvander](https://agentstack.voostack.com/s/cvander)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cvander](https://github.com/cvander)
- **Source:** https://github.com/cvander/Maya/tree/main/skills/inventory_check

## Install

```sh
agentstack add skill-cvander-maya-inventory-check
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
# 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 LOW_STOCK items with category, item name, qty, reorder_at
- `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](https://github.com/cvander)
- **Source:** [cvander/Maya](https://github.com/cvander/Maya)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cvander-maya-inventory-check
- Seller: https://agentstack.voostack.com/s/cvander
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.