Skill para Claude Code

Instalar la skill para Claude Code

Instala una skill (un archivo SKILL.md) que le explica a Claude Code cómo usar el CLI de Plazbot: qué comandos hay, cómo leer su JSON, cuándo pedir confirmación y qué endpoints consultar con plazbot api. Con la skill instalada puedes pedirle cosas como "¿por qué falló la última campaña?" o "busca el contacto +51912345678 y muéstrame su conversación", y Claude las resuelve con el CLI.

01plazbot skill install [opciones]
02plazbot skill show

Parámetros

plazbot skill show imprime la skill en Markdown, sin instalarla.

Ejemplos

01# Instalar para todos los proyectos (~/.claude/skills/plazbot-cli)
02plazbot skill install
03 
04# Instalar solo en este repositorio
05plazbot skill install --project
06 
07# Leer la skill
08plazbot skill show

Resultado

01  Skill installed: /Users/tu/.claude/skills/plazbot-cli/SKILL.md
02  Claude Code loads it in new sessions. Try: "list my latest Plazbot campaigns".

Claude Code carga la skill en las sesiones nuevas. Si ya existía una versión distinta, el CLI pide confirmar el reemplazo. Al actualizar el CLI, vuelve a ejecutar plazbot skill install para tener la skill de la nueva versión.

Salida JSON

01{
02  "installed": true,
03  "path": "/Users/tu/.claude/skills/plazbot-cli/SKILL.md",
04  "updated": false
05}

updated es true cuando reemplazó una skill anterior distinta.

Qué le enseña la skill

• Usar siempre --json y leer los errores de stderr ({"error": {...}}, código de salida 1).
• Empezar con plazbot whoami --verify --json para comprobar la sesión.
• Descubrir comandos con plazbot commands --json antes de adivinar.
• Leer libremente y escribir solo cuando el usuario pidió ese cambio, agregando --yes únicamente para esa acción.
• Trabajar con varios workspaces con -w y -z, y paginar con --limit, --cursor y --all.
• Una tabla con los comandos propios, los endpoints útiles para plazbot api, los prefijos de ID (con_, cam_, mot_...) y recetas de soporte.

Recomendado: sesión de solo lectura

Para que un agente de IA trabaje sin riesgo de cambiar datos, inicia sesión con un token de solo lectura:

01plazbot login --read-only
02plazbot skill install

Con ese token la API solo acepta consultas (GET). Cualquier cambio falla con el código read_only. Más detalles en Usar el CLI con IA y scripts.

Errores comunes