| name | cost-analysis |
| description | Calculate pour costs and margins from menu and inventory data. |
| version | 0.1.0 |
| author | Maya |
| license | MIT |
| platforms | ["macos"] |
| metadata | {"hermes":{"tags":["cost","margin","pour-cost","menu","inventory","analysis"],"requires_toolsets":["terminal"],"config":[]}} |
| required_environment_variables | [] |
Cost Analysis
Reads the current menu and inventory files to calculate pour cost per drink, category COGS, and margin percentages. Flags items with high pour costs (>30%) or low margins (<$8).
When to Use
- When reviewing menu pricing decisions
- Before adjusting prices on cocktails or spirits
- Monthly cost analysis for the bar
Procedure
python -m skills.cost_analysis --format json
python -m skills.cost_analysis --format json --category cocktails
Optional: --category all|beer|spirits|wine|cocktails (defaults to all).
Exit Codes
| Code | Meaning |
|---|
| 0 | OK, all margins healthy |
| 1 | Warnings: high pour cost or low margin items |
| 2 | Config error |
| 3 | Data error |
| 10 | Unexpected error |
Verification
- Exit code is 0 or 1
- stdout is valid JSON (with --format json)
data.items contains analyzed menu items with cost/margin data
