Cookidoo Recipe Builder
randompm2024/cookidoo-recipe-builder
Converte receitas para Thermomix Cookidoo com UI guiada
Ver no GitHubSkill Claude que converte qualquer receita para o formato Thermomix TM7 Cookidoo MyRecipes. Bilíngue EN/ES com interface de 3 ações por passo, eliminando texto puro e estruturando para digitização em escala.
Instalação
npx convez-ai randompm2024/cookidoo-recipe-builder1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Digitalizar receitas caseiras ou de livros no formato Cookidoo
- Padronizar receitas customizadas com convenções profissionais
- Gerar guias passo-a-passo que evitam paredes de texto
Veredito

Skill bem arquitetado que resolve um problema específico (formatação de receitas para TM7). O fluxo de 3 ações por passo é inteligente e evita antigos erros de UX. Útil para quem customiza receitas em Cookidoo regularmente; escopo limitado mas executado com clareza.
README
A tradução para o português deste README ainda está na fila.
Cookidoo Recipe Builder
Version: v0.2.0
A Claude skill that converts any recipe into Thermomix TM7 Cookidoo MyRecipes format. Bilingual (English + Spanish). Made for at-scale recipe digitization.
What's new in v0.2.0
- 3-action UI flow per step (Type / Fan / Scale) replaces the v0.1.0 markdown-block format. Every step now tells you exactly which Cookidoo control to tap, in what order.
- Output is action-oriented, not paste-oriented. This prevents the v0.1.0 wall-of-text failure where users pasted the whole markdown block into a single text field and ended up with literal asterisks, unlinked ingredients, and no guided-cooking chips.
- Added "Anti-pattern" guidance to
sample-workflow.mdshowing the exact v0.1.0 failure (pasted block, missed fan/scale icons, "vainillavainilla" artifacts) so contributors don't reintroduce it. - LICENSE file added (MIT) at the repo root.
If you used v0.1.0, the conventions and language support carry forward unchanged. The only thing that changed is how the skill formats its output to walk you through Cookidoo's actual UI.
The problem
Custom recipes in Cookidoo MyRecipes usually look amateur next to Vorwerk's official recipes. Steps turn into walls of text. Quantities get jammed into step descriptions instead of the ingredient panel. Machine settings sit buried in prose instead of rendering as guided-cooking chips.
This skill codifies the conventions Vorwerk uses (verb-led steps, bold inline settings, separate ingredient prep notes, short aspirational descriptions) and produces output structured around the three UI actions Cookidoo MyRecipes actually requires per step.
What it does
- Takes any recipe (photo, URL, cookbook page, free text) as input
- Asks 3 setup questions (language, output mode, user preferences)
- Produces a guide where each step is broken into three discrete UI actions you perform in Cookidoo MyRecipes:
- 🅰 TYPE prose into the "Describe step" field (imperative verb, ingredient names only, no quantities, bold inline settings)
- 🅱 TAP the fan icon → Manual tab → set Time / Temperature / Speed (or SKIP if no machine action)
- 🅲 TAP the scale icon → Linked tab → check the ingredients used in this step (or SKIP if none)
- Tells you the exact top-of-recipe entry order to minimize re-edits
Quick start
If you're new to Claude skills:
- Install: Copy the
cookidoo-recipe-builder/folder to your Claude skills directory, or invoke it directly from Claude Code in any project that knows where it lives. - Invoke: Open Claude and say something like "use cookidoo-recipe-builder to convert this recipe: [paste recipe text, URL, or attach a photo]".
- Follow the prompts. The skill asks which language, quick pass vs. full reformat, and any user-specific preferences.
- Follow the 3-action guide in Cookidoo. Open MyRecipes on cookidoo.com or your TM7. For each step the skill outputs, you'll do 🅰 type the prose, 🅱 tap the fan icon and dial in the machine settings, 🅲 tap the scale icon and check the linked ingredients. Then green-check the step and tap "+" for the next one.
That's it. No build step, no install dependencies beyond Claude itself.
The 3-action flow (the v0.2.0 core)
Each step in the output looks like this:
### Step N
🅰 **TYPE** this into "Describe step":
> Coloque la mariposa, la crema y la vainilla en el vaso, bata **1 min/vel 3.5** hasta picos suaves. Transfiera a un bol y refrigere.
🅱 **TAP the fan icon** → Manual tab → Time: **1** min **0** sec / Temperature: **OFF** / Speed: **3.5** → green check
🅲 **TAP the scale icon** → Linked tab → check **crema de leche** + **extracto de vainilla** → green check
✅ Tap green check to confirm. Tap "+" to add the next step.
Steps without a Thermomix action get 🅱 SKIP. Steps without linked ingredients get 🅲 SKIP. The prose in 🅰 never includes "Vincular ingredientes:" or "Manual:" labels — those are display markers only, never to be typed.
Tips entry rule: Each tip goes in as a SEPARATE Tip entry via the "+" button. Never paste a single paragraph with - characters — Cookidoo renders those as literal dashes, not bullets.
Top-of-recipe entry order
To minimize re-edits, enter fields in this order: Title → Description → Preparation time → Total time → Portions → Difficulty → Devices & Accessories (add Mariposa via Edit if needed) → Useful Items → Ingredients (each row separately, prep notes after "/") → Preparation steps (each is 3 actions as above) → Tips (each a separate entry) → Save.
What's in the box
| File | Purpose |
|---|---|
SKILL.md | Skill entry point. Describes when to invoke and the end-to-end flow. |
cookidoo-conventions.md | The 8 Vorwerk recipe patterns codified from official recipes. |
tm7-ui-constraints.md | What the MyRecipes editor allows (temperature ranges, missing toggles, etc.). |
verb-glossary.md | Imperative verbs in Spanish + English for step authoring. |
templates/ | Sample outputs in the 3-action format for mousse, savory main, baked good. |
examples/ | Canonical example: dulce de leche pâte à bombe mousse, rendered in 3-action format. |
sample-workflow.md | End-to-end how-to with a real example. Includes the v0.2.0 anti-pattern section showing the v0.1.0 paste-the-whole-block failure mode. |
LICENSE | MIT. New in v0.2.0. |
The 8 Vorwerk conventions (summary)
- Each step starts with an imperative verb (Coloque, Añada, Pique / Place, Add, Chop).
- Steps are 1-2 sentences max.
- Machine settings appear inline in bold using the format
**4 seg/vel 5**or**15 min/Varoma/vel 1**. The bold prose is what the user TYPES; the actual guided-cooking chip comes from the fan-icon Manual dropdown. - Quantities never appear in step text. They live in the ingredient panel, linked via the scale icon.
- One machine setting per step (or zero).
- Ingredient format:
[quantity] [unit] de [name]with optional prep note on a second line. - Description: short and aspirational, 1-2 sentences. Sells the dish.
- Tips section: bulleted, practical guidance (brands, substitutions, what to watch for) — each tip entered as its own Tip in Cookidoo.
The full reasoning, examples, and edge cases live in cookidoo-conventions.md.
TM7 editor constraints (the gotchas)
A few things the MyRecipes editor doesn't let you do, and how the skill works around them:
- Temperature picker: Only OFF or 100°C to 220°C in fixed steps. No 37°C, 40°C, 60°C, 80°C. Classical sabayon inside the jug isn't possible.
- No butterfly toggle. You describe it in the step text. The TM7 enforces max speed 4 when the butterfly is mounted.
- No reverse-direction toggle. Describe in step text.
- Workarounds: Cook sugar syrups in a saucepan off-Thermomix. Use room-temp ingredients where possible. Microwave gelatin for 10-15 seconds.
The skill flags these workarounds automatically and adds the right tools to the "Useful Items" field.
Languages supported
- English
- Spanish (Argentine by default, adaptable to peninsular or Mexican)
- Source-language passthrough (give it a French recipe, get French output)
Spanish defaults to Argentine vocabulary: manteca (not mantequilla), crema de leche (not nata), dulce de leche with Argentine brand suggestions (La Salamandra, Havanna, Chimbote). Override at setup if you want a different regional dialect.
Canonical example
The reference recipe lives at examples/dulce-de-leche-mousse.md. It's a no-gelatin Argentine dulce de leche mousse that uses the pâte à bombe technique, now rendered in the v0.2.0 three-action format. It demonstrates:
- Sugar syrup cooked off-Thermomix (works around the no-low-temp constraint)
- "Useful Items" field populated with external tools (saucepan, thermometer, bowls)
- Verb-led steps with inline bold machine settings, and matching fan-icon dial settings as a separate 🅱 action
- Cream whipping at 1 min / vel 3.5 / OFF (the user-calibrated setting after over-whipping at vel 4 / 2 min). Tips include "watch through the lid, stop at soft peaks, can come earlier than the timer."
- Whole eggs + yolks instead of gelatin
If you're authoring a new recipe and want to see what "done right" looks like in v0.2.0 format, start there.
Origin story
Built iteratively while debugging a custom dulce de leche mousse on a TM7. The v0.1.0 draft codified the Vorwerk conventions but emitted one markdown block per step, which users pasted into a single Cookidoo text field. The result: literal ** characters in the prose, no linked ingredients, no guided-cooking chips, and duplication artifacts like "vainillavainilla". v0.2.0 splits each step into the three discrete UI actions Cookidoo actually requires, so the output is a guide you follow rather than a block you paste.
Contributing
If you find a Vorwerk convention I missed, open an issue with a screenshot from an official Cookidoo recipe showing the pattern. Real evidence beats opinion.
If you want to add templates for other recipe types (sauces, soups, fermentation, doughs, ice creams), PRs welcome. Follow the 3-action shape of the existing templates in templates/ and reference at least one official Vorwerk recipe that uses the pattern you're modeling.
Bug reports: include the recipe you fed in, the output you got, and what you expected. Screenshots of the Cookidoo editor are gold — especially screenshots showing the fan-icon and scale-icon modals.
License
MIT. See LICENSE at the repo root. Use it, fork it, ship it. If you build something cool on top, I'd love to hear about it.
Acknowledgments
- Anthropic Claude, for being the substrate this skill runs on.
- The Vorwerk Thermomix Cookidoo team, for setting a recipe-authoring bar worth copying.
- Argentine pastry tradition, for the dulce de leche mousse that started this whole thing.