Recipes

CLI for AI agents to find recipes for their humans. Uses TheMealDB API. No auth required.

MIT-0 · Free to use, modify, and redistribute. No attribution required.

⭐ 1 · 1.3k · 3 current installs · 3 all-time installs

by@jeffaf

MIT-0

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Suspicious

medium confidence

ℹ

Purpose & Capability

The name/description (recipes using TheMealDB) align with requiring bash, curl, and jq to call and parse the API. However, SKILL.md and the Agent Implementation Notes refer to a local wrapper ({skill_folder}/recipes and scripts/recipes) and README shows git clone instructions (github.com/jeffaf/recipes-skill) even though this package contains no scripts/code — mismatch between claimed runtime artifacts and what is actually provided.

Instruction Scope

Instructions direct the agent to run a local CLI wrapper (e.g., ./recipes search ...) but the wrapper and scripts are not included and there is no install step to create them. The instructions themselves only target TheMealDB (no extra env vars or unrelated system paths), but the missing scripts create ambiguity about what will actually execute at runtime.

ℹ

Install Mechanism

No install specification is provided (lower technical risk). README suggests cloning a GitHub repo as a manual installation step, but that external fetch is not formalized in the skill metadata. The lack of an install spec means the skill, as packaged, won't place any code on disk — yet runtime notes assume code exists.

✓

Credentials

The skill requests no environment variables or credentials, which is proportional for an unauthenticated public-API recipe lookup.

✓

Persistence & Privilege

Skill is not always-enabled and is user-invocable; autonomous invocation is allowed (platform default) but not combined with other high-risk flags. The skill does not request persistent credentials or system-wide config changes.

What to consider before installing

This skill claims to be a thin CLI wrapper around TheMealDB and needs only curl/jq, which is reasonable — but the package as provided contains only README and SKILL.md and does not include the scripts the instructions expect. Before installing or invoking it: (1) ask the publisher to include the actual scripts or add a formal install spec pointing to a verified release (GitHub release URL), (2) if you must clone the referenced repo, inspect the repository code (scripts/recipes and any shell scripts) for unexpected network calls, commands that read system files, or commands that run with elevated privileges, (3) avoid running downloaded scripts as root and do not run code that performs arbitrary remote downloads without review, and (4) prefer a skill package that either contains its code or provides a vetted install URL/release. If the author supplies the missing scripts or a trusted install link, re-evaluate; if not, treat this package as incomplete and avoid executing it.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.0

Download zip

latestvk97ck4qaxryx997841c1twa2v980jcrm

License

MIT-0

Free to use, modify, and redistribute. No attribution required.

Termshttps://spdx.org/licenses/MIT-0.html

Runtime requirements

🍳 Clawdis

Binsbash, curl, jq

SKILL.md

Recipe Lookup

CLI for AI agents to find recipes for their humans. "What can I make with chicken?" — now your agent can help.

Uses TheMealDB API. No account or API key needed.

Usage

"Search for pasta recipes"
"Give me a random dinner idea"
"What Italian dishes can I make?"
"Tell me about meal ID 52772"

Commands

Action	Command
Search	`recipes search "query"`
Get details	`recipes info <meal_id>`
Random meal	`recipes random`
List categories	`recipes categories`
By area/cuisine	`recipes area <area>`

Examples

recipes search "chicken"          # Find chicken recipes
recipes info 52772                # Get full recipe by ID
recipes random                    # Surprise me!
recipes categories                # List all categories
recipes area Italian              # Italian dishes
recipes area Mexican              # Mexican dishes

Output

Search/list output:

[52772] Spaghetti Bolognese — Italian, Beef

Info/random output:

🍽️  Spaghetti Bolognese
   ID: 52772 | Category: Beef | Area: Italian
   Tags: Pasta,Meat

📝 Ingredients:
   • 500g Beef Mince
   • 2 Onions
   • 400g Tomato Puree
   ...

📖 Instructions:
[Full cooking instructions]

🎥 Video: [YouTube URL if available]
📎 Source: [Recipe source if available]

Areas (Cuisines)

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, Ukrainian, Vietnamese

Notes

Uses TheMealDB free API
No authentication required
Meal ID is the database identifier
Filter commands (area) return IDs only — use info for details
Categories endpoint includes descriptions

Agent Implementation Notes

Script location: {skill_folder}/recipes (wrapper to scripts/recipes)

When user asks about recipes/cooking:

Run ./recipes search "ingredient or dish" to find options
Run ./recipes info <id> for full recipe with ingredients and instructions
Run ./recipes random for dinner inspiration
Run ./recipes area <cuisine> to explore by cuisine

Workflow example:

User: "What can I make for dinner?"
1. recipes random  →  Get a random idea
2. recipes info <id>  →  Full recipe details

User: "I want something Italian"
1. recipes area Italian  →  List Italian dishes
2. recipes info <id>  →  Pick one and get full recipe

Don't use for: Nutritional info, calorie counts, dietary restrictions (API doesn't provide this).

Files

2 total

Select a file

Select a file to preview.

Comments

Loading comments…