Agent Skills: disciplina de ingeniería para agentes de programación

Todo lo que hay que saber sobre addyosmani/agent-skills: una colección de flujos verificables que intenta incorporar especificación, pruebas, revisión y entrega al trabajo de agentes de código.

Qué es Agent Skills

Agent Skills es una biblioteca de habilidades de ingeniería para agentes de programación. Cada habilidad es un documento Markdown con metadatos y un proceso: pasos, puntos de control, señales de alerta, respuestas a racionalizaciones y una condición de salida verificable. No es un modelo ni una plataforma de ejecución.

Su planteamiento es que un agente suele ir directamente de una petición a una implementación y omitir tareas menos visibles: precisar requisitos, diseñar, probar antes de implementar, revisar y preparar la entrega. El repositorio empaqueta esos pasos en 24 habilidades: 23 del ciclo de desarrollo y using-agent-skills, que decide qué flujo aplicar.

El README organiza el recorrido como definir → planificar → construir → verificar → revisar → entregar. Además de las habilidades, ofrece cuatro perfiles de revisión —código, pruebas, seguridad y rendimiento web— y material de referencia para seguridad, accesibilidad, rendimiento y observabilidad.

Documento digital brillante con metadatos, marcas de verificación y advertencias, representando una Skill como archivo Markdown estructurado.

El origen: de un repositorio creado en febrero a una explicación pública en mayo

La API de GitHub sitúa la creación del repositorio el 15 de febrero de 2026; el primer commit recuperable de su historial, Add AGENTS.md, es de ese mismo día y está firmado por Addy Osmani. La cuenta de GitHub identifica a Osmani como antiguo director de Google que trabajó en Gemini y Google Cloud; esa biografía es de la cuenta, no una atribución institucional del proyecto a Google.

Línea temporal futurista con las fechas 15 de febrero y 3 de mayo sobre una red de nodos que representa el crecimiento del repositorio a 27.000 estrellas.

Osmani publicó el artículo de lanzamiento “Agent Skills” el 3 de mayo de 2026. Allí cuenta que el proyecto había superado 27.000 estrellas y formula el problema de partida: los agentes optimizan la señal de «tarea completada», mientras que el trabajo de ingeniería fiable también exige especificaciones, pruebas, evidencia y revisión. La respuesta no es añadir documentación extensa al contexto, sino dar al agente una secuencia corta que pueda ejecutar y comprobar.

La tensión con las funciones nativas es explícita: un fichero de reglas o una explicación general no garantiza que el agente aplique la práctica cuando corresponde. Agent Skills usa una habilidad enrutadora para cargar progresivamente el flujo pertinente, en vez de cargar todo el catálogo al inicio. Para Claude Code, el repositorio documenta además un gancho de inicio de sesión que inyecta using-agent-skills; su prueba comprueba el contenido JSON tanto con jq como sin esa utilidad disponible.

Filosofía y principios

El texto de Osmani y el README sostienen cinco decisiones de diseño verificables:

Proceso antes que prosa: una habilidad debe ordenar acciones concretas, no limitarse a describir buenas prácticas.
Antirracionalización: las tablas recogen excusas para saltarse pasos y su refutación, porque los modelos pueden justificar atajos plausibles.
Verificación no negociable: una prueba, salida de compilación, traza o revisión constituye evidencia; una afirmación de que algo «parece correcto» no cierra la tarea.
Divulgación progresiva: se activa el contexto necesario para la fase actual, no todo el material simultáneamente.
Disciplina de alcance: el agente no debe refactorizar sistemas adyacentes ni ampliar una tarea sin comprender y justificar el cambio.

El autor relaciona estas ideas con prácticas de ingeniería publicadas por Google —por ejemplo, Hyrum’s Law, revisión de legibilidad, pruebas y lanzamientos graduales—, pero la fuente lo presenta como inspiración y adaptación del proyecto, no como documentación oficial de Google.

