Saltar al contenido
MaestrIA

Formación › Programar con Claude Code en 12 horas › Hora 8

Programar con Claude Code en 12 horas · hora 8 de 12

Skills (y comandos)

Una skill convierte un procedimiento que repites en un /comando que Claude ejecuta igual cada vez. Verás la skill real que escribió Claude Code para revisar el parte antes de enviarlo, y un permiso de su cabecera que dice lo contrario que su texto.

Al terminar sabrásCrear una skill de proyecto con una descripción precisa, decidir si Claude puede cargarla solo o únicamente cuando la pides, y revisar su configuración contra la documentación oficial.

60 minutos· 1 esquema· 6 preguntas· 1 ejercicio· entregable

Repaso

Comprueba De la hora 7: en modo dontAsk, ¿qué pasa con una edición que en modo manual te pediría confirmación?

Comprueba De la hora 7: proteges una carpeta con una regla deny sobre Bash(rm *). ¿Por qué puede no bastar?

Comprueba De la hora 3: ¿qué entra en el contexto al empezar cada sesión?

Vocabulario

Skill
Una carpeta con un SKILL.md que Claude carga cuando la tarea coincide con su descripción, o cuando escribes /su-nombre.
disable-model-invocation
Opción que impide que Claude cargue la skill por su cuenta: solo se ejecuta cuando la pides.
allowed-tools
Herramientas que la skill puede usar sin preguntar mientras se ejecuta.
$ARGUMENTS
Lo que escribes tras el nombre del comando, que la skill recibe.

El ejemplo: una skill para revisar el parte

Antes y después Crear una skill de proyecto

Skills y comandos son lo mismo

Según la documentación de Claude Code, los comandos personalizados se han fusionado con las skills: un fichero en .claude/commands/deploy.md y una skill en .claude/skills/deploy/SKILL.md crean el mismo /deploy y funcionan igual. Los ficheros antiguos de .claude/commands/ siguen funcionando. Las skills añaden una carpeta para ficheros de apoyo y opciones en la cabecera.

DóndeRutaPara quién
Personal~/.claude/skills/<nombre>/SKILL.mdTú, en todos tus proyectos
Proyecto.claude/skills/<nombre>/SKILL.mdEste repositorio; en Git, para el equipo
Plugin<plugin>/skills/<nombre>/SKILL.mdDonde esté el plugin, como /plugin:nombre
Cómo carga una skillUna skill se carga por capas: el modelo siempre ve su nombre y descripción; solo si la tarea lo necesita lee el fichero SKILL.md, y solo si hace falta usa sus recursos y scripts. Por eso puedes tener muchas sin llenar el contexto.1 · Nombre y descripciónsiempre a la vista2 · SKILL.mdse lee si la tarea lo necesita3 · Recursos y scriptssolo si hacen faltaPoco contexto fijo, mucho conocimiento disponible
La carga progresiva: Claude ve la descripción y lee el resto solo si la tarea la necesita.

Las opciones que más importan

  • description: qué hace y cuándo usarla. Es lo que Claude lee para decidir si la carga.
  • disable-model-invocation: true: para procedimientos con efectos (desplegar, enviar, publicar) que solo deben ejecutarse cuando tú lo pidas. Además, su descripción no ocupa contexto hasta que la uses.
  • allowed-tools: lo que puede hacer sin preguntar mientras se ejecuta. No restringe las demás herramientas.
  • $ARGUMENTS: lo que escribes tras el comando, como /revisar-parte datos/otro.csv.

Claude Code trae además skills incluidas, como /code-review, /batch, /debug o /verify.

Practica

Clasifica ¿Debe poder cargarla Claude solo, o solo cuando tú la pidas?

  1. Las convenciones de nombres de la API del proyecto
  2. Desplegar a producción
  3. Revisar el parte antes de enviarlo
  4. Cómo escribir pruebas en este repositorio
  5. Enviar el parte por correo a dirección

Comprueba lo que has aprendido

Comprueba Tienes .claude/commands/revisar.md y quieres pasarlo a skill. ¿Qué cambia para quien lo usa?

Comprueba La skill real declara allowed-tools: Bash(node:*) y su texto dice que solo informa. ¿Qué haces?

Comprueba ¿Para qué sirve disable-model-invocation: true?

Entregable Tu skill de proyecto

Crea una skill de proyecto para un procedimiento que repitas (revisar, preparar un informe, comprobar antes de un commit). Decide si Claude puede cargarla solo o solo cuando la pidas, revisa que allowed-tools no permita más de lo que necesita y pruébala dos veces. Pega aquí el SKILL.md y qué tuviste que corregir.

Está bien si: la descripción dice qué hace y cuándo usarla; lo que tiene efectos lleva disable-model-invocation: true; cada regla de allowed-tools nombra un comando concreto; y la has lanzado dos veces con el mismo resultado. Tiempo: unos 25 minutos.

Lo esencial

  • Skills y comandos son lo mismo: un fichero en .claude/commands/ o una carpeta en .claude/skills/ crean el mismo /comando.
  • La descripción decide cuándo se carga; disable-model-invocation la reserva para cuando tú la pidas.
  • Lo que tiene efectos (desplegar, enviar, publicar) se lanza solo a mano.
  • Revisa lo que escribe el agente, también sus permisos: que la regla no permita más de lo que promete el texto.

Fuentes y para seguir

Lección revisada el 24/10/2026 con la documentación oficial enlazada en sus fuentes. Revisamos los cursos cada trimestre.