Mapa de la ruta
Contenido detallado
🧩 Qué es una Skill
Desde el primer principio: una carpeta, un archivo SKILL.md y conocimientos empaquetados que enseñan a Claude a hacer algo específico.
Una Skill es una carpeta cuyo nombre es el de la skill y que contiene un archivo SKILL.md. Este archivo es todo lo que se necesita para que la skill exista.
Es el bloque elemental. Si entiendes la carpeta y el archivo, todo lo demás (refs, scripts) es solo una adición opcional.
Carpeta = identidad; SKILL.md = instrucciones; nada más es obligatorio.
La skill empaqueta un procedimiento completo —pasos, reglas, ejemplos— que Claude sigue de forma coherente cada vez.
En vez de volver a explicar un flujo en cada conversación, lo guardas una vez y queda reutilizable.
Reutilización, consistencia, conocimiento duradero.
El cuerpo del SKILL.md es Markdown común: títulos, listas, bloques de código. Claude lo lee como instrucciones que debe seguir.
Escribes en el mismo formato que ya usas para documentar, sin aprender un lenguaje nuevo.
Markdown, instrucciones claras, pasos numerados.
Un prompt vive en una conversación y desaparece. Una skill queda en el disco, se puede versionar y se activa sola cuando la tarea coincide.
Saber cuándo convertir un prompt repetido en una skill ahorra horas.
Efímero vs. duradero; manual vs. automático.
Las skills pueden crear videos (HyperFrames), revisar código, diseñar interfaces, generar diagramas — cualquier flujo repetible.
Ver la variedad te abre la mente a lo que vale la pena convertir en una skill para tu día a día.
Flujos repetibles, dominios variados, este curso nació de una skill.
Crear la skill más simple no requiere programar: describes el procedimiento en texto y listo.
Elimina la barrera de entrada: cualquier persona que escriba bien puede crear una skill útil.
Barrera baja; empieza con texto y evoluciona después.
📝 Anatomía del SKILL.md
Todo SKILL.md empieza con dos líneas: name y description. La description es lo que Claude lee para decidir cuándo usar la skill: es el activador.
En la parte superior del archivo, entre --- e ---, quedan los metadatos en YAML: al menos name e description.
Es la única parte que siempre se carga en la memoria de Claude. Si te equivocas aquí, la skill se rompe.
YAML, delimitadores ---, metadatos.
O name es el identificador de la skill (kebab-case), normalmente igual al nombre de la carpeta.
Es como tú y Claude se refieren a la skill al invocarla.
kebab-case, único, igual que la carpeta.
A description dice QUÉ hace el skill y CUÁNDO usarlo. Es el texto que Claude consulta para decidir si activa el skill.
Una Description débil hace que la skill nunca se active. Es el elemento de mayor impacto en SKILL.md.
Disparador, «úsalo cuando…», especificidad.
Una buena description enumera frases concretas que activan la skill ("úsala cuando el usuario pida un video, un video explicativo, Shorts…").
Cuanto más se parezca a la forma de hablar del usuario, más confiable será la activación.
Frases desencadenantes, sinónimos, cubrir variaciones.
Después del frontmatter viene el cuerpo: el procedimiento, las reglas de oro, los comandos. Es lo que Claude ejecuta cuando se activa la skill.
Es donde reside el valor real de la skill: cuanto más claro, mejor el resultado.
Flujo ordenado, reglas no negociables, enlaces a refs.
Olvidar un ---, la indentación YAML incorrecta o una descripción demasiado vaga son los errores más comunes.
Reconocer el síntoma ("mi skill no se activa") ahorra tiempo de depuración.
Delimitadores, indentación, especificidad.
🧠 Divulgación progresiva
El concepto clave: Claude no carga todo de una vez. Name y description permanecen siempre en la memoria; el resto se carga solo cuando hace falta.
La ventana de contexto de Claude es finita. Cargar decenas de skills completas a la vez la saturaría.
Comprender el límite explica por qué existe la divulgación progresiva.
Ventana de contexto, costo, escala.
Solo el name y la description de cada skill instalada están siempre visibles para Claude: son livianos y económicos.
Explica por qué la description debe ser tan buena: es la única señal que siempre está presente.
Siempre activo, índice de skills, ligero.
Cuando la tarea coincide con la descripción, Claude abre el contenido completo de SKILL.md.
Es el momento en que las instrucciones detalladas entran en juego, bajo demanda.
On match, carga bajo demanda.
Los archivos de referencia y los scripts solo se leen cuando SKILL.md los señala y el paso los requiere.
Permite empaquetar mucho material pesado sin costo hasta el momento de usarlo.
On demand, referencias, scripts ejecutables.
Puedes tener decenas de skills instaladas y el contexto sigue siendo ligero, porque solo el índice está siempre presente.
Es lo que hace viable una biblioteca grande de skills sin perder rendimiento.
Escala, eficiencia, biblioteca grande.
Claude compara el pedido del usuario con las descriptions disponibles y elige la skill más adecuada.
Saber esto te ayuda a escribir descriptions que «ganan» la coincidencia correcta.
Coincidencia, relevancia, prioridad.
📂 Dónde están y cómo instalar
Las skills están en .claude/skills — en el proyecto (solo allí) o globalmente (en cualquier lugar). Instalarlo es copiar la carpeta o ejecutar un comando.
Una carpeta .claude/skills/ dentro del repositorio hace que el skill esté disponible solo en ese proyecto.
Ideal para skills específicas de un producto, versionadas junto con el código.
Alcance del proyecto, versionado y específico.
La carpeta global en tu directorio home (~/.claude/skills/) pone la skill a disposición en cualquier proyecto.
Perfecto para las skills personales que usas todo el tiempo, como la de videos.
Alcance global, reutilizable y personal.
Como solo es una carpeta, instalarla puede ser literalmente copiar y pegar en el lugar correcto (o descomprimir un zip).
Es como recibiste la skill de este curso: un zip con la carpeta dentro.
Copiar carpeta, zip, sin instalador.
Hay herramientas de línea de comandos que instalan skills de un catálogo con un solo comando.
Más rápido y estandarizado cuando la skill está publicada en un registro.
CLI, catálogo, un comando.
Como las skills son archivos de texto, se guardan en git como cualquier código, con historial y revisión.
Permite hacer evolucionar la skill de forma segura y volver atrás si algo se rompe.
Git, historial, revisión.
Al poner la skill en el repositorio del proyecto, queda lista para todo el equipo, con el mismo comportamiento.
Estandariza cómo usa el equipo Claude y difunde buenas prácticas.
Equipo, estandarización, escala organizacional.