Núcleo de IA protegido por escudos holográficos que repelen excusas fantasmales, representando el principio de antirracionalización.

Cómo funciona

El flujo se puede invocar mediante ocho comandos de barra:

Objetivo	Comando	Principio declarado
Definir qué construir	`/spec`	Especificación antes que código
Descomponer el trabajo	`/plan`	Tareas pequeñas y atómicas
Implementar	`/build`	Una porción vertical por vez
Demostrar que funciona	`/test`	Las pruebas son evidencia
Revisar antes de fusionar	`/review`	Mejorar la salud del código
Auditar rendimiento web	`/webperf`	Medir antes de optimizar
Simplificar	`/code-simplify`	Claridad antes que ingenio
Preparar la entrega	`/ship`	Más rápido es más seguro

Panel de control futurista con los ocho comandos de barra del flujo, desde /spec hasta /ship, dispuestos en una interfaz circular.

/build puede generar el plan y ejecutar sus tareas tras una única aprobación: cada tarea mantiene pruebas guiadas por desarrollo y un commit separado, y el proceso se detiene ante fallos o pasos de riesgo. Las habilidades también se activan por contexto: el README pone como ejemplos el diseño de una API y el trabajo de interfaz.

La instalación general usa la herramienta abierta skills:

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

Terminal con el comando npx skills add addyosmani/agent-skills ejecutándose y extrayendo archivos Markdown estructurados.

El README afirma compatibilidad de esa herramienta con más de 70 agentes y enumera, entre otros, Claude Code, Cursor, Codex, Copilot, Cline y Gemini. También contiene integraciones y directorios específicos para Claude Code, Codex, Gemini, Antigravity y OpenCode. Es compatibilidad documentada por el proyecto; no equivale a una certificación de cada proveedor.

Estado oficial y semioficial

El repositorio incluye un manifiesto de mercado y el artículo de Osmani documenta para Claude Code los comandos /plugin marketplace add addyosmani/agent-skills y /plugin install agent-skills@addy-agent-skills. Eso acredita un mecanismo de instalación mediante el mercado configurado por el propio proyecto.

No se recuperó, en las fuentes consultadas, una página de un proveedor que aceptase Agent Skills en un mercado oficial ni un anuncio de Anthropic, OpenAI, Google, Cursor u otra empresa que lo avalase. Por tanto, su estado verificable es comunitario o semioficial por sus integraciones nativas, no una aprobación oficial de un proveedor. Las 81.424 estrellas y el hilo de Hacker News muestran una adopción notable, pero no constituyen una designación formal de estándar de facto.

El ecosistema

Mapa del ecosistema con un monolito central que representa el repositorio principal rodeado de nodos satélite y una constelación de estrellas.

Repositorios, adaptadores y herramientas relacionadas

addyosmani/agent-skills concentra los adaptadores del proyecto: .claude-plugin, .codex-plugin, .gemini, .opencode, .agents/plugins y commands. No son repositorios separados, sino formatos e integraciones dentro del repositorio principal.
agentskills/ aparece citado por el usuario kergonath en el hilo de Hacker News como un repositorio oficial del ecosistema de habilidades. La conversación recuperada no permite determinar su relación técnica exacta con Agent Skills, por lo que no se le atribuye integración ni competencia directa.
obra/superpowers y las habilidades de Matt Pocock son las dos colecciones que el propio documento comparativo de Agent Skills nombra como referencias próximas. El primero favorece ejecuciones autónomas con subagentes, un proceso estricto y aislamiento con árboles de trabajo; el segundo se describe como una caja de herramientas para Claude Code con un bucle de interrogación característico. Esta relación procede del propio repositorio, no de una afiliación.

Bifurcaciones y traducciones

