Tu agente de IA escribe código rápido, pero toma el atajo más corto: se salta el spec, no escribe tests y no mira seguridad. Agent Skills, la colección de Addy Osmani con más de 48.000 estrellas en GitHub, le pone encima el proceso de un ingeniero senior. Acá tenés qué es, cómo instalarlo en Claude Code y cómo usarlo en un proyecto real.

Qué vas a aprender

Qué es Agent Skills y qué problema concreto resuelve al programar con IA
Las 23 skills ordenadas por cómo se construye software de verdad: de la idea al deploy
Cómo instalarlo en Claude Code en 2 minutos (comando listo para copiar)
Los 7 comandos que vas a usar a diario y para qué sirve cada uno
Un ejemplo de punta a punta: de una idea vaga a código en producción
Cómo instalarlo también en Cursor, Gemini CLI y otros agentes

01 · Qué es Agent Skills (y por qué lo usa tanta gente)

Cuando le pedís a un agente de IA que programe algo, por defecto va por el camino más corto: te entrega código que "funciona" en la demo, pero sin especificación, sin tests y sin revisar seguridad. Funciona hasta que no funciona.

Agent Skills es una colección de flujos de trabajo estructurados que le imponen al agente la disciplina de un ingeniero senior. No son consejos abstractos tipo "escribí buen código": son procesos paso a paso que el agente sigue, escritos en archivos SKILL.md que el agente lee y obedece.

Lo creó Addy Osmani (ingeniero del equipo de Chrome en Google, autor de varios libros de performance web). El repo es MIT (libre para usar, forkear y adaptar), tiene más de 48.000 estrellas y va por la versión 0.6.1. Adentro codifica prácticas del libro Software Engineering at Google: la Ley de Hyrum, la regla de Chesterton's Fence, trunk-based development, y las convierte en pasos verificables.

El antes y después, con un ejemplo real. Le pedís: "armame un endpoint para subir archivos".

Sin skills (junior apurado): te escribe el endpoint sin validar el tamaño del archivo, sin tests, y con la API key escrita en el código.
Con security-and-hardening + test-driven-development activas: valida el tipo y tamaño, saca el secreto a una variable de entorno, escribe los tests primero y recién ahí implementa.

Mismo agente, mismo modelo. La diferencia es el proceso.

02 · Las 23 skills, ordenadas por fase

Las skills están agrupadas por las fases reales de construir software. No tenés que aprenderlas de memoria: el agente elige la que corresponde según lo que estés haciendo.

Meta

using-agent-skills — mapea el trabajo que llega a la skill correcta (el punto de entrada)

Define — aclarar qué construir

interview-me — saca tu intención real, una pregunta a la vez
idea-refine — convierte una idea vaga en una propuesta concreta
spec-driven-development — arma el PRD: objetivos, estructura, testing, límites

Plan — descomponer

planning-and-task-breakdown — parte el spec en tareas verificables

Build — escribir el código

incremental-implementation — rebanadas verticales finas con feature flags
test-driven-development — Red-Green-Refactor, pirámide de tests 80/15/5
context-engineering — darle al agente la info justa en el momento justo
source-driven-development — decisiones ancladas en documentación oficial
doubt-driven-development — revisión adversarial con contexto fresco para lo crítico
frontend-ui-engineering — arquitectura de componentes, design systems, WCAG 2.1 AA
api-and-interface-design — diseño contract-first, Ley de Hyrum, validación de bordes

Verify — probar que funciona

browser-testing-with-devtools — Chrome DevTools MCP para inspección en runtime
debugging-and-error-recovery — triage en 5 pasos: reproducir, localizar, reducir, arreglar, blindar

Review — calidad antes del merge

code-review-and-quality — revisión en 5 ejes, cambios de ~100 líneas, etiquetas de severidad
code-simplification — Chesterton's Fence, bajar complejidad
security-and-hardening — OWASP Top 10, patrones de auth, manejo de secretos
performance-optimization — Core Web Vitals, profiling, análisis de bundle

Ship — desplegar con confianza

git-workflow-and-versioning — trunk-based, commits atómicos
ci-cd-and-automation — Shift Left, feature flags, pipelines con quality gates
deprecation-and-migration — el código como pasivo, patrones de migración
documentation-and-adrs — Architecture Decision Records, docs de API
shipping-and-launch — checklists pre-lanzamiento, rollout escalonado, rollback

