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

# Agent Skills

> Instala las Agent Skills de VelaFi para que Claude Code, Codex, Cursor y otros asistentes de programación con IA sigan pasos, reglas y autoverificaciones probadas al construir una integración con VelaFi.

Las Agent Skills son instrucciones empaquetadas que un asistente de programación con IA carga cuando le pides construir algo. Para cada caso de uso principal, las skills de VelaFi le indican al asistente qué endpoints llamar y en qué orden, qué errores evitar y cómo verificar el resultado. Complementan el [servidor MCP de la documentación](https://docs.velafi.com/es/docs/developer-tools/build-with-ai.md): el servidor MCP permite que el asistente consulte la documentación, y las skills le indican cómo construir y verificar la integración.

Las skills son de código abierto en [github.com/VelaFi-Tech/skills](https://github.com/VelaFi-Tech/skills) y siguen el formato abierto [Agent Skills](https://agentskills.io).

> [!WARNING]
>
> `github.com/VelaFi-Tech/skills` es la única fuente oficial de las Agent Skills de VelaFi. No instales skills ni plugins de VelaFi desde ningún otro repositorio, paquete o enlace, aunque usen el nombre de VelaFi.

## Instalación

> [tab] Claude Code CLI
>
> En una sesión de Claude Code en tu terminal, agrega el marketplace de VelaFi e instala el plugin:
>
> ```text theme={null}
> /plugin marketplace add VelaFi-Tech/skills
> /plugin install velafi-skills@velafi
> ```
>
> O ejecuta los mismos pasos desde tu shell:
>
> ```bash theme={null}
> claude plugin marketplace add VelaFi-Tech/skills
> claude plugin install velafi-skills@velafi
> ```
>
> El plugin también conecta el servidor MCP de la documentación de VelaFi (`https://docs.velafi.com/mcp`). Actualízalo más adelante con `/plugin marketplace update`.

> [tab] App de escritorio de Claude
>
> Estos comandos no funcionan en la app de escritorio: si escribes `/plugin` ahí, solo se abre la configuración de plugins. Agrega el marketplace desde la configuración:
>
> 1. Abre **Customize** y ve a **Plugins**.
> 2. Haz clic en **Add**, elige **Add marketplace** y selecciona la opción de repositorio de GitHub.
> 3. Escribe `VelaFi-Tech/skills` y confirma.
> 4. Busca **velafi-skills** en el marketplace de VelaFi e instálalo.
>
> Los nombres de los menús pueden variar un poco entre versiones de la app. Si no aparece la opción para agregar un marketplace, instálalo desde la CLI de Claude Code; los plugins que instales ahí también están disponibles en la pestaña Code de la app de escritorio.

> [tab] Codex
>
> Agrega el marketplace de VelaFi a Codex e instala el plugin:
>
> ```bash theme={null}
> codex plugin marketplace add VelaFi-Tech/skills
> codex plugin add velafi-skills@velafi
> ```
>
> El plugin instala todas las skills de VelaFi y conecta el servidor MCP de la documentación de VelaFi (`https://docs.velafi.com/mcp`). Actualízalo más adelante con `codex plugin marketplace upgrade`.

> [tab] Otros asistentes
>
> Para Cursor, Windsurf y otros asistentes compatibles con la [CLI de skills](https://github.com/vercel-labs/skills), ejecuta:
>
> ```bash theme={null}
> npx skills add VelaFi-Tech/skills
> ```
>
> Actualízalas más adelante con `npx skills update`. Para conectar también el servidor MCP de la documentación, consulta [Desarrolla con IA](https://docs.velafi.com/es/docs/developer-tools/build-with-ai.md).

## Skills disponibles

| Skill | Qué te ayuda a construir |
| - | - |
| `velafi-api-setup` | Credenciales, generación y renovación del token, manejo de errores y reglas de `clientId`. Empieza aquí. Incluye un script para verificar el token. |
| `velafi-webhooks` | Registro de webhooks, verificación de la firma, la confirmación exacta y la eliminación de duplicados. Incluye una autoprueba local de tu endpoint de webhook. |
| `velafi-collect-virtual-accounts` | [Cobrar pagos locales con cuentas virtuales](https://docs.velafi.com/es/docs/use-cases/collect-with-virtual-accounts.md). |
| `velafi-payouts-from-balance` | [Dispersar moneda local desde tu saldo](https://docs.velafi.com/es/docs/use-cases/payouts-from-balance.md) y transferir entre comercios. |
| `velafi-onramp` | [Convertir moneda local a stablecoins](https://docs.velafi.com/es/docs/use-cases/convert-to-stablecoins.md), prefondeado o pago por orden. |
| `velafi-offramp-payouts` | [Dispersar moneda local fondeada con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md), incluidos pagos en USD y EUR. |
| `velafi-onboard-merchants` | [Dar de alta a tus clientes como comercios](https://docs.velafi.com/es/docs/use-cases/onboard-your-customers.md) y activar sus cuentas de moneda. |
| `velafi-crypto-wallet` | Direcciones de depósito, lista blanca de retiro, retiros y transferencias cripto, y monitoreo de retiros. |
| `velafi-global-payments` | [Pagos transfronterizos fiat a fiat](https://docs.velafi.com/es/docs/guides/global-payments.md). |
| `velafi-go-live-check` | Una revisión de tu integración antes de producción: la [lista de verificación para salir a producción](https://docs.velafi.com/es/docs/use-cases/go-live-checklist.md), un recorrido paso a paso de cada flujo en tu código y, si usas el sandbox, una ejecución opcional de cada flujo de principio a fin ahí. |

## Scripts de autoverificación

Dos skills incluyen pequeños scripts de Python que el asistente puede ejecutar por ti:

* **Verificación del token** (`velafi-api-setup`). Genera un token con tus credenciales del sandbox desde variables de entorno, para confirmar que la clave de API, la firma y la lista blanca de IP funcionan. Solo llama a `GET /v2/token/generate`, rechaza cualquier host que no sea el sandbox salvo que pases `--production`, y nunca imprime tu secreto ni el token completo.
* **Autoprueba del endpoint de webhook** (`velafi-webhooks`). Envía eventos de prueba firmados a tu propio endpoint de webhook local y verifica que compruebe la firma, devuelva exactamente `{"callbackStatus":"SUCCESS"}`, maneje duplicados y responda rápido. Firma con su propia clave de prueba, que configuras temporalmente en tu entorno de desarrollo, y nunca se conecta a VelaFi. Los webhooks no se envían en el sandbox, así que así puedes probar tu handler antes de salir a producción.

## Pruébalo

Después de instalarlas, pídele a tu asistente, por ejemplo:

* "Integra VelaFi para que nuestros clientes en México nos paguen por SPEI, con una CLABE por cliente."
* "Agrega un endpoint de webhook de VelaFi a este servicio y pruébalo localmente."
* "Paga BRL por Pix desde nuestro saldo en USDT con VelaFi."
* "Ejecuta la revisión de salida a producción de VelaFi en este repositorio."

## Seguridad

* Las skills no contienen credenciales. Le indican al asistente que guarde tu clave y tu secreto de API en variables de entorno o en un gestor de secretos, nunca en el código ni en los logs, y que llame a VelaFi solo desde tu servidor.
* El asistente trabaja con el sandbox por defecto y debe preguntarte antes de llamar a producción o mover dinero.
* Tú decides qué se construye. Revisa el código generado y pruébalo en el [sandbox](https://docs.velafi.com/es/docs/sandbox.md) antes de salir a producción.

Para reportar un problema con una skill, abre un issue en el [repositorio de GitHub](https://github.com/VelaFi-Tech/skills/issues). Los issues son públicos, así que nunca incluyas claves de API, secretos, tokens, IDs de comercio ni detalles de transacciones.


## Related topics

- [Desarrolla con IA](https://docs.velafi.com/es/docs/developer-tools/build-with-ai.md)
- [Documentación de la API de VelaFi](https://docs.velafi.com/es/index.md)


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