Mapa de la ruta
Contenido detallado
🧩 Qué es una Skill
Desde el primer principio: una carpeta, un archivo SKILL.md y conocimiento empaquetado que enseña a Claude a hacer algo específico.
Una Skill es una carpeta cuyo nombre es el nombre 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+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 reúne un procedimiento completo —pasos, reglas, ejemplos— que Claude sigue de forma consistente 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 tener que 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 skill para tu día a día.
Flujos repetibles, dominios variados, este curso nació de una skill.
Crear la skill más sencilla 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.
Baja barrera de entrada; empieza con texto y evoluciona después.
📝 Anatomía del SKILL.md
Todo SKILL.md comienza con dos líneas: name y description. Claude lee la description 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 está cargada en la memoria de Claude. Si te equivocas aquí, la skill falla.
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 a 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.
Description débil = la skill nunca se activa. Es el elemento de mayor impacto en SKILL.md.
Disparador, «úsalo cuando…», especificidad.
Una buena description enumera frases de activación concretas ("ú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 variantes.
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 referencias.
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 siempre están en la memoria; el resto se carga solo cuando hace falta.
La ventana de contexto de Claude es finita. Cargar decenas de skills completas de una vez la llenaría.
Entender 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 ligeros y baratos.
Explica por qué la description debe ser tan buena: es la única señal que siempre está presente.
Siempre activo, índice de skills, liviano.
Cuando la tarea coincide con la description, Claude abre el contenido completo del SKILL.md.
Es el momento en que entran en juego las instrucciones detalladas: bajo demanda.
Cuando coincida, carga bajo demanda.
Los archivos de referencia y los scripts solo se leen cuando SKILL.md los señala y la etapa lo requiere.
Permite empaquetar mucho material pesado sin costo hasta el momento de usarlo.
Bajo demanda, referencias, scripts ejecutables.
Puedes tener decenas de skills instaladas y el contexto sigue siendo ligero, porque el índice es lo único que siempre está 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 «ganen» el match correcto.
Coincidencia, relevancia, prioridad.
📂 Dónde viven y cómo instalar
Las skills se encuentran en .claude/skills — en el proyecto (solo allí) o de forma global (en cualquier lugar). Instalar es copiar la carpeta o ejecutar un comando.
Una carpeta .claude/skills/ dentro del repositorio hace que la skill esté disponible solo en ese proyecto.
Ideal para skills específicas de un producto, versionadas junto con el código.
Alcance de proyecto, versionado, específico.
La carpeta global en tu home (~/.claude/skills/) pone la skill a disposición en cualquier proyecto.
Perfecto para skills personales que usas todo el tiempo, como la de videos.
Alcance global, reutilizable, personal.
Como es solo una carpeta, instalarla puede consistir literalmente en copiar/pegar en el lugar correcto (o descomprimir un zip).
Es como recibiste la skill de este curso: un zip con la carpeta dentro.
Copiar la 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 incluyen 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.
Incluir la skill en el repositorio del proyecto deja la entrega lista para todo el equipo, con el mismo comportamiento.
Estandariza cómo usa Claude el equipo y difunde buenas prácticas.
Equipo, estandarización, escala organizacional.