~/codigoagente
Agentes de IA

Skills y reglas de ECC: cómo instalar solo lo que necesitas para tu stack

Para instalar solo las skills y reglas de ECC que necesitas, parte del perfil minimal y añade componentes con --with (por ejemplo --with framework:nextjs) o --skills tdd-workflow,security-review; para las reglas, copia a .claude/rules/ecc/ solo rules/common y la carpeta de tu lenguaje. Así el agente no carga cientos de descripciones que nunca va a usar.

Esta es la parte 5 de la guía completa de ECC. Aquí verás cómo está organizado el catálogo de 406 componentes, la diferencia entre skills y reglas, cómo añadir un framework concreto, qué skills son las más útiles y cómo poner reglas solo en un proyecto.

Skills y reglas: qué es cada cosa

SkillsReglas
Qué sonProcedimientos que el agente carga cuando los necesitaNormas que se cargan siempre o al tocar ciertos archivos
Dónde viven`~/.claude/skills/<nombre>/SKILL.md``~/.claude/rules/` o `.claude/rules/` del proyecto
Coste de contextoSolo su descripción, hasta que se usanSu texto entero, cuando se cargan
Ejemplo`tdd-workflow`: los pasos de TDD`common/testing.md`: "cobertura mínima del 80 %"

Si no tienes claro qué es una skill, empieza por la guía de skills de Claude Code. Lo importante aquí: las skills cuestan poco hasta que se usan; las reglas cuestan siempre que se cargan.

El catálogo: 406 componentes en 7 familias

El instalador de ECC no trabaja con archivos sueltos sino con componentes. Los listamos con la CLI:

terminalsh
node scripts/catalog.js components
El catálogo de ECC 2.2.3 contado por familia · codigoagente
FamiliaCuántosQué agrupa
`skill:`328Una skill concreta (`skill:tdd-workflow`)
`capability:`23Un paquete temático: `security`, `database`, `research`, `content`, `media`, `social`…
`lang:`14TypeScript, Python, Go, Java, Swift, C++, C, Kotlin, ArkTS, Perl, Ruby, Rust, C#, F#
`framework:`9Angular, React, Vue, Next.js, Django, Spring Boot, Quarkus, Rails, Laravel
`locale:`13Traducciones de la documentación
`agent:`13Agentes sueltos que se pueden añadir
`baseline:`6Las bases: reglas, hooks, comandos, configuración

Para ver el detalle de uno: node scripts/catalog.js show framework:nextjs.

Añadir solo tu framework con --with

Probamos el perfil minimal solo y con Next.js, en modo ensayo:

terminalsh
npx ecc-universal@2.2.3 install --profile minimal --target claude --dry-run
npx ecc-universal@2.2.3 install --profile minimal --target claude --with framework:nextjs --dry-run
Añadir Next.js suma el módulo framework-language: de 435 a 562 archivos · codigoagente

--with framework:nextjs añade el módulo framework-language (127 archivos más). Puedes encadenar varios: --with framework:nextjs --with capability:security. Si quieres skills concretas por nombre, el instalador desde el repositorio acepta --skills:

terminalsh
./install.sh --target claude --skills tdd-workflow,security-review,e2e-testing

Y si no sabes qué componente encaja, consult te propone candidatos en lenguaje natural. Como vimos en la parte 4, empareja palabras clave y a veces se equivoca de stack: revisa su lista antes de instalar.

Las skills que más merecen la pena

De las 328, estas son las que usarás en casi cualquier proyecto:

SkillPara qué
`search-first`Investigar antes de programar: buscar en el código y la documentación antes de inventar
`tdd-workflow`El ciclo RED → GREEN → REFACTOR que probamos en la [parte 3](/ecc-flujo-plan-tdd-code-review)
`verification-loop`Verificar de forma continua, no solo al final
`security-review`Lista de comprobación de seguridad antes de un merge
`api-design`Diseño REST: paginación, errores, versionado
`database-migrations`Migraciones con Prisma, Drizzle, Django o Go sin romper datos
`e2e-testing`Tests de extremo a extremo con Playwright y Page Object Model
`deployment-patterns` y `docker-patterns`CI/CD, health checks, rollbacks y contenedores
`strategic-compact`Cuándo compactar el contexto (lo vemos en la parte 7)

