# Recipes

> An agent fits in a YAML file — title, description, instructions and channels. The eight house recipes, how to upload yours and how to export an agent's.

URL: https://www.ghosty.studio/en/docs/getting-started/recipes

A **recipe** is an agent in a file: who it is, how it talks, what it does and does not do, and which channels it works on. Drop it in the creator and you get an agent; export it from an existing agent and take it to another account or a repo.

## The format

It is the [Goose](https://block.github.io/goose/) recipe format, with an `x-ghosty` section for what is ours:

```yaml
version: "1.0.0"
title: Soporte al cliente
description: Resuelve dudas y problemas frecuentes con la documentación del negocio.
instructions: |
  Eres el agente de soporte del negocio. Resuelves dudas de uso, problemas frecuentes y
  preguntas sobre cuentas y pagos.

  ## Cómo hablas
  Español de México, claro y paciente. Primero confirmas que entendiste el problema en una
  frase; luego das los pasos, numerados y cortos.

  ## Qué NO haces
  - No adivinas: si la documentación no lo cubre, lo dices y escalas.
  - No pides contraseñas ni datos de tarjeta.
x-ghosty:
  engine: claude
  channels: { teams: true }
```

| Field | What it is |
|---|---|
| `title`, `description` | Name and "what it is for"; shown on the card and in the list. |
| `instructions` | The full identity, in markdown. It is what the agent reads on boot. |
| `x-ghosty.engine` | `claude`, `deepseek`, `goose` or `ghosty-lite`. |
| `x-ghosty.channels` | `{ teams: true, whatsapp: true }` — where it works from birth. |
| `settings`, `extensions` | Optional, from the Goose format; kept if present. |

No secrets: a recipe never carries keys or tokens.

## The eight house recipes

In **New agent → Plantilla**:

| Recipe | Channel | For |
|---|---|---|
| Asistente del equipo | Teams | Documents, summaries, emails and the day's tasks. |
| Soporte al cliente | Teams | Frequent questions and problems using the business's documentation. |
| Ventas por WhatsApp | WhatsApp | Serve, quote, schedule; hand over to a person when needed. |
| Citas y agenda | WhatsApp | Book, confirm and reschedule: clinic, salon, workshop, law office. |
| Cobranza y recordatorios | WhatsApp | Tactful payment reminders, receipt confirmation, escalate what gets stuck. |
| Contenido y redes | Teams | Posts, emails and copy in the brand's voice; calendar and variants. |
| RRHH y onboarding | Teams | Policies, benefits, internal procedures; guide newcomers. |
| Dev en el repo | Teams + editor | Code in your repository: read, change, test, open PRs. Goose engine. |

Picking one fills the form and **the identity is editable** before creating.

## Upload yours

In **New agent → Plantilla**, drop the `.yaml` in the zone at the bottom (or click to pick it). If a field is wrong, the creator says so before creating. Ask your coding agent for the recipe with the prompt above: it knows the format.

## Export an agent's recipe

On any agent's card, **Descargar receta** returns its `recipe.yaml` with name, description, identity, engine and channels, without secrets. Use it to copy an agent to another account, version it in a repo or hand it to a client.

## What a recipe is not

Knowledge files, skills and MCP servers do not travel in the recipe: they belong to the agent's machine and are given through the [configuration API](/en/docs/configure).