# Guides

> Show a recipe, workout, how-to, checklist or trip itinerary as an interactive card. Use for recipes and cooking or baking, workouts, fixing, installing or setting something up, shopping, packing or to-do lists, and travel plans.

- Skill: `amd/guides` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx get-skill add amd/guides`
- Raw SKILL.md: https://api.skillmd.com/api/skills/amd/guides/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: amd (https://skillmd.com/u/amd)
- Updated: 2026-11-16
- Page: https://skillmd.com/skills/amd/guides

---


# Guides

Draws the answer as a `guide` card in the Agent UI and the TUI: a recipe the
user can scale and cook along with, a workout with timers, how-to steps to tick
off, a checklist, or a day-by-day itinerary. The card shows every line, so the
written reply stays short.

## Procedure

1. **Pick the tool that matches the request.**
   - A dish to cook or bake → `guides/show_recipe` (title, servings,
     ingredients, steps).
   - An exercise routine or training plan → `guides/show_workout`.
   - Fixing, repairing, installing or setting something up →
     `guides/show_how_to`.
   - A shopping, packing or to-do list → `guides/show_checklist`.
   - A trip plan or day-by-day schedule → `guides/show_itinerary`, one line per
     day, the day and place first.
2. **Write the whole guide yourself.** One line per ingredient, item or step,
   amounts and durations inline ("2 cups flour", "Simmer 15 minutes"). Do not
   ask the user for the ingredients or the steps of a well-known dish or task.
3. **If the call returns `"ok": false`, fix what its `error` names and call the
   same tool again.** Never paste the guide as text instead — a failed call
   shows no card.
4. **After the card is shown, reply with one or two short sentences of tips.**
   Do not repeat the list or the steps: the user already sees them.

## Notes

- Lines are shown as plain text, never as HTML or Markdown, so write words, not
  markup.
- Limits: a title up to 120 characters, up to 100 items, 60 steps, and 500
  characters per line. Servings run from 1 to 99.

