seth-receitas-ptbr_skill

Overview

This skill finds Brazilian Portuguese (pt-BR) recipes by searching Wikibooks and TheMealDB and will generate original recipes when needed. It returns complete recipes formatted for cooking: title, yield, prep time, ingredients, numbered steps, tags, and source attribution. The skill prioritizes legal sources and includes required attributions for reused content. It is designed for conversational and CLI use to search, fetch, suggest by ingredients, or return a random recipe.

How this skill works

The skill queries pt.wikibooks.org for collaborative recipes and TheMealDB API for international meals, then normalizes results into a consistent pt-BR recipe format. If neither source yields a suitable match, it synthesizes an original recipe using common culinary techniques and dietary constraints provided by the user. All returned recipes include source metadata and licensing notes so attribution requirements are clear. Optional nutrition lookups for ingredients can be performed when requested.

When to use it

• Search for recipes in Portuguese (Brazil) by name, ingredient, or dietary restriction
• Ask what to cook with specific ingredients you already have
• Get structured recipes ready for printing or shopping lists
• Request a random recipe or culinary inspiration
• Fetch a specific recipe by Wikibooks title or TheMealDB ID

Best practices

• Provide ingredient lists or dietary tags (vegan, gluten-free, etc.) to improve suggestions
• Specify desired yield or prep time if you need a quick or large-quantity recipe
• When using sourced recipes, include required attribution in any public reuse
• Use the suggest-by-ingredients mode to reduce food waste and get practical menus
• Validate allergen and nutrition information independently before serving to sensitive diners

Example use cases

• Search for 'bolo de cenoura' and receive a Wikibooks-sourced recipe with steps and yield
• Suggest dinner options using 'arroz, frango, tomate' and get several recipes ranked by fit
• Fetch a meal by TheMealDB ID to reproduce a known international dish in pt-BR
• Request a gluten-free vegan option and get an adapted recipe with tags and substitutions
• Ask for a random recipe to discover new dishes and generate a quick shopping list