Como crear skills en Claude Code

Si llevas un tiempo usando Claude Code, seguramente ya sabes lo potente que es. Pero hay una funcionalidad que todavía muchos usuarios no le sacan todo el partido y que puede cambiar bastante cómo trabajas con él (y ahorrarte tokens): el sistema de skills.

Un skill es básicamente un fichero de texto que le enseña a Claude a comportarse como un experto en un dominio concreto. Una vez instalado, Claude lo detecta según el contexto y lo aplica solo, sin que tengas que explicarle nada cada vez.

Vamos a ver cómo se crea paso a paso. Para ello vamos a crear un skill experto en monetización con Google AdSense: cuando mencione AdSense, RPM, CTR o le enseñe código HTML preguntando por ingresos, o directamente invoque el skill, Claude actuará como un consultor especializado sin que yo tenga que explicarle nada.

Cómo crear un skill paso a paso

Paso 1: define el skill antes de escribir nada

Lo más importante es tener claro el alcance antes de abrir el editor. Hazte estas cuatro preguntas:

• ¿Qué debe hacer el skill?
• ¿Cuándo debe activarse?
• ¿Qué formato tendrá la respuesta?
• ¿Necesita ficheros de referencia con información adicional?

En mi skill de AdSense: quería que actuara como consultor experto, que se activara al mencionar ciertos términos, que respondiera siempre con este esquema —Diagnóstico → Plan → Código → Alertas de políticas— y que usara ficheros de referencia para el conocimiento más extenso.

Si no tienes esto claro antes de empezar, acabarás reescribiendo el skill varias veces.

Paso 2: organiza la estructura de ficheros

Un skill bien organizado tiene esta estructura:

mi-skill/
├── SKILL.md                    ← instrucciones principales (obligatorio)
└── references/                 ← conocimiento adicional (opcional)
    ├── placement-guide.md
    ├── ad-code-templates.md
    └── policy-checklist.md

El SKILL.md es lo que Claude Code carga en contexto cuando el skill se activa. Los ficheros de references/ los lee solo cuando los necesita, lo que mantiene el contexto limpio y evita malgastar tokens con información que igual no hace falta.

Paso 3: dónde guardar el skill

Antes de crear los ficheros tienes que decidir dónde guardarlos, porque eso determina dónde estará disponible el skill. Tienes dos opciones:

• Carpeta personal ~/.claude/skills/: el skill está disponible en todos tus proyectos.
• Carpeta de proyecto .claude/skills/ dentro del repositorio: el skill solo aplica a ese proyecto concreto.

El de AdSense lo guardé en la carpeta personal porque me sirve en cualquier proyecto web. Si el skill tuviera instrucciones específicas de un proyecto concreto —las convenciones de ese repositorio, la estructura de su base de datos— lo pondría dentro del proyecto.

Paso 4: crear la carpeta del skill

Creo la carpeta del skill dentro de mi directorio personal de Claude:

mkdir -p ~/.claude/skills/adsense-expert

Paso 5: escribir el SKILL.md

Dentro de esa carpeta creo el fichero SKILL.md. Este fichero tiene que empezar siempre con el bloque de frontmatter YAML entre los marcadores ---:

---
name: adsense-expert
description: Experto en monetización con Google AdSense para proyectos web
  (HTML estático y Laravel). Úsalo siempre que el usuario mencione AdSense,
  monetización, anuncios, RPM, CTR, o quiera saber cómo ganar dinero con su web.
---
 
Eres un consultor senior especializado en monetización con Google AdSense.
 
Cuando el usuario comparta una página o proyecto web, sigue siempre este esquema:
 
1. Diagnóstico: analiza el tipo de página y el tráfico potencial
2. Plan de monetización: qué formatos de anuncio usar y dónde colocarlos
3. Código listo: snippets HTML o componentes Blade para Laravel
4. Alertas de políticas: qué puede poner en riesgo la cuenta de AdSense
 
[resto de instrucciones...]

El campo name es el nombre con el que podrás invocar el skill escribiendo /adsense-expert. El campo description es lo que Claude lee para decidir si debe cargarlo automáticamente, así que sé específico: indica cuándo usarlo y qué palabras clave deben dispararlo.

Paso 6: listo

En cuanto guardas el fichero, Claude Code detecta el cambio y el skill está disponible en tu sesión actual sin necesidad de reiniciar nada.

El skill en la práctica: añadir ficheros de apoyo

Aquí es donde el skill empezó a crecer de verdad. Conforme fui documentando mi conocimiento sobre AdSense me di cuenta de que había demasiada información para meterla toda en el SKILL.md principal: estrategias distintas según el tipo de página, snippets de código para cada formato de anuncio, las políticas de Google con sus matices...

La solución es añadir ficheros de referencia dentro de la misma carpeta:

adsense-expert/
├── SKILL.md                    ← instrucciones principales
└── references/
    ├── placement-guide.md      ← estrategias por tipo de página
    ├── ad-code-templates.md    ← snippets HTML y componentes Blade
    └── policy-checklist.md     ← riesgos y límites de las políticas de AdSense

En el SKILL.md le dices a Claude que esos ficheros existen y cuándo debe leerlos. Claude los cargará solo cuando los necesite, sin consumir contexto el resto del tiempo.

En placement-guide.md documenté las estrategias para seis tipos de página distintos: artículo de blog, homepage, página de categoría, herramienta, landing... Cada una tiene sus propias reglas y no es lo mismo colocar anuncios en un artículo largo que en una página de conversión, donde AdSense directamente no debería estar. En ad-code-templates.md metí todos los snippets HTML listos para copiar y un componente Blade reutilizable para Laravel con su config/ads.php y variables de entorno. Y en policy-checklist.md documenté los riesgos que pueden causar una suspensión de cuenta, con una tabla de qué está permitido y qué no, y qué hacer si te suspenden.

Todo ese conocimiento que antes tenía disperso en notas y conversaciones antiguas ahora lo tiene Claude disponible cuando lo necesita.

Cómo invocarlo

Una vez creado el skill tienes dos formas de usarlo. Puedes dejar que Claude lo detecte solo: si tu description está bien escrita, cuando menciones AdSense, RPM, CTR o le enseñes código HTML preguntando por ingresos, Claude cargará el skill automáticamente.

O puedes invocarlo tú directamente escribiendo el nombre del skill con una barra delante:

/adsense-expert

Yo prefiero la invocación automática para el día a día, pero el comando directo viene bien cuando quieres asegurarte de que Claude aplica el skill aunque la conversación no lo haya disparado de forma obvia.

Un consejo sobre la description

El campo description es lo más importante del fichero. Un skill brillante que no se activa en el momento correcto no sirve de nada.

Cuando lo escribas, sé explícito sobre cuándo usarlo —"Úsalo siempre que..." en lugar de "Puede usarse cuando..."— e incluye los términos concretos que el usuario podría mencionar. No solo los obvios, sino también los contextos implícitos: si alguien te enseña código HTML preguntando cómo mejorarlo para ganar dinero, eso también debería disparar el skill aunque no haya mencionado AdSense.

Como puedes ver, crear un skill es básicamente articular bien el conocimiento que ya tienes: qué sabes, cuándo es relevante y cómo quieres que se aplique. Si tienes experiencia en algún dominio —SEO, accesibilidad, rendimiento web, diseño de base de datos— ya tienes todo lo que necesitas para crear un skill útil.