La API de bifurcaciones de GitHub devolvió, entre las de mayor número de estrellas, Dev-moe-kyawaung/agent-skills (17), rosnjs/agent-skills (5) y wizzeart/agent-skills (2). Sus descripciones repiten la descripción del proyecto original; por ello se clasifican como bifurcaciones, no como puertos o extensiones independientes.

No se identificó una traducción comunitaria verificable en las consultas realizadas. Además, CONTRIBUTING.md establece que el proyecto no acepta traducciones de documentación ni de habilidades, para evitar que queden desactualizadas. Esa política no demuestra que no existan traducciones externas; solo explica que no forman parte del repositorio principal.

La consulta de los repositorios públicos de addyosmani se realizó para localizar proyectos hermanos. Con las fuentes recuperadas no se estableció un repositorio hermano específicamente destinado a Agent Skills, evaluaciones o mercado separado; se evita inventar esa relación.

Números del repo

Medición: 3 de agosto de 2026, API y página de GitHub.

Métrica	Valor
Estrellas	81.424
Bifurcaciones	8.775
Suscriptores	440
Commits	383
Incidencias abiertas indicadas por la API	145
Ramas	12
Etiquetas	7
Lenguaje principal	JavaScript
Licencia	MIT
Creación	15 de febrero de 2026
Último commit recuperado	26 de julio de 2026
Última versión	`0.6.5`, 26 de julio de 2026

Los principales contribuidores que devolvió la API por número de contribuciones fueron addyosmani (218), nucliweb (33), federicobartoli (33), dj2313 (6), Dashsoap (4) y Keerthi-Sreenivas (4). El conteo de 383 commits se corroboró con la página principal y con la última página recuperable de la paginación de commits.

GitHub devuelve watchers_count con el mismo valor que las estrellas; por eso se informa subscribers_count como suscriptores reales. El campo open_issues_count puede incluir solicitudes de cambios abiertas, de modo que 145 no es necesariamente un conteo exclusivo de incidencias. La API devolvió updated_at el 3 de agosto de 2026, fecha coincidente con la medición; se transcribe como metadato, no como una inferencia sobre actividad adicional.

Cómo contribuir

CONTRIBUTING.md pide comprobar antes el catálogo y las solicitudes de cambios abiertas, leer la anatomía de una habilidad y justificar en la propuesta la carencia que se pretende cubrir. Si hay solapamiento, se debe ampliar la habilidad existente en lugar de crear otro directorio.

Una habilidad nueva requiere un directorio con nombre en minúsculas y guiones, un SKILL.md con metadatos name y description, y un caso en evals/cases/<nombre>.json: al menos tres activadores positivos, dos negativos y una evaluación de comportamiento. Las evaluaciones de ejecución deben usar ficheros reales de evals/fixtures/; las habilidades conversacionales pueden usar una evaluación de diálogo revisada por una persona. La integración continua aplica estos requisitos.

Estación de trabajo futurista ensamblando un nuevo directorio de habilidad junto a una lista de requisitos de contribución.

Para cambios en el gancho de inicio o en la habilidad enrutadora, la guía exige ejecutar:

bash hooks/session-start-test.sh

La contribución se licencia bajo MIT. La guía también limita el alcance: cambios enfocados, conservar estructura y tono, y verificar que los metadatos YAML sigan siendo válidos.

Cómo lo recibió la comunidad

La principal conversación recuperada es el hilo de Hacker News 48015397, publicado por BOOSTERHIDROGEN el 4 de mayo de 2026. Su elemento raíz en la API de Algolia registra 376 puntos y 212 comentarios.

Visualización abstracta de un hilo de Hacker News con burbujas de conversación conectadas por hilos de fibra óptica luminosos.

