Skills: la guía

Las 57 skills de Éclair, en 8 familias, ayudan a tu asistente de IA a añadir una función a tu web Éclair 2.0 sin romper lo que funciona. Instálalas en tu proyecto, lanza el agente con el prompt incluido y no actives nada antes de los 7 controles de calidad.

Esta guía detalla cada paso y explica cómo escribir tus propias skills. Antes de empezar, haz una copia de seguridad como explica la guía Actualizar, hacer copias y mudarse.

¿Qué necesitas antes de empezar?

• Una web Éclair 2.0 e, idealmente, una copia de trabajo del código (el repositorio oficial clonado), para que el agente pueda lanzar las pruebas.
• Python 3 para instalar y validar las skills, PHP 8.1 o superior para las herramientas de Éclair.
• Un asistente que lea skills: Claude Code o Codex, por ejemplo.
• Una copia de seguridad reciente: Seguridad › Descargar una copia de seguridad.

¿Cómo instalar las skills en tu proyecto?

1. Descarga la biblioteca desde GitHub (Code › Download ZIP, o git clone).
2. En su carpeta, comprueba que está intacta con python3 scripts/validate_skills.py: el mensaje debe anunciar 57 skills válidas.
3. Lista familias y skills con python3 scripts/install_skills.py --list.
4. Instala lo que necesites, por familia (--category design) o por nombre (--skill eclair-seo-audit), con --project /ruta/a/mi-web.
5. Para Claude Code, copia las carpetas instaladas de .agents/skills/ a .claude/skills/.

python3 scripts/validate_skills.py
python3 scripts/install_skills.py --list
python3 scripts/install_skills.py --project /ruta/a/mi-web --category foundation
python3 scripts/install_skills.py --project /ruta/a/mi-web --skill eclair-wordpress-migration
python3 scripts/install_skills.py --project /ruta/a/mi-web --all

¿Cómo lanzar el agente con el prompt adecuado?

Abre tu asistente en la carpeta del proyecto y dale un prompt inicial claro. Este viene con la biblioteca:

Analiza este proyecto Éclair CMS empezando por eclair/index.php y docs/SKILLS-GUIDE.md. Usa las skills eclair-architecture, eclair-extension-builder, eclair-security-audit y eclair-test-suite. Describe la función pedida a partir de las capacidades nativas eclair-extension/1. Crea los archivos de la extensión en site/extensions/<id>/ sin modificar el núcleo. Antes de proponer la activación, ejecuta php tools/validate.php <extensión> --json, php tests/run.php y php tools/measure.php --check. Si falta una capacidad, detén esa parte y crea una RFC y pruebas; no inventes ninguna API.

Después añade tu petición en una o dos frases, con las restricciones que te importan: público, idiomas, volumen, datos personales.

¿Qué comprobar antes de activar una función?

La biblioteca define siete controles de calidad. Una función solo se activa cuando se han superado todos.

Lo que hay que hacer

• Describir la necesidad de negocio, no la técnica: el agente elige las skills.
• Dejar que el agente lea las capacidades de la web antes de escribir código.
• Probar en una copia de la web, nunca directamente en producción.
• Guardar la traza de las decisiones: el agente redacta una breve nota de arquitectura.
• Prever la vuelta atrás: desactivar una función conserva sus datos.

Lo que no hay que hacer

• Modificar app/, assets/, index.php o el actualizador: una actualización lo borraría todo.
• Activar una función que no ha superado el validador y las pruebas.
• Poner en producción un carrito, un área de miembros o un foro mientras el núcleo no ofrezca el contrato.
• Creer que una puntuación SEO, GEO o Lighthouse está garantizada: son mediciones que hay que repetir.
• Dar secretos en claro al agente: van en data/ext/<id>/secrets.php.

¿Cómo crear tu propia skill?

skills/eclair-mi-oficio/
├── SKILL.md
└── references/
    ├── acceptance.md
    └── native-contract.md

1. Crea una carpeta skills/eclair-<nombre>/ con un archivo SKILL.md.
2. Al principio del archivo, indica name y una description que diga cuándo usarla: es lo que lee el agente para decidir.
3. Redacta el diagnóstico obligatorio, el procedimiento, los entregables, las reglas de seguridad y los criterios de aceptación.
4. Añade tus documentos útiles en references/: una skill debe ser autónoma.
5. Declárala en catalog.json y ejecuta python3 scripts/validate_skills.py y python3 scripts/check_release.py --write.
6. Pruébala en un proyecto real y propónla a la biblioteca con una pull request.

¿Qué hacer si algo se bloquea?

El validador rechaza el paquete: Lee el mensaje JSON: indica el archivo o el campo del manifiesto en cuestión. Corrige y vuelve a validar.

El agente quiere modificar el núcleo: Niégate y recuerda la regla: todo debe vivir en site/. Si falta una capacidad, pide una RFC y una prueba bloqueante.

Falta una capacidad (cuentas de clientes, pago…): Es normal en algunas familias: conserva el diseño y las pruebas, y espera a que el núcleo abra el contrato.

Ver la biblioteca en GitHub

Las 57 skills, familia por familia