Cómo instalar una skill: la primera, paso a paso

Si nunca instalaste una skill, capaz pensás que es cosa de gente que programa. No lo es. En cinco minutos tenés la primera instalada y la usás hablándole a tu agente como le hablarías a alguien del equipo.

Qué es una skill

El SKILL.md arranca con un nombre y una descripción. Con la descripción, el agente decide cuándo usarla; el resto del archivo le explica cómo hacer el trabajo. Algunas traen scripts o ejemplos en la misma carpeta, pero lo central es siempre ese archivo.

Claude Code sigue el estándar abierto Agent Skills, así que muchas skills andan igual en Codex, Cursor, opencode y otros agentes.

Sin skill y con skill

Un ejemplo con humanizer, la que usamos para que los textos de este sitio no suenen a máquina (esta nota también pasó por ahí).

Dos caminos

Copiar el texto. Abrís el SKILL.md en GitHub, lo copiás y lo pegás en el chat antes de tu pedido. No instalás nada, y para probar alcanza. El problema es que lo tenés que pegar cada vez.

Instalarla. La guardás una vez en la carpeta de skills de tu agente. Desde ahí está en todas tus sesiones: la llamás por su nombre o el agente la usa solo cuando ve que hace falta.

Si la vas a usar más de una vez, instalala.

Dónde viven las skills en Claude Code

• ~/.claude/skills/<nombre>/SKILL.md: tus skills personales. Están en todos tus proyectos.

• .claude/skills/<nombre>/SKILL.md adentro de un repositorio: sólo para ese proyecto. Si la commiteás, la tiene todo el equipo.

• Plugins: un plugin puede traer varias skills juntas. Se instala desde un marketplace y sus skills se llaman con el nombre del plugin adelante (/plugin:skill).

Instalá tu primera skill

Vamos con humanizer, de Siqi Chen, con licencia MIT. Los pasos sirven para cualquier otra: cambiás el repositorio y el nombre.

1. 01

   Leé lo que vas a instalar. Una skill son instrucciones que tu agente va a seguir al pie de la letra. Abrí el repositorio y mirá el SKILL.md antes, como mirarías un script antes de correrlo.

2. 02

   Instalala con el CLI skills. Necesitás Node.js. En la terminal:

$ npx skills add blader/humanizer --global --agent claude-code

--global la deja en tu carpeta personal (~/.claude/skills/) y no en el proyecto; --agent claude-code dice para qué agente es. Si no ponés esas opciones, el comando te las pregunta.

3. 03

   O hacelo a mano, con git. Si preferís no usar el CLI:

$ git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer

4. 04

   Fijate que esté. En Claude Code escribí / y buscá humanizer en la lista. Si no aparece y la carpeta ~/.claude/skills es nueva, corré /reload-skills. Desde la terminal, npx skills ls -g lista las que instalaste con el CLI.

5. 05

   Usala. Por su nombre:

› /humanizer

O pedila como hablás: «pasá este párrafo por humanizer, que no suene a IA».

Cuando viene como plugin

Algunas skills se reparten como plugin de Claude Code. Adentro de Claude Code:

› /plugin marketplace add blader/humanizer
› /plugin install humanizer@humanizer

La primera línea suma el marketplace (el repositorio) y la segunda instala el plugin. Instalada así, la skill se llama con el prefijo: /humanizer:humanizer. El README de humanizer pide Claude Code 2.1.142 o más nuevo para este camino.

Superpowers, por ejemplo, está en el marketplace oficial de Anthropic y se instala con una línea:

› /plugin install superpowers@claude-plugins-official

Para encontrar más

Las que usamos todos los días están en nuestro catálogo de skills, cada una con su autor, su licencia y el comando para instalarla. Para buscar por tu cuenta, npx skills find busca por palabra:

$ npx skills find remotion

Para llevarte

• Una skill es una carpeta con un SKILL.md: instrucciones para tu agente, no un programa.

• Podés copiar el texto para probar o instalarla para tenerla siempre.

• En Claude Code viven en ~/.claude/skills/ (todos tus proyectos) o en .claude/skills/ (un proyecto).

• npx skills add <usuario>/<repo> la instala y /nombre la usa.

• Antes de instalar, leé el SKILL.md.