Skip to content
Back to search

rainbrot

MarketplaceWorks with Claude CodeGitHub

Let Claude cook. Literally. A Claude Code skill that turns cravings into Michelin-level home recipes, checks them with food science, and adds as-cooked USDA nutrition facts. /chef /nutritionist /meal-plan

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rainbrot--claude-cook/badge.svg)](/listings/rainbrot--claude-cook)

HTML

<a href="/listings/rainbrot--claude-cook"><img src="/api/listings/rainbrot--claude-cook/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code (plugin):**

/plugin marketplace add rainbrot/claude-cook
/plugin install cook@rainbrot

**Claude Code (skills folder):**

git clone https://github.com/rainbrot/claude-cook
cp -r claude-cook/skills/* ~/.claude/skills/

**Claude.ai and the Claude desktop app:** download [`cook.zip`](https://github.com/rainbrot/claude-cook/releases/latest) from the latest release and upload it under **Settings → Capabilities → Skills** (code execution on). Then just ask in plain language.

**Other agents that support the [Agent Skills](https://agentskills.io) format:** `npx skills add rainbrot/claude-cook`, or copy `skills/cook` into the agent's skills folder.

**Requirements:** Python 3.8+, standard library only. Online lookups are optional and free; set a free [FoodData Central API key](https://fdc.nal.usda.gov/api-key-signup) as `FDC_API_KEY` for heavy use. Without Python, recipes still work and labels are estimated and marked as such.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 26 lines
  1. {
  2. "name": "rainbrot",
  3. "owner": {
  4. "name": "Ishaan Sethi",
  5. "url": "https://github.com/rainbrot"
  6. },
  7. "metadata": {
  8. "description": "Plugins by rainbrot. cook: recipes, nutrition labels and meal plans from a chef's understanding of flavor and food science."
  9. },
  10. "plugins": [
  11. {
  12. "name": "cook",
  13. "source": "./",
  14. "description": "Let Claude cook: craving-aware, Michelin-level home recipes checked with food science, with as-cooked USDA nutrition labels, meal plans and grocery lists.",
  15. "version": "1.0.0",
  16. "category": "lifestyle",
  17. "keywords": [
  18. "cooking",
  19. "recipes",
  20. "nutrition",
  21. "meal-planning",
  22. "food-science"
  23. ]
  24. }
  25. ]
  26. }
README.md · README · 231 lines
  1. <p align="center">
  2. <img src="assets/banner.png" alt="Claude Cook: Let Claude cook. Literally. A Claude Code skill that turns cravings into Michelin-level home recipes with USDA nutrition facts." width="100%">
  3. </p>
  4. <p align="center">
  5. <a href="https://github.com/rainbrot/claude-cook/stargazers"><img src="https://img.shields.io/github/stars/rainbrot/claude-cook?style=flat&color=e8b05c" alt="GitHub stars"></a>
  6. <a href="https://github.com/rainbrot/claude-cook/actions/workflows/test.yml"><img src="https://github.com/rainbrot/claude-cook/actions/workflows/test.yml/badge.svg" alt="tests"></a>
  7. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-d64e34" alt="MIT license"></a>
  8. <img src="https://img.shields.io/badge/Claude%20Code-plugin-cc785c" alt="Claude Code plugin">
  9. <img src="https://img.shields.io/badge/Agent%20Skills-compatible-6b5b4f" alt="Agent Skills compatible">
  10. <img src="https://img.shields.io/badge/nutrition-USDA%20FoodData%20Central-2f6b3a" alt="USDA FoodData Central">
  11. </p>
  12. <h1 align="center">Claude Cook</h1>
  13. <p align="center"><b>Let Claude cook. Literally.</b><br>
  14. A <a href="https://docs.claude.com/en/docs/claude-code">Claude Code</a> skill that reads what you're actually craving, designs a recipe like a Michelin-trained chef working in <i>your</i> kitchen, checks it against food science, and finishes with a real USDA nutrition label.</p>
  15. ```
  16. /plugin marketplace add rainbrot/claude-cook
  17. /plugin install cook@rainbrot
  18. ```
  19. Then just talk about food. Or use the shortcuts:
  20. ```
  21. /chef something crunchy, spicy and a little sweet with chicken thighs
  22. /nutritionist 140 g protein a day, vegetarian, I hate meal prep
  23. /meal-plan 5 dinners for 2, $80 budget, one of us is gluten-free
  24. /fridge half a cabbage, eggs, leftover rice, scallions, kimchi
  25. /nutrition-label <paste any recipe>
  26. /rescue my curry is way too salty and guests arrive in 20 minutes
  27. ```
  28. ## Same prompt, with and without
  29. *"I'm craving something crunchy, spicy and a little sweet for dinner tonight. I've got chicken thighs and not a lot of energy."* Same model, fresh sessions, unedited ([full outputs](examples/with-vs-without.md)).
  30. | | Claude | Claude + Claude Cook |
  31. |---|---|---|
  32. | Quantities | "1–2 tbsp gochujang", "oil for the pan", "salt and pepper" | every ingredient in grams and cups |
  33. | Salt | to taste | 1 g, given as Diamond Crystal, Morton *and* table salt (they differ 2× by volume) |
  34. | Doneness | times | times **plus** cues: "a pinch of cornstarch sizzles right away", "lift off the pan easily" |
  35. | Why it works | — | cornstarch's glassy crust, glaze reduced *before* tossing, a second crunch that survives the sauce |
  36. | Allergens | — | peanut, sesame, soy, wheat, plus the catch that most gochujang contains wheat |
  37. | Nutrition | — | full as-cooked label: calories, macros, 21 vitamins and minerals, %DV |
  38. ```
  39. NUTRITION FACTS - Crispy gochujang-honey chicken
  40. 2 servings | serving ~269 g (as cooked)
  41. ==============================================
  42. Calories 630
  43. ----------------------------------------------
  44. % Daily Value*
  45. Total Fat 26g 34%
  46. Saturated Fat 4.5g 22%
  47. Trans Fat 0g
  48. Cholesterol 210mg 70%
  49. Sodium 1,330mg 58%
  50. Total Carbohydrate 47g 17%
  51. Dietary Fiber 2g 7%
  52. Total Sugars 21g
  53. Includes 20g Added Sugars 40%
  54. Protein 50g 99%
  55. ==============================================
  56. Vitamin D 0.00mcg 0% Calcium 83mg 6%
  57. Iron 3.0mg 17% Potassium 614mg 13%
  58. ----------------------------------------------
  59. Vitamin A 19mcg 2% Vitamin C 3.4mg 4%
  60. Vitamin E 2.3mg 16% Vitamin K 43mcg 36%
  61. Thiamin 0.20mg 16% Riboflavin 0.46mg 36%
  62. Niacin 12mg 75% Vitamin B6 0.94mg 55%
  63. Folate 30mcg 7% Vitamin B12 0.89mcg 37%
  64. Choline 95mg 17% Magnesium 83mg 20%
  65. Phosphorus 416mg 33% Zinc 4.4mg 40%
  66. Selenium 55mcg 100% Copper 0.40mg 44%
  67. Manganese 0.48mg 21%
  68. Omega-3 0.80g
  69. ----------------------------------------------
  70. * %DV = share of a 2,000-calorie daily diet.
  71. ```
  72. More: [a nutritionist-mode dinner built from someone's own calorie and protein targets](examples/nutritionist-weight-loss-dinner.md).
  73. ## How it thinks
  74. ```mermaid
  75. flowchart LR
  76. A["Your words<br/>'crunchy, spicy,<br/>a little sweet'"] --> B["Decode<br/>craving core,<br/>context, constraints"]
  77. B --> C["Design<br/>salt · umami pairing · fat + counterweight<br/>acid · layered aroma · texture · a hook"]
  78. C --> D["Verify<br/>kitchen simulation<br/>+ nutrition engine"]
  79. D -- "fails a check" --> C
  80. D --> E["Recipe + USDA label"]
  81. ```
  82. - **Decode.** "Healthy mac and cheese" still wants creamy, cheesy, salty, soft starch. Claude Cook names that *craving core* and protects it in every swap, so you don't get handed zucchini noodles.
  83. - **Design.** Every dish gets a flavor architecture: seasoning in grams, an umami pairing that multiplies (glutamate + nucleotides, like tomato with parmesan or kombu with bonito), fat with something that cuts it, acid for lift, aroma layered by timing, at least one texture contrast, and one memorable hook.
  84. - **Verify.** Before you see anything, the recipe runs through a kitchen simulation. Are the times real (onions don't caramelize in 10 minutes)? Will the pan brown or steam? Will the sauce break? Is bite ten as good as bite one? Where will a home cook most likely fail? Then the numbers: the engine checks salt as a percentage of the dish against targets for 30+ dish types. In testing, a first draft came back salt-HIGH, and Claude fixed it before replying.
  85. - **Deliver.** Grams first, salt for every brand, °F and °C, and a sensory checkpoint at every step that can go wrong.
  86. **Science-first, never snobby.** Every technique is justified by a mechanism you can reuse elsewhere, and each recipe teaches at least one transferable principle. "Elevated" is a choice Claude makes per dish: by default it makes the best version of what people actually love to eat, and it only goes fancier when that makes your meal better or you ask for it. Jarred sauce, MSG and American cheese are fair game when they're the right tool.
  87. Two personalities on purpose. **Chef** maximizes deliciousness. **Nutritionist** treats your targets as hard constraints and hits them with the flavor levers that cost no calories: salt to target, acid, umami, aroma, browning, heat and texture. It puts the fat and sugar where your tongue meets them first instead of dissolving them into the dish.
  88. ## The nutrition engine
  89. No guessing at numbers. `nutrition.py` is a zero-dependency Python engine that follows USDA's own recipe-calculation method:
  90. | Step | Source |
  91. |---|---|
  92. | 6,781 foods × 42 nutrients | USDA FoodData Central, SR Legacy (bundled, works offline) |
  93. | "1 medium onion", "2 cups flour", "1 stick butter" → grams | 12,771 USDA household portion weights + 650 everyday ingredient names |
  94. | Cooking losses (`~boil` broccoli loses vitamin C; `~braise:150` wine keeps 5% of its alcohol) | USDA Table of Nutrient Retention Factors, Release 6: 270 food-group × method profiles |
  95. | Cooked weight and fat you pour off (`~brown+drain`) | derived from USDA raw/cooked food pairs |
  96. | Gochujang, mirin, MSG, nutritional yeast, oat milk… | USDA Branded and Foundation records |
  97. | Any brand you name (`=online`) | live FoodData Central search, including its Branded Foods database |
  98. | Missing lab values | filled from the closest related USDA foods, and flagged on the label |
  99. | Added sugars | FDA definition (sweeteners, not the lactose or fruit sugar an ingredient carries) |
  100. | Rounding, %DV | FDA labeling rules and 2016 Daily Values |
  101. Beyond the label, every analysis reports:
  102. - salt % against the target for the dish type;
  103. - energy density, which predicts how full a meal keeps you;
  104. - Fazzino 2019 hyper-palatability flags (fat + sugar, fat + sodium, carbs + sodium);
  105. - which ingredients supply acid, umami, heat, crunch and so on, so a missing role like "crunch: NONE" is visible;
  106. - whether you have umami synergy;
  107. - the 9 major allergens, plus brand-dependent ones.
  108. It also does personal targets (Mifflin-St Jeor with DRIs by age and sex), meal-plan day totals, and grocery lists:
  109. ```bash
  110. python3 skills/cook/scripts/nutrition.py analyze recipe.txt
  111. python3 skills/cook/scripts/nutrition.py targets --sex f --age 34 --height 5\'6\" --weight 150lb --activity moderate --goal lose --out me.json
  112. python3 skills/cook/scripts/nutrition.py day week.txt --targets me.json
  113. python3 skills/cook/scripts/nutrition.py shop week.txt
  114. ```
  115. <details>
  116. <summary>Recipe file format</summary>
  117. ```
  118. # Chicken tinga tacos
  119. servings: 4
  120. type: braise # turns on the salt-target check
  121. 900 g boneless skinless chicken thighs ~braise:45
  122. 1 large white onion, sliced ~saute
  123. 1 (400 g) can crushed tomatoes ~simmer
  124. 2 tsp Diamond Crystal kosher salt
  125. juice of 1 lime
  126. 8 corn tortillas ~toast
  127. 450 g ground beef ~brown+drain # rendered fat poured off
  128. 1000 g canola oil @8% # only 8% is eaten (deep frying)
  129. 2 tbsp Mother-in-Law's gochujang =online # this exact product's label
  130. 1/2 cup cilantro =fdc:169997 # pin an exact USDA record
  131. 20 g chili crisp {kcal=600 fat=55 carb=20 sodium=1100} # per-100 g values from a jar
  132. ```
  133. Methods: `bake roast broil grill saute stirfry panfry sear fry fry-coated boil blanch simmer stew braise steam microwave poach toast brown mash reheat flame deglaze`, with optional `:minutes` and `+drain`.
  134. </details>
  135. ## Install
  136. **Claude Code (plugin):**
  137. ```
  138. /plugin marketplace add rainbrot/claude-cook
  139. /plugin install cook@rainbrot
  140. ```
  141. **Claude Code (skills folder):**
  142. ```bash
  143. git clone https://github.com/rainbrot/claude-cook
  144. cp -r claude-cook/skills/* ~/.claude/skills/
  145. ```
  146. **Claude.ai and the Claude desktop app:** download [`cook.zip`](https://github.com/rainbrot/claude-cook/releases/latest) from the latest release and upload it under **Settings → Capabilities → Skills** (code execution on). Then just ask in plain language.
  147. **Other agents that support the [Agent Skills](https://agentskills.io) format:** `npx skills add rainbrot/claude-cook`, or copy `skills/cook` into the agent's skills folder.
  148. **Requirements:** Python 3.8+, standard library only. Online lookups are optional and free; set a free [FoodData Central API key](https://fdc.nal.usda.gov/api-key-signup) as `FDC_API_KEY` for heavy use. Without Python, recipes still work and labels are estimated and marked as such.
  149. ## FAQ
  150. **Is this an MCP server?** No, and on purpose. It's an Agent Skill with a bundled offline database: no server to run, no API key, no setup. It works anywhere Claude can run Python, including Claude Code, Claude.ai code execution and the API.
  151. **How accurate is the nutrition?** It uses the same inputs and method USDA uses to calculate recipes: lab-analyzed foods, official portion weights, retention factors for cooking losses, and yields. The label shows which ingredients matched which USDA records and flags any filled values. Real food varies (your onion isn't USDA's average onion), so weigh ingredients for the tightest numbers.
  152. **Does it need fancy equipment or ingredients?** No. It assumes a supermarket, a skillet, a pot and a sheet pan. Anything regional comes with a swap ("gochujang, or sriracha + miso"), and anything special comes with an alternative (no grill → broiler).
  153. **How many tokens does it cost?** About 250 tokens of skill description sit in context for every session. The full skill (~4.6k tokens) loads only when you talk about food. The reference library (flavor science, kitchen chemistry, baking, nutrition) loads one section at a time, only when a request needs it.
  154. **Is this medical advice?** No. It's food and nutrition information. Nutritionist mode defers to clinicians for kidney disease, diabetes medication, pregnancy complications and eating disorders, and it won't push numbers on someone who signals disordered eating.
  155. ## What's inside
  156. ```
  157. skills/
  158. ├── cook/ the skill that does the thinking
  159. │ ├── SKILL.md decode → design → verify → deliver
  160. │ ├── references/ loaded a section at a time
  161. │ │ ├── flavor.md palatability science, umami synergy, aroma layering, 20 cuisine grammars
  162. │ │ ├── science.md heat, browning, proteins, starches, emulsions, frying, enzymes, food safety
  163. │ │ ├── numbers.md salt targets, ratios, doneness temps, cup weights, yields, pan sizes
  164. │ │ ├── cravings.md moods, occasions and vague asks → sensory targets
  165. │ │ ├── access.md equipment and ingredient substitutes, budget, dietary adaptations
  166. │ │ ├── nutrition.md targets, protein, fiber, micronutrients, bioavailability, goal playbooks
  167. │ │ ├── meal-planning.md component-based plans, storage, verification
  168. │ │ ├── baking.md formula chemistry, leavening, doughs, failures
  169. │ │ └── rescue.md fixes for anything going wrong mid-cook
  170. │ ├── scripts/ nutrition.py + cooking.py (zero dependencies)
  171. │ └── data/ USDA tables, retention factors, yields, aliases
  172. └── chef, nutritionist, meal-plan, nutrition-label, fridge, rescue/ slash-command shortcuts
  173. evals/ graded test cases for `claude plugin eval`
  174. examples/ unedited outputs from real sessions
  175. tests/ 28 nutrition-engine and packaging tests (CI on Python 3.8 and 3.13)
  176. ```
  177. ## Contributing
  178. Cooked something with it? [Share it in Discussions](https://github.com/rainbrot/claude-cook/discussions). Did the skill get something wrong in your kitchen? [Open a recipe report](https://github.com/rainbrot/claude-cook/issues/new/choose). Those reports are the most valuable contribution there is. Ingredient name fixes, regional cuisines and substitutions are very welcome; see [CONTRIBUTING.md](CONTRIBUTING.md).
  179. If Claude Cook made you dinner, a ⭐ helps other people find it.
  180. ## Inspiration
  181. The approach owes a lot to science-first home-cooking educators like Ethan Chlebowski and J. Kenji López-Alt, who explain *why* techniques work and cook for enjoyment rather than prestige. No affiliation or endorsement implied.
  182. ## License
  183. MIT. Nutrient data from USDA FoodData Central and the USDA Table of Nutrient Retention Factors is public domain. Claude Cook is an independent community project and isn't affiliated with or endorsed by Anthropic.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.