recipe_finder
starsforks
How to install recipe_finder?
coleam00/custom-agent-with-skills/recipe_finder
$npx -y skills add coleam00/custom-agent-with-skills --skill recipe_finderSearch recipes by ingredients, cuisine, or dietary needs. Get nutrition info, meal plans, and cooking instructions. Use when user asks about cooking, recipes, meals, or food.
SKILL.md
| 1 | # Recipe Finder Skill |
| 2 | |
| 3 | Find recipes, get nutrition information, and create meal plans using free recipe APIs. Supports searching by ingredients, dietary restrictions, cuisine type, and more. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | - User asks for recipe suggestions |
| 8 | - User wants to know what to cook with specific ingredients |
| 9 | - User has dietary restrictions (vegetarian, gluten-free, keto, etc.) |
| 10 | - User asks about nutrition or calories in a recipe |
| 11 | - User wants meal planning help |
| 12 | - User asks about cooking instructions or techniques |
| 13 | - User asks "what can I make with..." |
| 14 | |
| 15 | ## Available Operations |
| 16 | |
| 17 | 1. **Recipe Search**: Find recipes by keyword, ingredient, or cuisine |
| 18 | 2. **Ingredient-Based Search**: "What can I make with chicken and broccoli?" |
| 19 | 3. **Dietary Filtering**: Filter by diet (vegan, keto, paleo) or intolerances |
| 20 | 4. **Nutrition Analysis**: Get calorie and nutrient breakdown |
| 21 | 5. **Random Recipe**: Get a random recipe for inspiration |
| 22 | 6. **Recipe Details**: Get full instructions, ingredients, and nutrition |
| 23 | |
| 24 | ## Instructions |
| 25 | |
| 26 | When a user asks about recipes or cooking: |
| 27 | |
| 28 | ### Step 1: Understand the Query |
| 29 | |
| 30 | Identify what the user needs: |
| 31 | - **Ingredient-based**: "What can I make with [ingredients]?" |
| 32 | - **Cuisine search**: "Give me Italian recipes" |
| 33 | - **Dietary needs**: "Keto dinner ideas" |
| 34 | - **Specific dish**: "How do I make chicken parmesan?" |
| 35 | - **Nutrition focused**: "Low calorie lunch ideas" |
| 36 | |
| 37 | ### Step 2: Load API Reference |
| 38 | |
| 39 | ALWAYS read `references/api_reference.md` before making API calls. The APIs have specific parameter formats. |
| 40 | |
| 41 | ### Step 3: Choose the Right API |
| 42 | |
| 43 | **Option A: TheMealDB (Simpler, Completely Free)** |
| 44 | - Good for: Basic recipe search, random recipes, category browsing |
| 45 | - URL: `https://www.themealdb.com/api/json/v1/1/` |
| 46 | - No API key needed (use "1" as the key) |
| 47 | |
| 48 | **Option B: Spoonacular (More Powerful, Free Tier)** |
| 49 | - Good for: Ingredient search, nutrition, dietary filters |
| 50 | - Requires API key (free tier: 150 points/day) |
| 51 | - More detailed data but limited calls |
| 52 | |
| 53 | ### Step 4: Make the API Call |
| 54 | |
| 55 | **TheMealDB Example** (search by name): |
| 56 | ``` |
| 57 | https://www.themealdb.com/api/json/v1/1/search.php?s=chicken |
| 58 | ``` |
| 59 | |
| 60 | **Spoonacular Example** (search by ingredients): |
| 61 | ``` |
| 62 | https://api.spoonacular.com/recipes/findByIngredients?ingredients=chicken,broccoli&number=5&apiKey=YOUR_KEY |
| 63 | ``` |
| 64 | |
| 65 | ### Step 5: Present Results |
| 66 | |
| 67 | Format recipes clearly with: |
| 68 | - Recipe name |
| 69 | - Brief description or cuisine type |
| 70 | - Key ingredients |
| 71 | - Cooking time (if available) |
| 72 | - Dietary info (vegetarian, gluten-free, etc.) |
| 73 | - Link to full recipe or instructions |
| 74 | |
| 75 | ## Dietary Restriction Mappings |
| 76 | |
| 77 | | User Says... | API Parameter | |
| 78 | |--------------|---------------| |
| 79 | | "vegetarian" | `diet=vegetarian` | |
| 80 | | "vegan" | `diet=vegan` | |
| 81 | | "gluten-free" | `intolerances=gluten` | |
| 82 | | "dairy-free" | `intolerances=dairy` | |
| 83 | | "keto" or "low-carb" | `diet=ketogenic` | |
| 84 | | "paleo" | `diet=paleo` | |
| 85 | | "nut-free" | `intolerances=tree nut,peanut` | |
| 86 | | "healthy" | `maxCalories=500` or `diet=whole30` | |
| 87 | |
| 88 | ## Cuisine Types |
| 89 | |
| 90 | TheMealDB categories: American, British, Canadian, Chinese, Croatian, Dutch, Egyptian, Filipino, French, Greek, Indian, Irish, Italian, Jamaican, Japanese, Kenyan, Malaysian, Mexican, Moroccan, Polish, Portuguese, Russian, Spanish, Thai, Tunisian, Turkish, Vietnamese |
| 91 | |
| 92 | ## Resources |
| 93 | |
| 94 | ALWAYS read these before making API calls: |
| 95 | - `references/api_reference.md` - Complete API documentation for both services |
| 96 | - `references/dietary_guide.md` - Detailed dietary restriction information |
| 97 | |
| 98 | ## Examples |
| 99 | |
| 100 | ### Example 1: Ingredient-Based Search |
| 101 | User asks: "What can I make with chicken, garlic, and lemon?" |
| 102 | |
| 103 | 1. Load API reference |
| 104 | 2. Use TheMealDB search or Spoonacular findByIngredients |
| 105 | 3. Return 3-5 recipe suggestions with names and key details |
| 106 | |
| 107 | ### Example 2: Dietary Restriction |
| 108 | User asks: "I need gluten-free dinner ideas" |
| 109 | |
| 110 | 1. Load API reference |
| 111 | 2. Use Spoonacular with `intolerances=gluten` |
| 112 | 3. Or use TheMealDB and filter results manually |
| 113 | 4. Highlight that recipes are gluten-free in response |
| 114 | |
| 115 | ### Example 3: Quick Recipe |
| 116 | User asks: "Give me an easy pasta recipe" |
| 117 | |
| 118 | 1. Search TheMealDB for "pasta" |
| 119 | 2. Pick a result with simple ingredients |
| 120 | 3. Provide full recipe with ingredients and instructions |
| 121 | |
| 122 | ### Example 4: Nutrition Query |
| 123 | User asks: "How many calories in chicken alfredo?" |
| 124 | |
| 125 | 1. Search for chicken alfredo recipe |
| 126 | 2. Use Spoonacular nutrition endpoint or estimate |
| 127 | 3. Provide calorie and macro breakdown per serving |
| 128 | |
| 129 | ### Example 5: Random Inspiration |
| 130 | User asks: "What should I cook tonight?" |
| 131 | |
| 132 | 1. Use TheMealDB random endpoint: `/random.php` |
| 133 | 2. Present the recipe with ingredients and instructions |
| 134 | 3. Offer to find alternatives if they don't like it |
| 135 | |
| 136 | ## Notes |
| 137 | |
| 138 | - TheMealDB is completely free with no limits - prefer it for basic searches |
| 139 | - Spoonacular free tier is 150 points/day (searches cost ~1 point each |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