Y dos para mantener ordenada tu colección: skill-stocktake audita la calidad de tus skills y comandos, y /skill-create genera skills nuevas a partir de tu historial de git.

Reglas: global o por proyecto

ECC trae reglas para 22 carpetas: common, typescript, python, golang, rust, java, kotlin, swift, php, ruby, cpp, csharp, fsharp, dart, perl, react, react-native, vue, nuxt, angular, arkts y web.

Las comunes (coding-style, git-workflow, testing, security, performance, patterns, hooks, agents…) se cargan siempre, unas 2.900 palabras. Las de lenguaje llevan paths: en su frontmatter y solo se cargan al tocar archivos de ese tipo, como vimos en la parte 2.

Para que apliquen solo en un repositorio:

terminalsh
cd tu-proyecto
mkdir -p .claude/rules/ecc
cp -R /ruta/a/ECC/rules/common .claude/rules/ecc/
cp -R /ruta/a/ECC/rules/typescript .claude/rules/ecc/

Copia la carpeta entera, no archivos sueltos: las reglas se enlazan entre sí y los nombres se repiten entre lenguajes (coding-style.md existe en casi todas).

Revisa las reglas antes de aceptarlas

Las reglas son opiniones. common/testing.md exige 80 % de cobertura y tests unitarios, de integración y E2E para todo. Si tu proyecto es un prototipo, eso puede frenar al agente más de lo que ayuda. Edita las reglas copiadas en tu proyecto: son tuyas y ECC solo actualiza las que instaló en su estado.

Errores frecuentes

  • Copiar rules/common/*.md en vez de la carpeta. Se rompen las referencias entre reglas. Usa cp -R rules/common.
  • Anidar skills en ~/.claude/skills/ecc/. Claude Code solo descubre skills que son hijas directas de ~/.claude/skills/.
  • Instalar capability:content o capability:social "por si acaso". Son decenas de skills de marketing, inversores y redes. Si programas, no las necesitas.
  • Mezclar reglas de ECC con tu CLAUDE.md sin leerlas. Si tu CLAUDE.md dice "commits en español" y la regla git-workflow otra cosa, el agente duda. Quita lo que contradiga.

Preguntas frecuentes

¿Las skills funcionan en Codex o Cursor? Sí: el catálogo se publica para varios destinos (--target codex, --target cursor…), aunque con menos funciones que en Claude Code.

¿Puedo borrar una skill que no uso? Sí. Si la instaló ECC, doctor avisará de que falta; ignóralo o desinstala y vuelve a instalar sin ese componente.

¿Cuántas skills debería tener activas? No hay una cifra oficial. Como referencia, en la parte 7 medimos que el perfil minimal ya suma unos 12.500 tokens estimados solo en descripciones.

Conclusión

ECC no se instala, se elige. Parte de minimal, añade tu framework con --with, copia solo las reglas de tu lenguaje al proyecto y léelas antes de aceptarlas. En la parte 6 vemos la otra pieza que más cambia el día a día: los hooks, la memoria entre sesiones y el aprendizaje continuo.

// código fuente

Repositorio del artículo
El código del que habla este artículo es público: revísalo, dale una estrella o clónalo desde aquí.

Nos ayuda a crecer

codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

rea-video es una skill Apache-2.0 que desmonta un vídeo plano a plano: si es real, IA o código, voz, música, subtítulos y cómo rehacerlo. Prueba real y costos.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #3

Parte 3 de la guía: anclaje, decoy, paradoja de la elección, Hick's Law y activation energy aplicados a la página de precios, con ejemplos reales.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #2

Parte 2 de la guía: autoridad, compromiso, escasez real y framing con la skill marketing-psychology, con fragmentos reales reescritos del blog codigoagente.
  • Skills para tus agentes
  • Claude Code
leer artículo