1.1 Anatomía de un skill

Información
⏱ Duración: ~25 min · 🎯 Objetivo: entender qué es un skill, cómo se arma un SKILL.md y por qué la descripción decide cuándo Claude lo invoca.

Un skill es, textualmente, una “carpeta de instrucciones, scripts y recursos que Claude carga dinámicamente” para mejorar en tareas especializadas. Funcionan en todas partes —chats normales, Proyectos y Cowork— y se activan automáticamente cuando el trabajo lo requiere. Si una tarea necesita varias áreas de experiencia, Claude combina varios skills solos.

Paso 1 — Reconoce la anatomía

Todo skill es una carpeta que contiene, como mínimo, un archivo SKILL.md (el núcleo). Ese archivo empieza con frontmatter YAML con los metadatos:

  • name — nombre legible, máximo 64 caracteres (ej. Revisión QBR).
  • description — qué hace y cuándo usarlo, máximo 200 caracteres. Es el campo crítico: Claude lo usa para decidir cuándo invocar el skill.
  • dependencies (opcional) — ej. python>=3.8, pandas>=1.5.0.

Paso 2 — Entiende la divulgación progresiva

Claude no carga todo de golpe; lo hace por niveles:

  1. Nivel 1 — metadatos: lee name + description para decidir si carga el skill.
  2. Nivel 2 — cuerpo: carga el Markdown de SKILL.md si lo necesita.
  3. Nivel 3 — archivos: abre recursos adicionales solo cuando aplican.
Consejo
Por eso una descripción precisa vale oro: si dice mal cuándo usar el skill, Claude no lo invocará en el momento correcto.

Paso 3 — Suma recursos y scripts

Dentro de la carpeta del skill puedes incluir:

  • Assets / references: archivos como REFERENCE.md, guías de marca, logos, paletas, plantillas, esquemas o datos (CSV/JSON). Referéncialos desde SKILL.md para que Claude sepa cuándo abrirlos.
  • Scripts: código ejecutable (Python con pandas/numpy/matplotlib, JavaScript/Node.js) que Claude corre cuando hace falta. Al cargar el skill puede instalar paquetes de PyPI/npm.

Paso 4 — Empaqueta correctamente

Para compartir un skill:

  • El nombre de la carpeta debe coincidir con el nombre del skill.
  • Comprime la carpeta en un ZIP: la carpeta del skill debe quedar en la raíz del ZIP (no los archivos sueltos, no anidada en una subcarpeta).
mi-skill.zip
└── mi-skill/
    ├── SKILL.md
    └── resources/

Paso 5 — Sabe dónde viven

Tus skills instalados aparecen en Customize > Skills (equivalente a Settings > Capabilities > Skills). En Claude Desktop y en Cowork, los skills que tú agregas se guardan localmente en tu computadora.

Aviso
Skills requieren tener habilitado “Code execution and file creation”. En Enterprise, el Owner debe encender ambos: “Code execution and file creation” y “Skills” en Organization settings > Skills.

✅ Checkpoint

Puedes explicar con tus palabras qué contiene un SKILL.md, por qué description (≤200 caracteres) es el campo que dispara la invocación, y cómo se empaqueta un skill en un ZIP con la carpeta en la raíz.

¿Te quedó claro? — 2 preguntas

1. Micro-ejercicio — escribe dos description para tu skill QBR: una vaga y una precisa. Predice cuál hará que Claude invoque el skill en el momento correcto y explica por qué. Ejemplo de vaga: “Ayuda con reportes”. Ejemplo de precisa: “Genera un QBR con resumen ejecutivo, KPIs vs meta, riesgos y decisiones cuando el usuario pide una revisión trimestral de negocio”. La precisa gana: Claude sólo tiene el name + la description para decidir cuándo cargar el skill, así que nombrar la tarea y el disparador concreto es lo que provoca la invocación.

2. ¿Cómo debe quedar la carpeta dentro del ZIP al empaquetar? La carpeta del skill (con el mismo nombre del skill) debe estar en la raíz del ZIP, no los archivos sueltos ni anidada en una subcarpeta.

Workshop Claude Avanzado · Grupo Salinas · v1.0 · 2026