Además trae 3 personas que el agente puede adoptar (code-reviewer, test-engineer, security-auditor) y 4 checklists de referencia (testing, seguridad, performance, accesibilidad).

03 · Instalarlo en Claude Code (2 minutos)

La forma recomendada es por el marketplace de plugins. Pegá estos dos comandos dentro de Claude Code:

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

Si tu red bloquea SSH, usá la variante por HTTPS:

/plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills

¿Querés probarlo sin instalar nada de forma permanente? Cloná el repo y apuntá Claude a esa carpeta:

git clone https://github.com/addyosmani/agent-skills.git
claude --plugin-dir /ruta/a/agent-skills

Una vez instalado, las skills se activan solas según el contexto (por ejemplo, si empezás a construir UI se dispara frontend-ui-engineering) o las llamás a mano con los 7 comandos.

04 · Los 7 comandos que vas a usar a diario

Cada comando dispara un flujo completo. Esta es la tabla que conviene tener a mano:

Comando	Para qué sirve
`/spec`	Spec antes que código
`/plan`	Tareas chicas y atómicas
`/build`	Una rebanada a la vez
`/test`	Los tests son la prueba
`/review`	Mejorar la salud del código
`/code-simplify`	Claridad antes que astucia
`/ship`	Más rápido es más seguro

05 · Cómo se usa en un proyecto real (de punta a punta)

Supongamos que querés agregar "recuperar contraseña" a tu app. En vez de tirar todo de una, seguís el flujo:

/spec  Quiero agregar recuperación de contraseña por email a mi app.
       Definí objetivos, flujo, casos borde y qué queda fuera de alcance.

El agente usa spec-driven-development y te entrega un mini-PRD para aprobar. Después:

/plan   Descomponé el spec aprobado en tareas verificables, la más chica primero.
/build  Implementá la primera tarea como una rebanada vertical, detrás de un feature flag.
/test   Escribí los tests antes de la implementación (red-green-refactor).
/review Revisá lo que hicimos: seguridad (OWASP), claridad y bordes de la API.
/ship   Preparalo para deploy: commit atómico, rollout escalonado y plan de rollback.

El valor no está en cada comando suelto, sino en la secuencia: el agente no llega a /ship con código que nunca pasó por /test o /review. Es el mismo orden que seguiría un equipo serio, pero ejecutado por tu agente sin que se lo tengas que recordar.

Tip: si no sabés por dónde empezar, decile al agente "usá using-agent-skills" y él mismo mapea tu pedido a la skill correcta.

06 · Instalarlo en Cursor, Gemini CLI y otros

No es exclusivo de Claude Code. Funciona en casi cualquier agente que lea instrucciones en Markdown:

Cursor: copiá los archivos .md de las skills dentro de .cursor/rules/, o referenciá la carpeta skills/. La guía está en docs/cursor-setup.md del repo.

Gemini CLI (desde el repo):

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Gemini CLI (clon local):

gemini skills install ./agent-skills/skills/

Windsurf, OpenCode, GitHub Copilot, Kiro IDE: cada uno tiene su instructivo en la carpeta docs/ del repo.

07 · Reglas clave para sacarle el jugo

Arrancá por using-agent-skills. Es el portero: mapea tu pedido a la skill que corresponde, así no tenés que conocerlas todas.
No actives todo de golpe. Dejá que el contexto dispare la skill, o usá el comando puntual. Cargar las 23 a la vez solo gasta contexto.
Es agnóstico de lenguaje y stack. Sirve igual para un script de Python que para un front en React.
Es MIT: forkealo. Podés clonarlo y ajustar las skills al estándar de tu equipo (tus reglas de commits, tu checklist de seguridad).
No reemplaza tu criterio. Te da el proceso de un senior; las decisiones de producto siguen siendo tuyas. La IA ejecuta disciplina, no estrategia.

El cambio mental es simple: dejás de pedirle a la IA "código que funcione" y pasás a pedirle "código que sobreviva". Para un negocio, esa diferencia es la que separa un prototipo que se cae a la semana de algo que podés poner frente a clientes.

Guías relacionadas

Guía completa para usar Claude Code
Cómo crear tus propias skills para Claude Code