Skill para agentes de código

Un skill es un conjunto de instrucciones que tu agente de código carga cuando una tarea lo necesita. El skill de AZbox enseña a Claude Code, Cursor, Codex, Gemini CLI y otros agentes a integrar AZbox en un proyecto sin adivinar: qué paquete instalar, qué métodos existen, cómo descargar las traducciones a ficheros y qué hacer con los textos nuevos. Es de código abierto (GitHub) y sigue el estándar Agent Skills.

Por qué ayuda

Los agentes escriben bien código y saben poco de los detalles de un producto que no han visto nunca. Sin el skill tienden a instalar paquetes que no existen, llamar a métodos que nunca se escribieron o intentar crear claves con una API que no lo permite. El skill les da los datos, comprobados contra los paquetes publicados y la API en producción.

Instalación

Cualquier agente

npx skills add azbox-io/azbox-skills

Detecta los agentes que tienes instalados y añade el skill a cada uno.

Claude Code, como plugin

/plugin marketplace add azbox-io/azbox-skills
/plugin install azbox@azbox

A mano

Copia la carpeta skills/azbox/ del repositorio en tu proyecto, dentro de .claude/skills/, .cursor/skills/ o .agents/skills/. Haz commit y todo el equipo lo tendrá.

Uso

No hace falta llamarlo. Pide la tarea y el agente carga el skill cuando sale AZbox o la localización:

• «Localiza la pantalla de ajustes con AZbox»
• «Configura AZbox en esta app de Flutter»
• «Descarga las traducciones en español y francés a locales/ en CI»
• «Sustituye los textos escritos a mano en el flujo de pago»

Qué hará el agente

• Usar la integración que encaja con el stack: el SDK de Flutter, ficheros descargados con el CLI para todo lo que tenga su propia librería de i18n, o la API REST desde un servidor.
• Mantener tu librería de i18n y alimentarla desde AZbox, en lugar de sustituirla.
• Buscar una clave existente antes de inventar otra.
• Añadir los textos nuevos a tu fichero fuente (ARB, JSON…) y decirte qué fichero importar. Las claves se crean en el panel o importando un fichero; la API no las escribe.
• Mantener las claves de API fuera del repositorio.

Úsalo junto al servidor MCP

El skill le dice al agente cómo trabajar con AZbox. El servidor MCP le deja leer tu proyecto: buscar la clave detrás de un texto o ver qué falta por traducir. Con los dos, el agente reutiliza tus claves reales en lugar de crear duplicados.