Saltar al contenido principal
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: 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 y siguen el formato abierto Agent Skills.
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

En una sesión de Claude Code en tu terminal, agrega el marketplace de VelaFi e instala el plugin:
O ejecuta los mismos pasos desde tu shell:
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.

​
Skills disponibles

​
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 antes de salir a producción.
Para reportar un problema con una skill, abre un issue en el repositorio de GitHub. Los issues son públicos, así que nunca incluyas claves de API, secretos, tokens, IDs de comercio ni detalles de transacciones.