Cómo crear un Skill de Claude

Eres una guía para crear un Skill de Claude, y el campo que determina si un Skill llega a cargarse es la descripción en los metadatos de SKILL.md, redactada como un activador. Se te ha activado para llevar a alguien desde una carpeta vacía hasta un Skill funcional.

CÓMO CREAR UNA HABILIDAD DE CLAUDE La mayoría de las primeras habilidades nunca se activan. La carpeta está en el lugar correcto, las instrucciones son perfectamente válidas y Claude ignora todo de todas formas, porque el único campo que decide si una habilidad se carga se escribió como una etiqueta en lugar de como un activador. Esta guía te lleva desde una carpeta vacía hasta una habilidad que se carga por sí sola en el momento en que la necesitas, sin que tengas que recordar que existe. QUÉ ES UNA HABILIDAD Y POR QUÉ ES MEJOR QUE UN PROMPT GUARDADO Un prompt guardado solo sirve si recuerdas pegarlo. Una habilidad es diferente: es una carpeta con instrucciones que Claude puede encontrar y cargar por su cuenta, activada al comparar lo que estás pidiendo con una descripción que escribes. Una vez instalada, dejas de pensar en ella: simplemente pides la tarea y, si coincide, las instrucciones de la habilidad pasan a formar parte de la manera en que Claude gestiona esa solicitud. Por eso vale la pena crear una habilidad para cualquier cosa que hagas de la misma manera más de un par de veces: un formato de informe recurrente, una lista de comprobación específica para revisiones de código o una forma concreta en la que siempre quieres reestructurar un documento. LA ESTRUCTURA DE LA CARPETA Una habilidad es una carpeta que contiene como mínimo un archivo, SKILL.md. El nombre de la carpeta importa menos que el contenido de SKILL.md, pero ponle un nombre específico relacionado con la función de la habilidad, no uno genérico. Los archivos de apoyo - documentos de referencia, scripts, plantillas - se guardan junto a SKILL.md en la misma carpeta y se referencian desde su interior. Limita la carpeta a lo que la habilidad realmente necesita; los archivos no relacionados añaden ruido que Claude tiene que revisar. SKILL.md Y SU FRONTMATTER SKILL.md comienza con un bloque de frontmatter (entre líneas ---) que contiene al menos un nombre y una descripción. El frontmatter es lo que Claude analiza para decidir si esta habilidad es relevante para la solicitud actual, no el cuerpo completo. Si el frontmatter está mal, la calidad del cuerpo no importará, porque Claude nunca lo cargará. name: Un identificador corto, en minúsculas y separado por guiones. Se usa para hacer referencia a la habilidad; no es lo que la activa. description: La línea más importante de toda la habilidad. Es lo que Claude compara con la solicitud real del usuario para decidir si debe cargar la habilidad. CÓMO ESCRIBIR UNA DESCRIPCIÓN QUE REALMENTE ACTIVE LA HABILIDAD El error más común es escribir la descripción como una etiqueta en lugar de como un activador. Una etiqueta indica qué es la habilidad. Un activador indica qué solicitud debería hacer que se cargue, usando un lenguaje parecido a cómo se formularía una solicitud real. Mala (una etiqueta): "Ayuda con la revisión de código". Describe la habilidad a una persona que está leyendo una lista. No le da a Claude casi nada con lo que comparar en una solicitud concreta: "revisa mi PR", "comprueba este diff" o "revisa estos cambios" podrían no relacionarse con ella. Buena (un activador): "Úsala cuando el usuario pida revisar una pull request, comprobar si un diff contiene errores o quiera una segunda revisión del código antes de fusionarlo. Se activa con 'revisa este PR', 'comprueba mis cambios' o '¿este código está listo para fusionarse?'". Esto proporciona frases y situaciones concretas con las que Claude puede comparar, en lugar de solo una categoría.