Saltar al contenido
Entrar
Plano del curso

Misión 17 de 23

  1. Dónde viven
  2. Anatomía de un SKILL.md
  3. Tres skills para copiar
  4. Buenas prácticas
  5. Pruébalo

Skills — tus comandos reutilizables

Qué son las skills, dónde se guardan, cómo crearlas con argumentos y cuándo las usa Claude solo. Con tres skills listas para copiar.

  • Superpoderes
  • 10 min
  • 5 pasos
  • Revisada el

Al terminar sabrás

  • Crear una skill con su SKILL.md y decidir si la invocas tú o Claude
  • Pasarle argumentos con $ARGUMENTS o con argumentos con nombre
  • Tener tres skills útiles funcionando en tus proyectos

Una skill es un paquete de instrucciones que Claude carga cuando hace falta. Sirve para dos cosas:

  1. Comandos tuyos: escribes /revisar-textos y Claude sigue siempre el mismo procedimiento.
  2. Conocimiento que se activa solo: si la descripción encaja con lo que estás haciendo, Claude la carga por su cuenta (por ejemplo, tu guía de estilo cuando escribe textos).

Dónde viven

Ubicación Ruta Disponible en
Personal ~/.claude/skills/<nombre>/SKILL.md Todos tus proyectos
Proyecto .claude/skills/<nombre>/SKILL.md Este proyecto (y quien lo comparta contigo)
Plugin dentro de un plugin (lección 20) Donde esté instalado el plugin

Cada skill es una carpeta con un SKILL.md dentro. Puede llevar más archivos (ejemplos, plantillas, scripts) que Claude lee solo cuando los necesita.

Anatomía de un SKILL.md

Archivo Markdown
---
description: Qué hace y cuándo usarla. Claude decide con esto si cargarla.
disable-model-invocation: true
---

Instrucciones en Markdown. Lo que escribas tras el comando llega en $ARGUMENTS.

Campos útiles del encabezado:

  • description (muy recomendado): cuándo sirve. Escríbela pensando en cuándo debería activarse.
  • disable-model-invocation: true: solo la lanzas tú con /nombre.
  • user-invocable: false: al revés, no aparece en el menú / y solo la usa Claude (conocimiento de fondo).
  • allowed-tools: herramientas que puede usar sin pedirte permiso mientras la skill está activa, por ejemplo Bash(git *).
  • arguments: nombres para los argumentos, que luego usas como $nombre.

Si escribes !`comando` dentro de la skill, se ejecuta antes y su resultado se inserta en las instrucciones. Muy útil para darle datos frescos.

Tres skills para copiar

1. Revisar textos — /revisar-textos

.claude/skills/revisar-textos/SKILL.md:

Archivo Markdown
---
description: Revisa los textos visibles de la web (ortografía, claridad, tono y promesas no demostrables). Úsala antes de publicar.
disable-model-invocation: true
---

Revisa todos los textos visibles del proyecto (o solo $ARGUMENTS si lo indico).

1. Corrige ortografía y gramática.
2. Marca frases vagas y propón una versión concreta.
3. Señala cualquier cifra, opinión de cliente o promesa que no esté respaldada:
   no la inventes ni la mantengas sin preguntarme.
4. Respeta el tono definido en CLAUDE.md.

Entrega una tabla: archivo, texto actual, propuesta, motivo. No cambies nada
hasta que yo lo apruebe.

2. Resumen de cambios — /que-ha-cambiado

Archivo Markdown
---
description: Resume los cambios sin guardar y señala riesgos. Úsala cuando pregunte qué ha cambiado.
---

## Cambios actuales

!`git diff HEAD --stat`

Resume en 3–5 puntos, en lenguaje no técnico, qué ha cambiado y para qué.
Después, lista riesgos: algo que pueda romperse, datos personales, textos a revisar.

Esta no lleva disable-model-invocation, así que Claude también la usará cuando le preguntes «¿qué hemos cambiado?».

3. Publicar — /publicar

Archivo Markdown
---
description: Comprueba y publica la web. Solo cuando yo lo pida.
disable-model-invocation: true
arguments: [entorno]
---

Vamos a publicar en: $entorno (si está vacío, pregúntame).

1. Pasa la revisión de textos y /code-review. Si hay algo grave, para y dímelo.
2. Genera la versión de producción y comprueba que no hay errores.
3. Publica siguiendo las instrucciones de CLAUDE.md.
4. Dame la URL y una lista de lo que debería comprobar en el móvil.

Úsala con /publicar pruebas o /publicar produccion.

Buenas prácticas

  • Una skill, un trabajo. Mejor tres pequeñas que una que lo hace todo.
  • Menos de 500 líneas en el SKILL.md; lo largo, a archivos de apoyo.
  • Cuando repitas un encargo por tercera vez, conviértelo en skill.
  • Pídele a Claude que te las escriba: «crea una skill de proyecto que haga X».

Pruébalo

Crea /revisar-textos en tu proyecto y pásala a tu web. Acepta dos o tres propuestas y rechaza una, explicando por qué. Si el motivo es general, añádelo a la skill.

Documentación oficial