---
name: ingredient-swap-advisor
description: "Finds working substitutes for a recipe ingredient given your dietary need, availability or flavour goal, with converted quantities and notes on how the dish will change. Use when a cook is missing an ingredient or has a dietary restriction and needs ranked substitutes with exact converted amounts. Do not use for rewriting a full recipe or planning a menu. Related topics: Food, recipe."
---

# Ingredient Swap Advisor

Finds working substitutes for a recipe ingredient given your dietary need, availability or flavour goal, with converted quantities and notes on how the dish will change.

## When to use

Use this skill when a cook is missing an ingredient or has a dietary restriction and needs ranked substitutes with exact converted amounts. Do not use it for rewriting a full recipe or planning a menu.

## Workflow

1. Ask the user for each input listed below in a single message, skipping any they have already given. Where options are listed, offer them, but accept other answers too.
2. State the function the ingredient serves in the dish, until it is named as structure, moisture, fat, acid, binder or flavour.
3. Shortlist three substitutes that replace that function and meet every restriction, until none conflicts with the allergy details.
4. Convert each quantity into the original unit, until every substitute has a number.
5. Describe taste, texture and cook-time effects and side adjustments, until each option has a trade-off line.
6. Rank the options best first and flag when no swap fully works, until the top pick is clear.

## Inputs

- **Ingredient to replace** (free text, e.g. "All-purpose flour or heavy cream")
- **Original quantity** (number from 1 to 9999)
- **Unit** (choose one: grams, kg, ml, liters, cups, tablespoons, teaspoons, ounces, pounds, pieces, cloves, slices)
- **Recipe and the ingredient's role** (longer free text)
- **Reasons for substituting** (choose any: Dietary Restriction, Availability, Flavor Profile Adjustment, Allergy or Intolerance, Healthier Option, Cost Reduction)
- **Diet or restriction** (choose any: Vegan, Vegetarian, Gluten-Free, Dairy-Free, Nut-Free, Low-Carb, Low-Sodium, Keto, Paleo, Sugar-Free)
- **Allergy details** (free text, e.g. "Allergen to avoid")

## Output

The ingredient's function in one line, then three ranked substitutes each with converted amount, effect on the dish, adjustments and restriction check.

## Prompt template

Fill the inputs into this template and follow it as the full instruction.

### Ingredient Swap Advisor

Suggest substitutes for one ingredient and adjust the quantities.

- Ingredient to replace: {{Ingredient to replace}}
- Original quantity: {{Original quantity}}
- Unit: {{Unit}}
- Recipe and the ingredient's role: {{Recipe and the ingredient's role}}
- Reasons for substituting: {{Reasons for substituting}}
- Diet or restriction: {{Diet or restriction}}
- Allergy details: {{Allergy details}}

First state the job the ingredient does in the dish (structure, moisture, fat, acid, binding, flavour), since a good swap replaces the function and not just the name. Offer three substitutes ranked best first. For each give the converted amount in the original unit, what changes in taste and texture, any change to other ingredients or cook time, and whether it meets the stated restriction. If no swap truly replaces the function, say so and suggest changing the recipe step.

## Pitfalls

- Swapping by name rather than function, such as replacing eggs as a binder with something that only adds moisture.
- Giving a one-to-one ratio when the substitute is stronger or absorbs more liquid.
- Ignoring cross-contact risk when the reason is an allergy.
