Desarrollar con Claude Code

Claude Code es el agente de programación con IA de Anthropic. IronFlock publica un plugin para él con la skill ironflock-templates, que enseña al agente cómo se integra una app en IronFlock. Con ella, Claude Code escribe los archivos de la carpeta .ironflock/ de tu app tal como los espera la plataforma y los comprueba antes de que publiques un release:

Archivo	Qué puede hacer el agente
`board-template.yml`	Crear el panel de la app: elegir widgets, enlazarlos a tus tablas, organizar las páginas y la navegación
`data-template.yml`	Definir tablas y transformaciones que coincidan con lo que publica tu código
`env-template.yml`	Añadir parámetros de la app
`port-template.yml`	Declarar puertos para el acceso remoto
`ai-template.yml`	Definir los agentes de IA de la app y sus herramientas

El plugin es público en GitHub: IronFlock/agent-skills.

Qué contiene la skill

Los esquemas JSON de las cinco plantillas — los mismos que se publican en https://ironflock.com/schemas/.
Una guía de la plantilla de panel: enlace de datos, filtros, agregación, páginas, navegación y diseño.
Un catálogo de todos los widgets de panel, que describe para qué datos está pensado cada widget.
Una herramienta que lee el esquema de configuración de un widget para la versión exacta del widget que usa un panel.
Un validador que comprueba cada plantilla frente a su esquema y frente a las reglas que, de otro modo, la plataforma solo señala al instalar — por ejemplo, un widget enlazado a una columna que no existe.

Requisitos

Claude Code — consulta la guía de instalación de Anthropic.
Python 3.9 o posterior para el validador. Se recomienda uv: con él, el validador instala sus propias dependencias. Sin uv, ejecuta una vez python3 -m pip install pyyaml jsonschema.
Acceso a internet a registry.npmjs.org y cdn.jsdelivr.net, donde se publican los esquemas de los widgets.

Instalar la skill

Añade el marketplace de plugins de IronFlock y luego instala el plugin desde él — ya sea dentro de Claude Code o desde una terminal:

En Claude Code


/plugin marketplace add IronFlock/agent-skills
/plugin install ironflock@ironflock

El plugin se instala para tu cuenta de usuario, así que Claude Code puede usarlo en cualquier proyecto. Se carga en las sesiones nuevas; en una sesión que ya está en curso, escribe /reload-plugins. Para comprobar la instalación, ejecuta claude plugin list — la lista incluye ironflock@ironflock.

Mantenerlo actualizado

Claude Code solo actualiza los plugins de marketplaces de terceros si activas esa opción. Actívala una vez: ejecuta /plugin en Claude Code, abre Marketplaces, selecciona ironflock y elige Enable auto-update. O actualízalo a mano:


claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

Configurarlo para tu equipo

Para poner el plugin a disposición de todos los que trabajan en una app, haz commit de este archivo en el repositorio de la app como .claude/settings.json:


{
  "extraKnownMarketplaces": {
    "ironflock": {
      "source": { "source": "github", "repo": "IronFlock/agent-skills" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": { "ironflock@ironflock": true }
}

Claude Code aplica el archivo en cuanto un miembro del equipo confía en la carpeta.

Usar la skill

No necesitas invocar la skill. Claude Code la usa por su cuenta cuando trabajas en una app de IronFlock — por ejemplo, cuando le pides:

“Añade a esta app un panel que muestre la temperatura actual de cada máquina en un indicador y en una tendencia de 24 horas.”
“Haz que el intervalo de muestreo se pueda configurar por dispositivo, entre 1 y 60 segundos.”
“Haz que la interfaz web del puerto 8080 esté disponible para el acceso remoto.”

Para iniciar la skill de forma explícita, escribe /ironflock:ironflock-templates.

Claude Code lee primero el código de tu app, para que las tablas coincidan con lo que publica el código. Luego escribe las plantillas y ejecuta el validador hasta que no quede ningún error. Después puedes abrir el panel en el UI Builder para ajustarlo visualmente — el UI Builder lee y escribe el mismo board-template.yml.

La skill solo modifica archivos del repositorio de tu app. Publica un nuevo release de tu app para llevar los cambios a los proyectos que la usan — consulta Releases y la tienda de aplicaciones.

Validar plantillas sin el agente

El validador también se puede ejecutar por separado, por ejemplo en un pipeline de CI:


git clone https://github.com/IronFlock/agent-skills
uv run agent-skills/plugins/ironflock/skills/ironflock-templates/scripts/validate.py path/to/your-app

Imprime una línea por cada hallazgo, con el archivo, la línea y la ruta, y termina con el código de salida 1 si encuentra algún error.

Desinstalar


claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock