Skills para agentes

Qué es una skill#

Una skill es un paquete de instrucciones (un SKILL.md más sus referencias) que el agente carga sólo cuando el comercio le pide algo de ese tema. No requiere código ni credenciales: usa el MCP de Tilopay que ya está conectado, y las instrucciones le dicen qué herramientas llamar, en qué orden y cómo validar los números antes de responder.

La diferencia con las recetas es que la receta es el ejemplo de prompt; la skill lo deja empaquetado y repetible, con reglas de cálculo y de seguridad.

Antes de empezar#

Necesitás una cuenta de Tilopay. Si instalás el plugin (opción 2 de abajo), el conector del MCP viene incluido y solo tenés que autorizarlo con tu cuenta la primera vez. Para las demás opciones, primero conectá el MCP en tu cliente. Las skills no piden ni guardan credenciales.

Skills disponibles#

/plugin marketplace add tilopay/claude-plugins
/plugin install tilopay-mcp-skills@tilopay

Lee https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Dame el cierre de caja de hoy

Lee https://tilopay.com/developers/skills/cobrar-por-whatsapp/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Cóbrale 25 mil colones a Ana por el curso de fotografía

Lee https://tilopay.com/developers/skills/rechazos-y-recuperacion/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. ¿Por qué me rechazaron pagos este mes y cuáles puedo recuperar?

Lee https://tilopay.com/developers/skills/conciliacion-mensual/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Concíliame septiembre para el contador

Lee https://tilopay.com/developers/skills/cfo-de-bolsillo/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. ¿Cómo voy este mes comparado con el anterior?

Lee https://tilopay.com/developers/skills/catalogo-y-cobros-fijos/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Agregá al catálogo Clase de yoga a 8 mil colones

Cómo instalar#

Opción 1 · Usarla ahora mismo, sin instalar nada (Claude, ChatGPT u otro asistente con el MCP conectado).

1. Abrí una conversación nueva con el MCP de Tilopay conectado.
2. En la tarjeta de la skill, tocá «Copiar prompt».
3. Pegalo y enviá. El asistente lee las instrucciones desde tilopay.com y las aplica en esa conversación. La próxima vez, volvé a pegar el prompt (o usá la opción 2 para dejarla fija).

Por ejemplo, el prompt del cierre de caja:

Lee https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md y los archivos que referencia, y sigue esas instrucciones usando mi conector de Tilopay. Dame el cierre de caja de hoy

Opción 2 · Instalar las seis de una vez en Claude (recomendada).

Tilopay publica sus skills como un plugin en GitHub. Se agrega una sola vez y queda guardado en tu cuenta: sirve en Cowork, en el chat de claude.ai y en Claude Code. El plugin incluye el conector del MCP de Tilopay: la primera vez que lo uses, Claude te pide autorizarlo con tu cuenta de Tilopay (en Cowork, desde la pestaña Connectors del plugin).

En la app de Claude (Cowork):

1. Abrí la pestaña Cowork y luego Customize en la barra lateral.
2. Entrá a Plugins y hacé clic en Add → Add marketplace → Add from a repository.
3. Escribí tilopay/claude-plugins y confirmá.
4. Volvé a Discover, elegí tilopay-mcp-skills y hacé clic en Install.

En Claude Code (terminal), dos comandos:

/plugin marketplace add tilopay/claude-plugins
/plugin install tilopay-mcp-skills@tilopay

Desde ese momento, cuando pidas algo del tema («dame el cierre de caja de hoy») con el MCP de Tilopay conectado, Claude carga la skill sola. Para recibir mejoras, en el marketplace usá Check for updates o activá Sync automatically (en Claude Code: /plugin marketplace update tilopay).

Los plugins están disponibles en los planes de pago de Claude. Si tu organización limita qué marketplaces se pueden agregar, un Owner debe permitir tilopay/claude-plugins o sincronizarlo para todos desde la configuración de la organización.

Opción 3 · Instalar una sola skill (claude.ai web y escritorio).

La forma más simple sin instalar nada: creá un Proyecto en Claude, abrí el SKILL.md de la skill (enlace de la tarjeta), copiá todo el contenido y pegalo en las instrucciones del proyecto. Para que el asistente la use en cualquier conversación, pegá el prompt de la opción 1 cuando lo necesites.

Opción 4 · A mano en Claude Code (sin marketplace).

Pegá este prompt en Claude Code:

Lee el índice de skills de Tilopay en https://tilopay.com/developers/skills/index.md, crea una carpeta por skill dentro de ~/.claude/skills/ con el nombre de la skill, guarda el SKILL.md de cada una dentro de su carpeta y luego dime qué skills quedaron instaladas.

El prompt le pide a Claude Code crear una carpeta por skill dentro de ~/.claude/skills/ (o en .claude/skills/ del proyecto para compartirla con tu equipo), usando el SKILL.md publicado de cada una.

Otros clientes MCP. Usá el SKILL.md como instrucciones del sistema o del proyecto, o pegá el prompt de la opción 1.

Cómo funciona por dentro#

Con el cierre de caja como ejemplo, la secuencia es:

1. El agente convierte "hoy" a la hora local del comercio.
2. Llama tilopay_list_transactions con ese rango expresado en UTC.
3. Clasifica cada fila sólo por code: 1 es aprobada y 1101 es reembolso.
4. Suma los seis campos de costo con su nombre exacto: commission, iva_commission, rent, retention_iva, cost e iva_tilopay.
5. Valida que bruto − deducciones = neto y lo cruza con tilopay_settlement_balance antes de responder.

Crear tu propia skill#

La estructura mínima de un SKILL.md es un frontmatter con name y description, seguido del procedimiento:

---
name: mi-skill
description: Qué hace la skill y cuándo debe usarla el agente.
---

1. Paso del procedimiento, con la herramienta exacta que se llama.
2. Regla de validación antes de responder.

Tres consejos:

1. Nombrá las herramientas exactas que el agente tiene que llamar.
2. Poné las reglas de validación de los números.
3. Decí qué NO hacer.

Para conocer todas las herramientas disponibles, consultá el manifiesto /developers/mcp.json. Si armaste una skill útil para otros comercios, enviala a soporte@tilopay.com.