> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nubea.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill para Claude Code y Codex

> Un archivo que le enseña a tu agente de código cómo trabajar con tu tienda a través de Nubea, con las guías y flujos del servidor MCP.

El servidor MCP ya le entrega a cualquier cliente las guías de buenas
prácticas y los flujos listos (ver [Conectar por MCP](/api/conectar-mcp#guias-y-flujos-listos)).
Esta skill es el complemento para agentes de código: le dice a Claude Code o a
Codex cuándo usar Nubea, qué leer primero y qué nunca hacer sin preguntarte.

<Note>
  La skill no reemplaza la conexión MCP. Primero
  [conectá el servidor](/api/conectar-mcp); la skill solo mejora cómo lo usa el
  agente.
</Note>

## Claude Code

Creá el archivo `.claude/skills/nubea/SKILL.md` en tu proyecto (o en
`~/.claude/skills/nubea/SKILL.md` para tenerlo en todos) con este contenido:

```markdown theme={null}
---
name: nubea
description: Operate the merchant's Nubea store (WhatsApp marketing, campaigns, automations, inbox, storefront widgets, sales attribution) through the Nubea MCP server. Use whenever the user asks about their store's sales, customers, campaigns, automations, WhatsApp, widgets or subscription.
---

# Working with a Nubea store

You have the `nubea` MCP server. It exposes four tools (`list_operations`,
`describe_operation`, `read_operation`, `write_operation`), four guides and
four prompts. Everything is scoped to one store and acts with the role of the
person who created the key.

## Before anything else
1. Open the guide that matches the topic, from the server's resources:
   - `nubea://guides/whatsapp-best-practices` before drafting any message.
   - `nubea://guides/sales-attribution` before reporting revenue.
   - `nubea://guides/segmentation-and-campaigns` before proposing a campaign.
   - `nubea://guides/limits-and-safety` before any write that cannot be undone.
2. Prefer the server prompts when the request matches: `weekly_review`,
   `plan_campaign`, `diagnose_automation`, `prepare_sale_event`.
3. `list_operations` to find the operation, `describe_operation` to see its
   input schema, then call it. Read the current object before changing it and
   send the same shape back.

## Rules
- Confirm with the user, in their words, before sending or scheduling a
  campaign, executing an automation, sending a message, publishing a
  storefront change, deleting anything or touching the subscription. Drafts
  are free; sends need an explicit yes.
- Never retry a failed write on your own. Read the state first.
- Never invent a number, product or customer. Report attributed revenue as
  "attributed", with the period and the source.
- Respect quiet hours (22:00-08:00 store time), opt-outs and the number's
  daily limit. Check `GET /kapso/phone-health` before proposing a send size.
- Connecting WhatsApp and paying for a plan finish in the browser: hand over
  the link and stop.

## Answering
Answer in the user's language with their real numbers. Short. Name the period.
When you propose an action, name the operation you would call.
```

Para verificar, escribí `/mcp` en Claude Code: Nubea tiene que figurar
conectado, y los prompts del servidor aparecen como comandos
`/mcp__nubea__weekly_review`, `/mcp__nubea__plan_campaign`, etc.

## Codex

Codex no tiene skills, pero lee `AGENTS.md`. Agregá esta sección al
`AGENTS.md` de tu proyecto:

```markdown theme={null}
## Nubea

The `nubea` MCP server operates the merchant's store. Before acting, read the
guide that matches the topic from its resources (whatsapp-best-practices,
sales-attribution, segmentation-and-campaigns, limits-and-safety) and prefer
its prompts (weekly_review, plan_campaign, diagnose_automation,
prepare_sale_event). Use list_operations → describe_operation → read/write.
Confirm before sending, scheduling, executing, publishing, deleting or
changing the subscription. Never retry a failed write. Never invent data.
```

## Qué cambia con la skill

Sin la skill, el agente igual recibe las instrucciones del servidor al
conectarse y puede abrir las guías. La skill agrega dos cosas: que el agente
sepa que Nubea es la herramienta para "mi tienda" aunque no lo menciones, y
que aplique las reglas de confirmación en su propio flujo de trabajo, no solo
cuando el servidor se lo recuerda.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.