Tu primera skill

Esta lección todavía está en pruebas: mejora con los comentarios de quienes la siguen. Si algo no está claro, hay que corregir la lección, no a ti.

Al final de esta lección, sabrás

convertir en skill una solicitud que repites;
escribir una descripción que le permita a Claude saber cuándo usarla;
llamar a tu skill con /nombre, o dejar que se active sola;
mejorarla después de probarla.

Por qué te interesa

En tu nota «Mis solicitudes» tienes instrucciones que copias a menudo. Una skill las guarda de una vez por todas: escribes /compte-rendu, o dices simplemente «haz el acta», y Claude aplica tu método. Es también exactamente así como funciona el compañero de este curso.

Antes de empezar


Necesitas	Claude Code, tu carpeta mon-espace-ia en modo Manual, y la lección 1 de este módulo
Duración	40 minutos
Costo	Incluido en tu suscripción

Entenderlo en 3 minutos

Una skill es una carpeta que contiene un archivo SKILL.md. Este archivo tiene dos partes:

un encabezado, entre dos líneas ---, con el nombre y sobre todo la descripción: Claude la lee para saber cuándo usar la skill;
las instrucciones, en Markdown, que Claude sigue cuando se usa la skill.

Según la documentación (24/10/2026):

	Ubicación	Para quién
Skill de proyecto	`.claude/skills/<nombre>/SKILL.md`, en tu carpeta de trabajo	Solo esta carpeta
Skill personal	`~/.claude/skills/<nombre>/SKILL.md`, en tu carpeta personal (en Windows: `%USERPROFILE%\.claude\skills\<nombre>\SKILL.md`)	Todos tus proyectos en esta computadora

Claude la usa cuando es útil, o cuando escribes /nombre. A diferencia de CLAUDE.md, solo el nombre y la descripción de una skill se leen en cada sesión; sus instrucciones solo se cargan cuando sirve: puedes poner en ella un método detallado sin hacer más pesada cada sesión.

Hagámoslo juntos

1Paso 1: Elegir la solicitud

Ejemplo: a menudo haces actas a partir de notas sueltas. Tu solicitud habitual se parece a esta:

Convierte estas notas en un acta: un título, la fecha, las decisiones y luego las acciones con una persona responsable. 15 líneas como máximo. Señala lo que falta en lugar de inventarlo.

2Paso 2: Pedirle a Claude que cree la skill

En mon-espace-ia, en modo Manual, escribe:

Crea una skill de proyecto llamada compte-rendu, en .claude/skills/compte-rendu/SKILL.md. Descripción: «Convierte notas sueltas en un acta corta (decisiones, acciones, responsables). Usar cuando doy notas de una reunión o de una llamada.» Instrucciones: un título, la fecha, las decisiones y luego las acciones con una persona responsable, 15 líneas como máximo, y señalar lo que falta en lugar de inventarlo. Muéstrame el archivo antes de crearlo.

Lee el archivo propuesto: el encabezado, la descripción, las instrucciones. Claude Code te pide permiso, porque la carpeta .claude está protegida: en modo Manual, escribir dentro requiere tu aprobación. Permítelo si el contenido te convence, solo por esta vez: «Permitir» en la app, el simple «Yes» en la terminal. No aceptes la opción que permite las escrituras en .claude durante toda la sesión (en la terminal: «Yes, and allow Claude to edit files in this project’s .claude folder for this session»): Claude podría entonces modificar tus skills y tu configuración sin volver a preguntar hasta el final de la sesión.

3Paso 3: Llamarla por su nombre

Abre una Nueva sesión en la misma carpeta (en la app: el botón Nueva sesión; en la terminal: /exit y luego vuelve a iniciar claude, o escribe /reload-skills) y luego escribe:

/compte-rendu Reunión del día 12. Marc quiere retrasar el lanzamiento. Mantenemos la fecha del 3. Julie se encarga de los elementos visuales. Presupuesto todavía no aprobado.

(Estas notas son inventadas.) El acta debe seguir tu método y señalar que el presupuesto no está aprobado.

4Paso 4: Dejar que se active sola

En la misma sesión, escribe simplemente:

Estas son mis notas de la llamada de esta mañana, conviértelas en algo limpio: llamada con el servicio de catering, confirma 40 comensales, presupuesto por recibir el lunes, hay que enviarle la distribución de las mesas.

Claude debería reconocer la situación descrita en la descripción y aplicar la skill.

Ahora te toca a ti

Tu propia skill.

Elige en «Mis solicitudes» una solicitud que repites.
Conviértela en skill de proyecto, con una descripción que empiece por el caso de uso.
Pruébala una primera vez con /nombre.
Pruébala una segunda vez describiendo simplemente tu necesidad.
Si no se activa sola, haz la descripción más precisa.

Comprobar

Funcionó si:

el archivo .claude/skills/<nombre>/SKILL.md existe, con una descripción que dice cuándo usarla;
la llamada con /nombre aplica tu método;
al menos una prueba sin el nombre la activó, quizá después de precisar la descripción.

Errores frecuentes:

una descripción vaga («ayuda para los documentos»): Claude no sabe cuándo usarla;
una skill que lo hace todo: una skill, una tarea;
poner en la skill información sensible: como CLAUDE.md, se envía a la IA cuando sirve.

Guardar y retomar

Cuando una skill de proyecto te sirva en todas partes, pídele a Claude Code que la copie como skill personal (~/.claude/skills/), después de tu aprobación.

Para ir más lejos

opcional

La documentación oficial de las skills, en inglés: code.claude.com/docs/en/skills (opciones del encabezado, skills que ejecutan comandos, compartir en un plugin).

Palabras nuevas

4 palabras explicadas

Palabra	Lo que significa
SKILL.md	El archivo de una skill: un encabezado (nombre, descripción) e instrucciones
Encabezado	Las líneas entre dos `---` arriba del archivo, que describen la skill
Skill de proyecto	Una skill guardada en la carpeta de trabajo, que solo se puede usar ahí
Skill personal	Una skill guardada en tu carpeta personal, que se puede usar en todos tus proyectos

Puntos que quedan por verificar: la llamada a las skills de proyecto desde la app de escritorio, en captura real.