restaurant-ops
Price restaurant dishes from real food costs — load an ingredient list, see per-dish cost and current margin, and get the menu price needed to hit a target margin. Comes with a menu-engineering matrix (stars, plowhorses, puzzles, dogs) and copy-paste review-response templates. Use when setting or auditing menu prices for a restaurant, cafe, or food truck.
$ skillbank install restaurant-ops@1.0.0 # pins exactly 1.0.0 · README + changelog included
Restaurant Ops
Overview
Menu prices drift. Supplier costs creep up, specials get priced by gut feel, and suddenly a dish you sell a hundred times a week makes 4 points less than it should. Restaurant Ops pairs a no-dependency food-cost calculator with the two operator playbooks that matter most after pricing: menu engineering (which dishes earn their spot) and review responses (what you say when it goes public).
Everything runs on your own machine. The script reads your ingredient JSON, does the arithmetic, and prints results — nothing is uploaded anywhere.
Installation
1. Copy the restaurant-ops/ directory anywhere convenient. 2. Make the script executable (Unix):
chmod +x scripts/foodcost.py
No pip install needed — standard library only.
Configuration
The calculator reads its ingredient list from a JSON file you point it at:
[
{"name": "Chicken breast 6oz", "unit_cost": 1.85, "qty": 1},
{"name": "Pasta 8oz", "unit_cost": 0.35, "qty": 1}
]
name— ingredient label (free text).unit_cost— your cost for one unit, in dollars.qty— how many units go into one dish (fractions allowed).
Keep your ingredient costs current — most operators re-cost top sellers monthly, the full menu quarterly.
Inputs
| Input | Required | Description | |----------------------|----------|-----------------------------------------------------------------| | ingredients (file) | yes | JSON list of {name, unit_cost, qty} per dish. | | --price | yes | Current menu price, e.g. 12.99. | | --target-margin | yes | Target margin as a fraction, e.g. 0.70 for a 70% margin. |
Output: per-ingredient line costs, total food cost, current margin, the suggested menu price at your target margin (cost / (1 − margin), rounded up to the cent), and a flag when the current margin sits below target.
Worked example
$ cat chicken-alfredo.json
[
{"name": "Chicken breast 6oz", "unit_cost": 1.85, "qty": 1},
{"name": "Pasta 8oz", "unit_cost": 0.35, "qty": 1},
{"name": "Alfredo sauce 4oz", "unit_cost": 0.65, "qty": 1},
{"name": "Parmesan 0.5oz", "unit_cost": 0.25, "qty": 1},
{"name": "Side salad mix", "unit_cost": 0.30, "qty": 1}
]
$ ./scripts/foodcost.py chicken-alfredo.json --price 10.99 --target-margin 0.70
INGREDIENTS
Chicken breast 6oz 1 x $1.85 = $1.85
Pasta 8oz 1 x $0.35 = $0.35
Alfredo sauce 4oz 1 x $0.65 = $0.65
Parmesan 0.5oz 1 x $0.25 = $0.25
Side salad mix 1 x $0.30 = $0.30
Food cost (per dish): $3.40
Current menu price: $10.99
Current margin: 69.1%
Target margin: 70%
Suggested price at target: $11.34
FLAG: current margin 69.1% is BELOW the 70% target — raise the price to at least $11.34.
The math: $3.40 ÷ (1 − 0.70) = $11.333…, rounded up to $11.34.
Playbooks
- Menu-engineering matrix — stars, plowhorses, puzzles, and dogs: how to classify every dish by profit and popularity and what to do with each.
- Review-response templates — copy-paste replies for positive reviews, negative reviews, and slow-service complaints.
Safety notes
This is a benign business tool. All ingredient data stays on your machine; the script makes no network calls and never uploads anything. Pricing decisions are yours — the calculator shows the arithmetic, it does not set policy.
Version history
Changelog
1.0.0 — 2026-09-27
- Initial release:
scripts/foodcost.pyfood-cost calculator (per-dish cost, - Playbooks: menu-engineering matrix and review-response templates.
current margin, suggested price at target margin with below-target flag).