--- title: "Skills: la guía" description: "La guía de las skills de Éclair: requisitos, instalación, prompt inicial, controles de calidad, qué hacer y qué evitar, y cómo crear tu propia skill." url: "https://eclaircms.org/es/documentacion/skills" lang: "es" author: "Thierry Gustin" published: "2026-11-08" updated: "2026-11-10" --- # Skills: la guía > **Lo esencial** — Esta guía explica paso a paso cómo usar las skills de Éclair: instalar la biblioteca en tu proyecto, lanzar un agente con el prompt adecuado, seguir los siete controles de calidad antes de activar nada, evitar los errores habituales y crear tus propias skills. Está pensada para quien quiere añadir una función a una web Éclair 2.0 con Claude Code, Codex o ChatGPT. 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](https://eclaircms.org/es/descargar) 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](https://eclaircms.org/es/documentacion/actualizaciones). ## ¿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](https://github.com/Jacckisback/eclair-skills) (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/`. ```bash 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 ``` > **Consejo** — Empieza por la familia `foundation`: sus ocho skills fijan las reglas comunes (arquitectura, almacenamiento, permisos, rutas, caché, seguridad, pruebas) de las que dependen todas las demás. ## ¿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: ```text 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// sin modificar el núcleo. Antes de proponer la activación, ejecuta php tools/validate.php --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. | Control | Lo que se comprueba | | --- | --- | | 0 | Versión de Éclair, commit y capacidades reales de la web (API capabilities) | | 1 | Paquete en site/extensions/<id>/, manifiesto eclair-extension/1, huellas de los archivos, núcleo intacto | | 2 | Validador oficial: php tools/validate.php <carpeta> --json devuelve valid: true | | 3 | Batería de pruebas completa: php tests/run.php | | 4 | Presupuestos de rendimiento: php tools/measure.php --check | | 5 | Pruebas de seguridad negativas, permisos por objeto, caché privada aislada, copia y restauración | | 6 | Revisión humana, activación desde la administración y vuelta atrás probada | ## 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//secrets.php`. ## ¿Cómo crear tu propia skill? ```text skills/eclair-mi-oficio/ ├── SKILL.md └── references/ ├── acceptance.md └── native-contract.md ``` 1. Crea una carpeta `skills/eclair-/` 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. ## Preguntas sobre el uso de las skills ### ¿Dónde se instalan las skills? En la carpeta `.agents/skills/` de tu proyecto. Para Claude Code, cópialas en `.claude/skills/`. ### ¿Puedo instalar una sola skill? Sí, con `--skill eclair-`. Puedes repetir la opción para instalar varias. ### ¿Cómo actualizo una skill? Descarga la nueva versión de la biblioteca, revisa los cambios y vuelve a instalar con `--force`. ### ¿Funcionan las skills sin conexión con mi web en línea? Sí. Trabajan sobre tu copia del proyecto; de hecho, es lo recomendable. [Ver la biblioteca en GitHub](https://github.com/Jacckisback/eclair-skills) [Las 57 skills, familia por familia](https://eclaircms.org/es/skills)