By 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.itemscontains analyzed menu items with cost/margin data