🧩 Qué es una Agent Skill (y por qué se impuso el formato)
Desde la definición de una skill hasta el motivo por el que el formato SKILL.md se convirtió en el estándar de facto, y cómo skills.sh se volvió el «npm de skills».
Una skill es un archivo SKILL.md — frontmatter YAML (name + description) más un cuerpo Markdown — que describe un comportamiento. El agente lee e incorpora esa instrucción a su propio razonamiento.
Es la unidad atómica de todo el ecosistema. Sin entender qué es un SKILL.md, el resto (catálogo, install count, grupos) no tiene sentido.
SKILL.md · frontmatter YAML · name + description · cuerpo Markdown
Una skill no es código que se ejecuta. Es texto que el agente lee y sigue cuando el contexto de la conversación coincide con la description. La activación es automática y depende de la relevancia, no de una llamada explícita.
Esta diferencia cambia cómo escribes. No programas pasos: describes cuándo y por qué, y dejas que el agente decida cómo aplicarlo.
activación por contexto · description como activador · sin ejecución directa
SKILL.md es texto plano: funciona en más de 50 agentes, se versiona con git como cualquier archivo del repo y ya suma 53,9M de instalaciones en el agregado de skills.sh. Markdown ganó por ser el mínimo común denominador.
Entender por qué tuvo éxito el formato explica por qué vale la pena invertir en él en vez de encerrar el conocimiento en herramientas propietarias.
portabilidad para más de 50 agentes · versionado git · 53,9M installs
Son capas distintas: el prompt es efímero; CLAUDE.md es el contexto fijo del proyecto; MCP proporciona herramientas/datos; el subagente es un ejecutor aislado; la skill es conocimiento reutilizable que se activa según el contexto.
Saber elegir la capa adecuada evita convertir todo en una skill (o nada). Cada problema tiene el mecanismo apropiado.
prompt efímero · CLAUDE.md siempre activo · MCP = herramientas · subagente = ejecución · skill = conocimiento bajo demanda
skills.sh es el catálogo público: indexa skills por repo, muestra install count (señal de calidad) y se instala con npx skills add owner/repo. Es el npm del mundo de las skills.
Es donde descubres lo que ya existe antes de crear y donde publicas para que otros puedan instalarlo.
catálogo · cantidad de instalaciones · npx skills add · leaderboard
Publican grandes referentes — vercel-labs, anthropics, microsoft — y miles de personas de la comunidad, que suman 5.075 repos fuente. No es un jardín amurallado de una sola empresa.
Saber quién domina y quién aún no ha llegado muestra dónde hay espacio para tu skill.
vercel-labs · anthropics · microsoft · comunidad · 5.075 repositorios
🗺️ El mapa de skills.sh: 39k skills, la ley de potencias y los 16 grupos
El tamaño real del catálogo, la curva brutal de instalaciones y los 16 grupos temáticos, y lo que todo esto te enseña antes de crear tu skill.
skills.sh cataloga 39.366 skills provenientes de 5.075 repos fuente, sumando 53,9M de instalaciones distribuidas en 16 grupos temáticos.
El número total da una idea de la escala: el ecosistema es lo bastante grande como para que ya exista casi todo, y lo bastante específico como para que todavía queden vacíos.
39.366 skills · 5.075 repos · 53,9M instalaciones · 16 grupos
La distribución sigue una ley de potencia: 60,2% de las skills tienen menos de 100 instalaciones, y solo 0,3% (131 skills) superan los 100k. La mayoría está en la cola larga.
Te saca de la ilusión de que "publicar = éxito". La gran mayoría de las skills casi no se instala.
ley de potencia · cola larga · 60,2% <100 · 0,3% = 131 skills 100k+
Las 100 skills más instaladas concentran 43,7% de todas las instalaciones. Casi la mitad del total se concentra en 100 nombres, entre casi 40 mil.
Muestra el efecto de «el ganador se lleva casi todo» — y por qué es difícil competir de frente con las líderes.
top 100 = 43,7% · efecto de red · winner-takes-most
El catálogo se divide en 16 grupos. Por cantidad, lidera AI/LLM/Agents (12.693 skills, 12,9M installs); por instalación, cada skill destaca DevOps&Cloud (907 skills, 8,3M installs). Web&Frontend tiene 4.694 skills.
Ver el volumen frente a las instalaciones por grupo revela dónde hay mucha oferta y dónde pocas skills captan mucha demanda.
AI/Agents 12.693 · Web 4.694 · DevOps 8,3M · Backend 2.685 · Testing 1.339
No solo las skills se concentran: las fuentes también. Pocos repos (vercel-labs, anthropics, microsoft, larksuite) representan una gran parte de las instalaciones, incluso entre 5.075 repos.
La marca y la distribución cuentan. Una skill excelente en un repo desconocido empieza en desventaja.
vercel-labs · anthropics · microsoft · larksuite · marca + distribución
La lección práctica: descubre qué existe antes de crear; apunta a nichos vacíos en vez de competir con los líderes; y posiciona tu skill en el lado correcto de la curva (resolviendo un problema real, no solo repitiendo lo que ya existe).
Es el puente de la Trilha 1 hacia el resto del curso: el mapa orienta dónde y cómo crear.
investiga antes de crear · nicho vacío · lado correcto de la curva
⭐ Las mejores para empezar (paquete inicial)
Las skills canónicas que todo el mundo debería conocer e instalar primero: ocho nombres que enseñan el ecosistema más rápido que cualquier tutorial, además del kit mínimo recomendado.
Un pequeño conjunto de skills muy instaladas, bien escritas y de fuentes confiables (vercel-labs, anthropics, supabase) que instalas y lees primero.
Instalar estas skills es el atajo más rápido para entender cómo es una buena skill por dentro: cada una se convierte en un ejemplo comentado.
curaduría · fuente confiable · instalar es leer · 4-8 skills base
find-skills (vercel-labs/skills, 1.802.925 installs) enseña al agente a buscar, evaluar e instalar por sí solo otras skills del catálogo. npx skills add vercel-labs/skills.
Es la skill más instalada del planeta y el punto de entrada a todo: transforma al agente en curador de su propio ecosistema.
find-skills · meta-skill · 1,8M installs · vercel-labs/skills
frontend-design (488k, anthropics), vercel-react-best-practices (443k) y web-design-guidelines (358k, vercel-labs): las tres referencias de diseño y código de UI. npx skills add anthropics/skills e vercel-labs/agent-skills.
Muestran cómo escribir una skill de «guideline»: instrucciones de estilo que el agente aplica sin que tengas que repetirlas, aunque no seas desarrollador de front.
frontend-design 488k · vercel-react 443k · web-design-guidelines 358k · skill de lineamientos
skill-creator (246k, anthropics) guía al agente para escribir y optimizar SKILL.md; agent-browser (332k, vercel-labs) le da al agente un navegador para automatización y scraping.
Cambian lo que el agente puede hacer: una crea nuevas skills (la usarás en la 1.4), la otra habilita casos de uso reales en la web.
skill-creator 246k · agent-browser 332k · meta + herramienta
supabase-postgres-best-practices (203k, supabase) enseña SQL/RLS/schema; test-driven-development (107k, obra/superpowers) hace que el agente escriba la prueba antes del código.
Muestran una skill de vendor (creada por el equipo del producto) y una skill de proceso (cambia el comportamiento, no proporciona herramientas): dos variantes más allá del front.
supabase 203k · TDD 107k · vendor · proceso
El kit mínimo es find-skills + skill-creator (+ TDD si programas). Front agrega frontend-design + web-design-guidelines; el resto se incorpora según sea necesario.
Cada skill consume contexto: un conjunto reducido y pertinente funciona mejor que 40 skills compitiendo por la atención. Instala las que usas.
kit mínimo · find-skills + skill-creator · ampliar bajo demanda · menos es más
🛠️ Cómo crear: tu primera skill en 10 minutos
Práctica desde cero hasta tenerlo funcionando: elegir un caso real (patrón de commits), escribir el SKILL.md mínimo, instalarlo localmente y ver cómo se activa, con el archivo listo para copiar.
Una convención que repites y detestas repetir: el caso ideal para empezar. Nuestro ejemplo: el estándar de mensajes de commit (Conventional Commits).
Los casos pequeños, concretos y comprobables en 1 minuto enseñan el formato; los casos grandes ("deploy completo") frustran y no se activan.
caso real · verificable · conventional-commits · pequeño por diseño
Un archivo: frontmatter YAML con name + description obligatorios, y un cuerpo Markdown imperativo debajo.
name es el identificador; description es el disparador (dice QUÉ y CUÁNDO); el cuerpo son las instrucciones. Saber los tres es saber escribir cualquier skill.
frontmatter YAML · name · description = activador · cuerpo imperativo
La skill conventional-commits completa, para guardar en skills/conventional-commits/SKILL.md: frontmatter, description con activadores, cuerpo breve con tipos y reglas.
Ver un SKILL.md real y conciso aclara el formato: la description lleva el peso con un «Use SIEMPRE que...» y desencadenantes concretos.
SKILL.md listo · activadores concretos · cuerpo breve · buen/mal ejemplo
Cuatro pasos: crear la carpeta/archivo, instalar con npx skills add ./skills/conventional-commits, actívala con una solicitud real y confirma el formato en la salida.
No necesitas publicar para usarla: se instala desde una ruta local. Sin build, sin deploy, sin dependencias. Diez minutos de verdad.
npx skills add ./ · instalación local · se activa por contexto · confirmar
Los tipos de error: description vaga, sin indicar CUÁNDO usarla, cuerpo enorme, frontmatter roto, reglas en MAYÚSCULAS y gritadas sin explicación.
Si la skill existe pero el agente la ignora, 9 de cada 10 veces se debe a una description débil, no al cuerpo. Saberlo te ahorra horas.
description vaga · sin CUÁNDO · cuerpo inflado · YAML roto
Evolución incremental: ajusta la description según lo que falló, agrega ejemplos cuando hagan falta y versiona el SKILL.md junto con el repo.
Una skill de 30 líneas usada y ajustada cada semana vale más que una de 500 escrita como «completa» y nunca probada. Deja que el uso la depure y la haga crecer.
ajustar la description · ejemplos bajo demanda · versionar en git · incremental
🚀 Consejos avanzados: cómo leer el ecosistema como un profesional
El número de instalaciones engaña un poco. Aprende a leer el catálogo de forma crítica: el sesgo de quienes llegaron temprano, encontrar skills en ascenso y nichos vacíos, evaluar la fuente, usar el CLI y saber cuándo NO instalar.
El número de instalaciones es acumulativo: favorece a quienes llegaron temprano, tienen una marca y se convirtieron en requisito previo. find-skills (1,8M) lidera porque es una dependencia de casi todos los flujos, no porque sea «mejor».
Es reputación, no una calificación. Úsalo como filtro inicial ("vale la pena mirar"), nunca como decisión final: no indica si la skill se mantiene o si sirve para tu caso.
sesgo acumulativo · first-mover · marca · reputación ≠ calificación
El 60,2% de las skills tiene <100 installs y solo 131 superan las 100k. Las joyas infravaloradas están entre 100 y 10k installs y en los grupos pequeños (Office, Finance, Productivity).
La cima está bloqueada. Buscar lo reciente + lo popular en el rango medio y encontrar lo que falta (una búsqueda sin resultados = nicho) rinde más que competir con los líderes.
franja intermedia · en ascenso · nicho vacío · grupos pequeños
Cuatro perfiles: proveedor oficial (supabase, stripe) y plataforma (anthropics) = confianza alta; comunidad reconocida = media; repo desconocido = lee el SKILL.md antes.
Una skill es una instrucción que el agente adopta y a veces ejecuta. Una fuente dudosa puede incluir instrucciones perjudiciales, y el SKILL.md es texto: se lee en 30 segundos.
proveedor oficial · plataforma · comunidad · leer el SKILL.md
npx skills find busca, add instala, list muestra lo instalado, update actualiza. Con find-skills, el agente hace todo por ti.
Busca según la necesidad (no por el nombre) y compara las descripciones antes de instalar. Pero actualizar no es gratis: puede cambiar el comportamiento; prueba después.
npx skills find/add/list/update · buscar según el problema · el agente opera el CLI
No la instales para algo de un solo uso (basta con un prompt), si ya tienes una skill parecida, si proviene de una fuente desconocida que no has leído, para un contexto fijo (va en el CLAUDE.md) o "por si acaso".
Cada skill consume contexto y agrega un activador no deseado. La prueba de 3 preguntas (¿la uso con frecuencia?, ¿confío en la fuente?, ¿no tengo nada igual?) evita la acumulación.
prueba de 3 preguntas · el contexto cuesta · limpieza periódica · CLAUDE.md vs skill
Seis hábitos: leer la description, no el número; preferir lo reciente y en tendencia a lo antiguo y grande; buscar según el problema e instalar lo mínimo; tratar el catálogo como un mapa de nichos; actualizar y revisar en ciclos; saber cuándo no instalar.
Estos hábitos distinguen a quienes solo miran el leaderboard de quienes obtienen valor real, y completan la Trilha 1 con el mapa completo para la Trilha 2 (calidad).
description > número · movimiento > tamaño · mínimo > acumulación · mapa de nichos
Mapa de la ruta
Un archivo de texto que se convirtió en estándar en más de 50 agentes y suma 53,9M de instalaciones.
39 mil skills, una curva brutal y 100 nombres que representan el 43,7% de todo.
Ocho skills canónicas y el kit mínimo: el atajo para entender el ecosistema.
Desde cero hasta que funcione: un SKILL.md real, listo para copiar, instalado y activándose.
El número de instalaciones engaña: encuentra nichos, evalúa la fuente y sabe cuándo NO instalar.