aprende vibe codingaprende vibe coding

Claude Skills: qué son, cómo instalarlas y cómo saber si valen la pena

Escrito por Jon28 de agosto de 2026

Claude Skills: qué son, cómo instalarlas y cómo saber si valen la pena cover image

Para armar un directorio de skills terminé leyendo cientos de archivos SKILL.md. Repos de Anthropic, de Microsoft, de Vercel, y también de gente que subió algo un domingo a la tarde.

Dos cosas me quedaron claras. La primera, que casi todo el material bueno está en inglés. La segunda, que la mayoría de los artículos explican qué es una skill pero no las dos cosas que realmente importan cuando las usás todos los días: cuánto contexto te consumen y cómo saber si podés confiar en ellas.

Esta es la guía que me hubiera servido antes de instalar la primera.



Qué es exactamente una skill

Una skill es una carpeta con un archivo SKILL.md adentro. Eso es todo.

El archivo tiene dos partes: un encabezado con el nombre y una descripción, y abajo las instrucciones escritas en markdown. Puede traer además scripts, archivos de referencia o ejemplos que el agente lee solo cuando los necesita.

Lo importante no es el contenido sino cuándo se carga. La skill no está corriendo todo el tiempo. El agente lee únicamente la descripción, y si lo que le pediste coincide con esa descripción, ahí recién carga las instrucciones completas.

Por eso la descripción es la parte más importante de una skill. Si está mal escrita, la skill nunca se activa - por más buena que sea. Leyendo repos me crucé con varias que hacían cosas excelentes y tenían una descripción tan vaga que el agente jamás las iba a elegir.

Y por eso también las skills funcionan en cualquier agente que sepa leer markdown: Claude Code, Codex, Cursor, Gemini CLI, Windsurf, Zed. No es un formato exclusivo de Claude, aunque el nombre haya quedado pegado.

skill_md.png


Skill o MCP: la confusión más común

Es la pregunta que más veo y la respuesta es bastante simple.

Un MCP le da al agente una capacidad nueva. Conectarse a tu base de datos, manejar un navegador, leer tu Notion. Antes no podía hacerlo; ahora sí.

Una skill no agrega capacidades. Le da un método para algo que ya puede hacer. Le explica cómo hacerlo bien, en qué orden, con qué criterio.

El MCP le da manos. La skill le da el manual.

Un ejemplo concreto de mi propio trabajo: tengo el MCP de DataForSEO conectado, que es lo que le permite al agente traer volúmenes de búsqueda reales. Pero saber qué keywords pedir, cómo interpretar la tendencia y qué hacer con esos datos — eso viene de una skill de SEO.

Sin el MCP no hay data. Sin la skill hay data y ningún criterio.

Se usan juntos, y de hecho muchas skills están escritas asumiendo que tenés cierto MCP instalado. Conviene leer los requisitos antes.


Cómo instalar una skill

La forma más rápida es el registro skills, que funciona con más de 30 agentes distintos. No hace falta que la skill esté publicada en ningún lado: apuntás al repo de GitHub y listo.

Probarla una sola vez, sin instalar nada

Mi opción favorita cuando quiero ver qué hace antes de comprometerme:

npx -y skills use owner/repo@nombre-de-la-skill | claude

Corre la skill en esa sesión y no te deja nada en el disco. Si no te sirvió, cerrás la terminal y se terminó.

Instalarla en un proyecto

npx skills add owner/repo --skill nombre-de-la-skill --agent claude-code

Instalarla global, para todas tus sesiones

Se agrega -g al final:

npx skills add owner/repo --skill nombre-de-la-skill --agent claude-code -g

Cambiás --agent por codex, cursor, gemini o el que uses. La misma skill, el mismo comando.

A mano

Si preferís, clonás el repo y copiás la carpeta de la skill a ~/.claude/skills/. Es exactamente lo mismo que hace el comando, sin intermediarios.

⚠️ Ojo con un detalle que casi nadie aclara: un repo puede contener varias skills. El repo ponytail tiene adentro ponytail-review, por ejemplo. No son la misma cosa y se instalan por separado. Cuando busques, fijate si estás mirando el repo o la skill puntual.


El costo que nadie te cuenta: las skills ocupan contexto

Esta es la parte que aprendí a los golpes armando el directorio.

Cuando una skill se activa, sus instrucciones entran en tu ventana de contexto. Una skill chica te consume unos pocos cientos de tokens. Una skill grande, con referencias y ejemplos incluidos, te puede comer varios miles.

Multiplicá eso por diez skills instaladas y ya arrancaste la sesión con una parte del contexto ocupada antes de escribir la primera línea.

Cuando armé la base de datos del directorio agregué un campo con los tokens que carga cada skill, justamente porque me parecía el dato más útil y el que nadie mostraba. Hay skills que hacen lo mismo que otras usando la décima parte del contexto.

