Ingredient Swap Advisor skill for Claude and Codex
Finds working substitutes for a recipe ingredient given your dietary need, availability or flavour goal, with converted quantities and notes on how the dish…
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
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.
What it will ask you for
- 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")
How it works
- State the function the ingredient serves in the dish, until it is named as structure, moisture, fat, acid, binder or flavour.
- Shortlist three substitutes that replace that function and meet every restriction, until none conflicts with the allergy details.
- Convert each quantity into the original unit, until every substitute has a number.
- Describe taste, texture and cook-time effects and side adjustments, until each option has a trade-off line.
- Rank the options best first and flag when no swap fully works, until the top pick is clear.
What you get
The ingredient's function in one line, then three ranked substitutes each with converted amount, effect on the dish, adjustments and restriction check.
What it watches out for
- 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.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.