ClawHub

masterchef

Recipe and ingredient query assistant. Use when users ask how to cook X, X recipe, what can I make with X, I have X what can I cook, how to make X, or mention cooking, recipe, ingredients, dish, food preparation, meal, cuisine. Supports searching by ingredients or by dish name. Also triggers on Chinese keywords: 怎么做X, 做法, 食材, 菜谱, 做菜, 烹饪, 料理, 食谱.

Audits

Pass
ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install masterchef

MasterChef - Recipe Assistant

MasterChef is a cooking assistant powered by the api.yummy.chat recipe knowledge base.

Overview

MasterChef provides two core features:

  1. Ingredient Search: Tell me what ingredients you have (1-3 items), and I'll show you what dishes you can make
  2. Recipe Lookup: Tell me a dish name, and I'll give you the full recipe

When to Use This Skill

Activate this skill when the user's request involves:

  • Asking about recipes: "how to make mapo tofu", "recipe for cola chicken wings", "how to cook fried rice"
  • Asking about ingredient pairings: "what can I make with eggplant and potato", "I have chicken wings, what can I cook"
  • Expressing cooking intent: "want to eat braised pork", "what should I cook today"
  • Mentioning cooking keywords: recipe, cooking, ingredients, dish, meal, cuisine, food prep

Language Handling (IMPORTANT)

The API only accepts Chinese input and returns Chinese output. You must handle translation:

  1. Input translation: If the user writes in English, translate ingredient names or dish names to Chinese before calling the API

    • "eggplant" → "茄子", "potato" → "土豆", "chicken wings" → "鸡翅"
    • "cola chicken wings" → "可乐鸡翅", "mapo tofu" → "麻婆豆腐"
    • "how to make stir-fried eggplant" → dish_name: "烧茄子"

  2. Output translation: Translate the full API response back to the user's language (English)

    • Translate dish names, ingredient lists, cooking steps, tips, and all other content
    • Preserve the original structure and formatting
    • Do NOT omit or add any information during translation

If the user writes in Chinese, no translation is needed — pass Chinese directly to the API and return Chinese output as-is.

API Endpoints

1. Ingredient Search API

Endpoint: POST https://api.yummy.chat/ingredients

Purpose: Query dishes that can be made with 1-3 ingredients

Request format:

{
  "ingredients": ["食材1", "食材2", "食材3"]
}

Response format:

{
  "results": [
    {
      "ingredient": "茄子",
      "dishes": ["地三鲜", "油焖茄子", "茄子煎饼", ...]
    }
  ]
}

2. Recipe Lookup API

Endpoint: POST https://api.yummy.chat/howtocook

Purpose: Query detailed recipe by dish name (ingredients, steps, tips)

Request format:

{
  "dish_name": "菜名"
}

Response format:

{
  "dish_name": "地三鲜",
  "recipes": [
    "地三鲜\n所属菜系：东北菜\n烹饪难度：⭐⭐⭐\n\n食材与调味品\n..."
  ]
}

Usage Guide

Detecting User Intent

Ingredient search mode — when the user:

  • Mentions "I have", "I've got", "in my fridge"
  • Asks "what can I make with X", "what to cook with X"
  • Lists multiple ingredient names

Recipe lookup mode — when the user:

  • Asks "how to make X", "recipe for X", "how to cook X"
  • Says "want to eat X", "make some X"
  • Mentions a specific dish name

Priority: If unsure, try recipe lookup first (it's more specific).

1. Ingredient Search Mode

Steps:

  1. Extract ingredient names: Identify 1-3 ingredients from user input

    • Example: "I have eggplant and potato" → ["茄子", "土豆"]
    • Example: "what can I make with chicken wings" → ["鸡翅"]

  2. Call API:

curl -s -X POST https://api.yummy.chat/ingredients \
  -H "Content-Type: application/json" \
  -d '{"ingredients": ["食材1", "食材2"]}'

  1. Parse response: Extract dishes list from each ingredient in results

  2. Translate and format output: See "Output Format Guide" below

2. Recipe Lookup Mode

Steps:

  1. Extract dish name: Identify the dish name from user input

    • Example: "how to make Di San Xian" → "地三鲜"
    • Example: "want to eat cola chicken wings" → "可乐鸡翅"

  2. Call API:

curl -s -X POST https://api.yummy.chat/howtocook \
  -H "Content-Type: application/json" \
  -d '{"dish_name": "菜名"}'

  1. Parse response: Extract recipe content from recipes array

  2. Translate and format output: See "Output Format Guide" below

Output Format Guide

Ingredient Search Results

Principles:

  • Group results by ingredient
  • Highlight dishes that use multiple queried ingredients together
  • Use emoji for readability
  • Categorize (recommended, quick & easy, advanced, etc.)
  • Translate all dish names and descriptions to the user's language

Recipe Lookup Results

Principles:

  • Show the most common/standard version first: If the API returns multiple versions, only display the first one (typically the most standard)
  • Return the full recipe as-is: Do not omit or add any information — translate the complete API response faithfully
  • If multiple variants exist, briefly mention them without expanding

Error Handling

HTTP 404 - Recipe Not Found

The dish name doesn't exist in the knowledge base. Tell the user the recipe wasn't found, suggest checking the spelling or trying an alternative name.

HTTP 422 - Parameter Error

Invalid input (wrong number of ingredients, empty string). Guide the user to provide 1-3 ingredient names or a specific dish name.

HTTP 502 - Service Error

The backend knowledge base service is unavailable. Ask the user to try again later.

Network Error

Cannot connect to api.yummy.chat. Suggest checking the network connection.

Examples

Example 1: Ingredient Search (English)

User: "I have eggplant and potato, what can I make?"

MasterChef behavior:

  1. Detect ingredient search mode
  2. Translate ingredients: ["茄子", "土豆"]
  3. Call /ingredients API
  4. Translate dish names to English
  5. Highlight combined dishes like Di San Xian (地三鲜)

Example 2: Recipe Lookup (English)

User: "How to make Di San Xian?"

MasterChef behavior:

  1. Detect recipe lookup mode
  2. Translate dish name: "地三鲜"
  3. Call /howtocook API
  4. Translate the full recipe to English (ingredients, steps, tips, health advice)

Example 3: Chinese Input (No Translation Needed)

User: "地三鲜怎么做"

MasterChef behavior:

  1. Detect recipe lookup mode
  2. Call API with "地三鲜" directly
  3. Return Chinese output as-is

Technical Details

API

  • Base URL: https://api.yummy.chat
  • Protocol: HTTPS
  • Response format: JSON
  • Chinese-only API: All input/output is in Chinese

Tools

  • Uses Bash tool to execute curl commands
  • Pre-authorized in allowed-tools to reduce permission prompts

Translation

  • Agent handles all translation (input → Chinese, output → user's language)
  • No external translation API needed — the agent translates using its own language capabilities
  • Preserve emoji, formatting, and structure during translation