Dos reglas simples que sigo:

  • Global solamente lo que uso siempre. El resto va por proyecto o lo pruebo con skills use y no lo instalo.
  • Si dos skills hacen lo mismo, me quedo con la más liviana. El agente no trabaja mejor porque le des más texto.

Hay incluso skills cuyo único trabajo es ahorrarte tokens. La que uso es caveman, que hace que el agente te responda en un estilo comprimido sin perder la parte técnica. Suena a chiste y funciona.


Cómo saber si una skill sirve y si es segura

Acá va lo que más me importa y sobre lo que casi no encontré nada escrito.

Una skill son instrucciones que vos le das a un agente con acceso a tu terminal, tus repos y a veces tus API keys. No es un paquete de npm auditado. Es un archivo de texto que subió alguien.

Esto no es para asustarte. Es para que apliques el mismo sentido común que usarías con cualquier otra cosa que instalás.

Lo que miro antes de instalar

  1. Las estrellas y la fecha del último commit. Un repo con muchas estrellas y actualizado hace poco pasó por muchos ojos. Uno con tres estrellas y sin tocar hace seis meses, no.
  2. Los issues y los PRs abiertos. Si hay gente reportando y el autor responde, buena señal. Si hay issues sin contestar desde hace meses, la skill probablemente ya no funcione.
  3. El SKILL.md completo, leído de arriba a abajo. Es texto plano. Son literalmente las instrucciones que le vas a dar a tu agente. No hay excusa para no leerlo — te lleva dos minutos y es la mejor auditoría disponible.
  4. Los scripts que trae. Si la skill ejecuta código, mirá qué hace ese código. Especialmente si pide variables de entorno o hace llamadas a un dominio que no conocés.
  5. Si es oficial. Anthropic, Microsoft, Vercel, Linear, Stripe y varias más publican sus propias skills. Si existe la oficial para lo que necesitás, empezá por ahí.

El truco que más uso

Le paso la URL del SKILL.md a otro agente y le pido que la audite antes de instalarla. Algo así:

Leé esta skill y decime qué hace exactamente, qué archivos toca,
qué comandos ejecuta, a qué dominios se conecta y si hay algo
que no debería estar ahí. Sé escéptico.

Es el mismo principio que uso para depurar código: una IA supervisando a la otra. Tarda treinta segundos y te evita instalar cosas a ciegas.


Las skills que uso todos los días

Para no quedarme en la teoría, estas son las que tengo instaladas y por qué:

  • Diseño. apple-design y las de Emil Kowalski. Son las que más me cambiaron el resultado — el agente pasa de hacer interfaces genéricas a cuidar espaciados, tipografía y animaciones. Hay varias más en skills de diseño.
  • SEO y GEO. Para auditar sitios, revisar schema y preparar las páginas para que las citen los buscadores con IA. Las tengo agrupadas en skills de SEO.
  • Investigación. Una que sale a buscar qué se dijo sobre un tema en los últimos 30 días en Reddit, X, YouTube y Hacker News. El skill last30days uso antes de decidir si construyo algo.
  • Contexto. caveman, para que las respuestas ocupen menos.
  • Marketing y copy. Para revisar textos de landing pages con criterio de conversión y no de adorno. Están en skills de marketing.

Además tengo un par que escribí yo para trabajos que repito seguido: una que desarma visualmente un sitio ajeno para entender cómo está construido, y otra para armar páginas animadas. Esa es la otra mitad del asunto, cuando algo lo hacés más de tres veces, conviene que sea una skill.


Dónde encontrar skills

El lugar más completo es skills.sh (Vercel) y es muy bueno pero esta en ingles solamente.

El problema que me encontré es que la gran mayoría de la gente que construye en español no consume contenido técnico en inglés, y se pierde skills que le servirían. Por eso armé skillsagentes.com: las mismas skills, con la explicación de qué hace cada una, cuándo conviene usarla y cuándo no, en español.

Podés navegar todas las skills, verlas por categoría, o mirar el ranking si querés empezar por las más usadas. También están los servidores MCP, que como vimos son la otra mitad del combo.

Es gratis y no hace falta registrarse. Si te falta alguna, se puede sugerir.

directorio_de_skills_para_claude_code.png


Por dónde empezar hoy

Si nunca instalaste una, hacé esto en orden:

  1. Elegí una sola skill que resuelva algo que hacés seguido. No diez.
  2. Probala con npx -y skills use ... | claude antes de instalarla.
  3. Leé el SKILL.md completo. Dos minutos.
  4. Si te sirvió, instalala global. Si no, no dejaste nada instalado.

La parte que más me gusta de todo esto es que no es programar. Es escribir bien lo que querés que pase. Y eso ya lo sabés hacer.

JK

Jon Kraayenbrink

Builder & Founder @aiselfi

Siempre me gustó construir cosas. Decidí ir ALL-IN y aprender IA. Ahora construyo productos digitales usando Vibe Coding y enseño a otros cómo hacer lo mismo.