wazend-skill

Instala el skill de Wazend API para que cualquier agente de IA sepa integrar la API de WhatsApp de Wazend.

Un "skill" es una carpeta con SKILL.md (guía para el modelo) + references/ (detalle bajo demanda). Al instalarlo en tu proyecto, el agente (Claude Code, Cursor, opencode, Codex, Gemini CLI, Windsurf, u otro) detecta el skill y sabe cómo:

• Autenticar peticiones (X-Api-Key) y construir endpoints con tu Base URL.
• Crear/conectar sesiones de WhatsApp (QR o código de emparejamiento).
• Enviar texto, imágenes, audio, documentos, encuestas, ubicaciones y contactos.
• Recibir mensajes e historial, y configurar webhooks con validación HMAC.

Instalación

Tres formas equivalentes:

npx wazend-skill                            # npm (este paquete)
npx skills add ronnaldrangel/wazend-skills  # skills.sh vía GitHub
npx skills add https://portal.wazend.net    # skills.sh vía well-known

Con npx wazend-skill se instala el skill en todos los destinos soportados dentro del proyecto actual:

.agents/skills/wazend/   Claude Code, opencode y agentes compatibles
.claude/skills/wazend/   Claude Code
.cursor/skills/wazend/   Cursor
.opencode/skill/wazend/  opencode
.codex/skills/wazend/    Codex CLI
.gemini/skills/wazend/   Gemini CLI
.windsurf/skills/wazend/ Windsurf

Opciones

npx wazend-skill -g               # instalar globalmente (~), en vez del proyecto
npx wazend-skill --only claude    # solo destinos concretos (claude,cursor,opencode,codex,gemini,windsurf,agents)
npx wazend-skill --list           # ver destinos y estado de instalación
npx wazend-skill --help

Requiere Node.js >= 18. Sin dependencias.

Actualizar

npx wazend-skill@latest

El CLI sobrescribe la carpeta wazend/ en cada destino (idempotente).

Sincronizar las fuentes distribuidas

skill/wazend/ es la fuente única del skill. Tras editarla, sincroniza las copias distribuidas (well-known del frontend y repo de GitHub):

node scripts/sync.mjs

Genera:

• ../wazend2-frontend/public/.well-known/skills/ — servido en https://portal.wazend.net/.well-known/skills/ (incluye index.json).
• ../wazend-skills/skills/wazend/ — repo público de GitHub (skills.sh).

Después de sincronizar: git commit en wazend-skills/, git push, publicar el paquete npm si aplica y desplegar el frontend.

Publicar una nueva versión

npm version patch   # o minor / major
npm publish

Documentación

• Docs de Wazend: https://wazend.net/docs
• Referencia completa para LLMs: https://wazend.net/llms.txt
• Página del skill: https://wazend.net/docs/skill