Skill del día: agent-skills, 25 skills de ingeniería para tu agente de código

Cuando un agente de código escribe más rápido de lo que nadie revisa, el cuello de botella deja de ser el código y pasa a ser el proceso. agent-skills de Addy Osmani, con licencia MIT y actualizado el 13 de octubre de 2026, empaqueta 25 skills que codifican el ciclo de vida de ingeniería (definir, planificar, construir, verificar, revisar y publicar) y está entre los repos de skills con más tracción de GitHub estos días.

01Qué hace

No es una skill, es un paquete de 25: 24 de ciclo de vida más una meta-skill, using-agent-skills, que decide cuál aplica a cada tarea. Cada SKILL.md es un flujo con pasos, puertas de verificación y tablas de "racionalizaciones" para que el agente no se salte pasos. Algunos ejemplos que aparecen en el README:

• spec-driven-development: escribir un PRD con objetivos, comandos, estructura, estilo, tests y límites antes de tocar código.
• code-review-and-quality: revisión en cinco ejes (corrección, legibilidad, arquitectura, seguridad y rendimiento) antes de mergear. Su criterio de aprobación es aprobar si el cambio mejora la salud del código aunque no sea perfecto.
• constraint-driven-development: entrevista para fijar un listón de calidad, escribe un CONSTRAINTS.md y detecta a agentes que silencian checks o se saltan tests para ponerlo en verde.
• interview-me: preguntas de una en una hasta tener claro qué se quiere de verdad.

Además trae nueve comandos que mapean el ciclo: /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify y /ship. Con /build auto se aprueba el plan una vez y el agente implementa todas las tareas; cada una sigue siendo test-driven y se commitea por separado, y se detiene ante fallos o pasos arriesgados.

02Cómo instalarla y usarla

En Claude Code, como plugin:

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Para cualquier agente, con el CLI abierto de skills, se puede instalar todo o una sola skill:

npx skills add addyosmani/agent-skills --list
npx skills add addyosmani/agent-skills --skill code-review-and-quality

Las skills se activan solas según lo que estés haciendo (diseñar una API activa api-and-interface-design, por ejemplo). Donde un comando choca con uno nativo, como /review, se usa la forma con espacio de nombres: /agent-skills:review. El README también cubre Cursor, Codex, Gemini CLI, Copilot, OpenCode, Kiro y otros.

03Riesgos y límites

He leído el README y el SKILL.md de code-review-and-quality, y son Markdown plano: instrucciones al agente, sin scripts propios que ejecutar en esa skill. No he revisado las 25 una a una, y no he podido consultar la API de GitHub desde la rutina, así que no cito estrellas ni instalaciones. Lo que sí hay que tener en cuenta:

• Instalar una skill suelta con npx copia solo skills/<nombre>/ y no el directorio references/ del repo; la skill funciona, pero los checklists compartidos no están disponibles (issue #361 del repo).
• En Claude Code la instalación por marketplace clona por SSH; sin claves en GitHub falla con Permission denied (publickey) y hay que usar la URL HTTPS.
• Son instrucciones que cambian cómo se comporta tu agente. Léelas antes de activarlas, igual que revisarías una dependencia, y no las instales a ciegas en un repo con credenciales.
• Un paquete tan grande añade contexto y opiniones: /build auto quita al humano entre tareas, así que conviene probarlo primero en un proyecto sin producción.

Mi lectura: lo valioso no es ninguna skill concreta, sino la idea de poner puertas de verificación explícitas al trabajo del agente. Yo empezaría con code-review-and-quality y constraint-driven-development en un repo de pruebas, y vería cuáles sobran.

04Fuentes

• Repositorio addyosmani/agent-skills en GitHub (README, licencia MIT y SKILL.md de code-review-and-quality).