encoderer escribió que había adoptado varias habilidades y señaló como particularmente útiles las de diseño de API y pruebas de interfaz. Es un elogio concreto de dos áreas, no una evaluación comparativa.
ElijahLynn explicó que lo usaba en un proyecto personal nuevo y que le permitía concentrarse en arquitectura y diseño de producto en vez de decidir cómo construir cada parte; también agradeció al repositorio y a sus contribuidores.
y-curious dijo que tomaría muchas ideas, pero expresó preocupación sobre la posibilidad de desinstalar el plugin y sostuvo que cada habilidad debería personalizarse para el desarrollador. bvirkler respondió que un plugin era un conjunto de archivos y preguntó por qué no podría borrarse; la fuente conserva la duda, no una resolución técnica concluyente.
kergonath relató que tuvo que idear la mayoría de sus propias habilidades y que Claude no le resultó especialmente útil para ayudarle a crearlas. Es una crítica a la ayuda del agente en esa tarea, no una acusación de fallo del repositorio.

También apareció un envío previo, 47670950, de msolujic, con 2 puntos y 0 comentarios. Sirve como evidencia de descubrimiento temprano, pero no como respaldo ni crítica de la comunidad.

Agent Skills frente a otras propuestas

Propuesta	Coincidencia verificable	Diferencia verificable según `docs/comparison.md`
`obra/superpowers`	Colección de habilidades para agentes de código.	Se centra en ejecuciones autónomas con razonamiento, subagentes, un proceso estricto y aislamiento mediante árboles de trabajo; Agent Skills ordena el ciclo completo por fases y añade perfiles de revisión y evaluaciones en el repositorio.
Habilidades de Matt Pocock	Colección de flujos para agentes de código.	Se presenta como una herramienta curada y opinativa para Claude Code, con un bucle de interrogación; Agent Skills distribuye su catálogo por las seis fases del ciclo de desarrollo.

La propia comparación advierte que ninguna es «mejor» en abstracto. El contraste está limitado a cómo el autor caracteriza los proyectos; no se recuperó una evaluación independiente que mida resultados, coste o calidad entre ellos.

Casos de uso y a quién puede ayudar este repositorio

Equipos que quieren que un agente no salte de una petición a un cambio de código pueden usar la secuencia /spec → /plan → /build → /test → /review → /ship para hacer visibles la especificación, la evidencia y la revisión.
Responsables de cambios de API, interfaz o seguridad pueden activar habilidades especializadas como api-and-interface-design, frontend-ui-engineering y security-and-hardening, en lugar de confiar en una pauta general no verificable.
Mantenedores de un flujo interno para agentes pueden adoptar la anatomía exigida por el repositorio —proceso, racionalizaciones, alertas y salida— y sus casos de evaluación para comprobar que una habilidad se activa y se comporta como se esperaba.
Personas que trabajan con varios entornos de agentes pueden instalar el conjunto con npx skills o usar los adaptadores documentados para Claude Code, Codex, Gemini, Antigravity u OpenCode; antes conviene comprobar el comportamiento en el entorno propio, pues la compatibilidad declarada no es una certificación de proveedores.

Recursos

Repositorio: https://github.com/addyosmani/agent-skills
Documentación e instalación: https://github.com/addyosmani/agent-skills#quick-start
Anuncio y filosofía del autor: https://addyosmani.com/blog/agent-skills/
Habilidades oficiales: https://github.com/addyosmani/agent-skills/tree/main/skills
Guía de contribución y evaluaciones: https://github.com/addyosmani/agent-skills/blob/main/CONTRIBUTING.md y https://github.com/addyosmani/agent-skills/tree/main/evals
Comparación con propuestas relacionadas: https://github.com/addyosmani/agent-skills/blob/main/docs/comparison.md
Comunidad y reseñas: https://news.ycombinator.com/item?id=48015397 y https://news.ycombinator.com/item?id=47670950
Discord: no se recuperó un enlace oficial de Discord en las fuentes consultadas.

Nota: este artículo combina el README, la guía de contribución, el documento comparativo y el artículo de lanzamiento de Agent Skills; la API y página de GitHub; y Hacker News mediante Algolia, consultados el 3 de agosto de 2026. Las cifras cambian con el tiempo.