Para crear una skill de Claude, escribe una carpeta con un solo archivo: un SKILL.md que comience con un nombre y una descripción, seguido de instrucciones en lenguaje sencillo. Comprime la carpeta, súbela a Claude (o colócala en ~/.claude/skills/ para Claude Code) y Claude la cargará cuando una solicitud coincida con la descripción. Sin código, sin SDK y sin paso de compilación.
En esta página
- Lo que necesitas antes de empezar
- Paso 1: Elige un trabajo y define cuándo está «terminado»
- Paso 2: Crea la carpeta y el archivo SKILL.md
- Paso 3: Escribe los metadatos iniciales (la parte que decide cuándo se activa)
- Paso 4: Escribe las instrucciones como un método, no como un estado de ánimo
- Paso 5: Añade un ejemplo de salida terminada
- Paso 6: Empaqueta e instálalo
- Paso 7: Pruébalo en serio
- Plantilla gratuita de Skill de Claude (copia y adapta)
- Cinco errores que vuelven inútil un Skill
- Deja que Claude redacte el primer borrador por ti
- ¿Crear la tuya o empezar con una prediseñada?
Ese es todo el mecanismo. Lo que distingue una skill que se activa siempre y produce trabajo que puedes entregar de otra que nunca se activa depende de unas seis decisiones, y esta guía las explica en orden. Al final encontrarás una plantilla gratuita que puedes copiar y una lista de comprobación para probar tu skill antes de confiar en ella.
Si el concepto en sí es nuevo para ti, empieza por ¿Qué son las Skills de Claude? y vuelve después. Esta página da por hecho que sabes qué es una skill y quieres crear una.
Lo que necesitas antes de empezar
- Una cuenta de Claude con la ejecución de código activada. Las skills funcionan con los planes Free, Pro, Max, Team y Enterprise, pero la configuración para ejecutar código y crear archivos debe estar habilitada. En Team y Enterprise, puede que un administrador tenga que activar primero las skills para la organización.
- Un editor de texto. Cualquier herramienta que guarde texto sin formato: VS Code, TextEdit en modo de texto sin formato o Notepad.
- Una tarea repetible. No «marketing». Algo como «convertir la transcripción de una llamada de ventas en una nota de CRM con nuestro formato» o «revisar un contrato en busca de nuestras cinco señales de alerta habituales». Cuanto más específico sea el trabajo, mejor será la skill.
- Dos o tres ejemplos reales de buenos resultados. Informes, correos electrónicos o resúmenes que hayas usado y que te alegraría enviar. Son la mejor materia prima para una skill.
Paso 1: Elige un trabajo y define cuándo está «terminado»
La mayoría de las skills fallan aquí, antes de escribir una sola línea. Una skill que intenta abarcar «todo lo que hace un responsable de marketing» termina con una descripción vaga, se activa en los momentos equivocados y da respuestas genéricas cuando se activa.
Escribe dos frases antes de cualquier otra cosa:
- El activador: «Úsala cuando alguien pida X o entregue Y».
- El resultado: «El resultado es una Z con estas secciones, con esta extensión y en este tono».
Ejemplo: «Úsala cuando alguien pegue la transcripción de una llamada con un cliente y pida notas. El resultado es una nota de CRM con las secciones Resumen, Puntos débiles, Presupuesto, Próximo paso y Riesgo, de menos de 200 palabras y escrita para un responsable de ventas que no estuvo en la llamada». Si no puedes escribir esas dos frases, divide el trabajo en dos skills.
Paso 2: Crea la carpeta y el archivo SKILL.md
Una skill es una carpeta cuyo nombre coincide con el nombre de la skill. Dentro, el único archivo obligatorio es SKILL.md (el nombre del archivo distingue entre mayúsculas y minúsculas). Los extras opcionales van junto a él:
| Ruta | ¿Obligatorio? | Para qué sirve |
|---|---|---|
call-notes/SKILL.md |
Sí | Los metadatos iniciales más las instrucciones que sigue Claude |
call-notes/resources/example-output.md |
Recomendado | Un ejemplo terminado del entregable |
call-notes/resources/style-guide.md |
Opcional | Material de referencia más extenso que Claude solo lee cuando es necesario |
call-notes/scripts/ |
Opcional | Scripts de Python o shell para pasos que deben ser exactos, como analizar un CSV |
Mantén el nombre de la carpeta en minúsculas y con guiones, como call-notes o quarterly-report. La misma cadena aparece en nombre campo en el paso siguiente.
Paso 3: Escribe los metadatos iniciales (la parte que decide cuándo se activa)
El archivo comienza con un breve bloque YAML entre dos líneas de tres guiones. Hay dos campos obligatorios:
-
name: letras minúsculas, números y guiones, hasta 64 caracteres. Se convierte en el identificador y, en Claude Code, en el comando de barra (/call-notes). -
description: hasta 1.024 caracteres. Es la única parte que Claude lee al inicio de una sesión para cada habilidad instalada. Decide si la habilidad se carga.
Escribe la descripción como si estuvieras informando a un colega que debe decidir en un segundo si una solicitud le corresponde. Empieza por lo que produce la habilidad y después enumera las situaciones y frases que deberían activarla. Compara:
- Débil: «Ayuda con las notas de ventas».
- Sólido: «Convierte la transcripción de una llamada de ventas o de descubrimiento en una nota estructurada de CRM (Resumen, Puntos de dolor, Presupuesto, Siguiente paso, Riesgo) de menos de 200 palabras. Úsalo cuando el usuario pegue la transcripción de una llamada, el texto de una grabación de reunión o notas de llamada sin editar y pida notas, un resumen, una entrada de CRM o un resumen de seguimiento».
La versión sólida nombra la entrada, la salida y las palabras que las personas realmente escriben. Eso hace que se active de forma fiable y permanezca inactiva el resto del tiempo.
Paso 4: Escribe las instrucciones como un método, no como un estado de ánimo
Todo lo que aparece debajo de los metadatos iniciales es Markdown que Claude sigue una vez que se carga la habilidad. El error más común es escribir una personalidad extensa («Eres un experto en ventas de talla mundial con 20 años...») sin ningún procedimiento. Claude no necesita una historia de fondo. Necesita pasos, reglas y un formato de destino. Una estructura que funciona para la mayoría de las habilidades empresariales:
- Entradas: lo que proporcionará el usuario y qué pedir si falta (máximo dos preguntas; después, continúa con las suposiciones indicadas).
- Flujo de trabajo: pasos numerados en el orden en que los realizaría un profesional meticuloso.
- Formato de salida: las secciones, los encabezados, la extensión y el tono exactos.
- Reglas: lo que siempre debe ocurrir o lo que nunca debe ocurrir («nunca inventes una cifra de presupuesto; escribe “no se ha hablado de ello”»).
- Control de calidad: una lista breve que Claude revisa antes de responder.
Procura que quepa en una o dos pantallas. Si el archivo supera aproximadamente las 500 líneas, traslada el material de referencia (guías de estilo extensas, listas de precios, textos de políticas) a archivos dentro de resources/ e indica a Claude en SKILL.md cuándo debe abrirlos. Claude carga esos archivos adicionales solo cuando la tarea los necesita, lo que mantiene ligero el contexto. Para obtener más información sobre la estructura del archivo, consulta ¿Qué es un archivo SKILL.md?
Paso 5: Añade un ejemplo de salida terminada
Un ejemplo enseña el formato más rápido que cualquier cantidad de descripción. Coloca un entregable realista y terminado en resources/example-output.md y haz referencia a él en el flujo de trabajo («coincide con la estructura y la extensión de resources/example-output.md»). Usa un trabajo real anterior con nombres y cifras modificados, no un marcador de posición lleno de corchetes. Nuestro propio catálogo sigue la misma regla: cada Skill incluye un ejemplo de salida, porque es la señal más clara de que alguien realmente lo probó.
Paso 6: Empaqueta e instálalo
En Claude (web y escritorio): comprime la carpeta para que la propia carpeta quede en la raíz del archivo zip (call-notes.zip que contenga call-notes/SKILL.md). Abre la sección de Skills en la configuración, carga el archivo zip y activa el Skill. Inicia un chat nuevo y haz una solicitud que coincida con la descripción.
En Claude Code: no necesitas ningún archivo zip. Coloca la carpeta en ~/.claude/skills/ para usarla en todos los proyectos, o en .claude/skills/ dentro de un repositorio para compartirla con todas las personas que trabajen en él. Escribe /call-notes o simplemente describe la tarea. Claude Code detecta los cambios en la carpeta sin reiniciar.
La guía completa para cada superficie, incluido dónde se encuentran los archivos y qué hacer cuando se rechaza una carga, está en Cómo instalar un Skill de Claude. Los desarrolladores que trabajan principalmente en la terminal también deberían leer Skills de Claude Code.
Paso 7: Pruébalo en serio
Un Skill que solo se ha probado una vez no se ha probado realmente. Haz esta comprobación antes de compartirlo con un equipo:
- Prueba de activación (5 prompts). Escribe cinco solicitudes que deberían activar el Skill, formuladas de distintas maneras. Cuenta cuántas lo activan. Menos de cuatro significa que la descripción necesita más expresiones reales del usuario.
- Prueba de silencio (5 prompts). Escribe cinco solicitudes similares que no deberían activarlo. Si se activa con alguna, acota la descripción.
- Prueba de información faltante. Dale la mitad de los datos. Debería hacer una pregunta breve o declarar sus suposiciones, no inventar datos.
- Prueba de formato. Compara tres salidas una al lado de la otra con tu ejemplo. ¿Tienen las mismas secciones, el mismo rango de longitud y el mismo tono?
- Prueba de casos extremos. Introduce el dato real más desordenado que tengas: una transcripción divagante o una hoja de cálculo medio vacía.
Corrige la descripción para resolver problemas de activación y el flujo de trabajo o las reglas para resolver problemas de salida. Mantén un registro de cambios breve al final del archivo para saber qué versión usa tu equipo.
Plantilla gratuita de Skill de Claude (copia y adapta)
Sustituye las partes en mayúsculas, elimina lo que no necesites y guárdalo como SKILL.md dentro de una carpeta con el mismo nombre que el nombre campo.
---
name: tu-nombre-de-skill
description: Produce UN ENTREGABLE ESPECÍFICO (secciones, longitud) a partir de UNA ENTRADA ESPECÍFICA. Úsalo cuando el usuario SOLICITE X, PEGUE Y o mencione Z. No lo uses para UNA TAREA CERCANA QUE CORRESPONDA A OTRO LUGAR.
---
# TÍTULO DE TU SKILL
## Propósito
Una o dos frases: para quién es esto y cómo se ve el resultado final.
## Datos de entrada
- Obligatorio: QUÉ DEBE PROPORCIONAR EL USUARIO
- Opcional: QUÉ MEJORA EL RESULTADO
- Si falta un dato obligatorio, formula como máximo dos preguntas breves,
después continúa y enumera tus suposiciones al principio de la salida.
## Flujo de trabajo
1. Lee la información de entrada e identifica los ELEMENTOS CLAVE.
2. Compruébala con las REGLAS O CRITERIOS.
3. Redacta la salida con el formato siguiente.
4. Ejecuta la comprobación de calidad, corrige todo lo que falle y luego responde.
## Formato de salida
- Sección 1: NOMBRE - QUÉ VA AQUÍ (longitud)
- Sección 2: NOMBRE - QUÉ VA AQUÍ (longitud)
- Sección 3: NOMBRE - QUÉ VA AQUÍ (longitud)
Iguala la estructura y la longitud de resources/example-output.md.
## Reglas
- No inventes cifras, nombres ni fechas. Escribe «no proporcionado» en su lugar.
- Usa un inglés sencillo. No incluyas introducciones de relleno.
- REGLA ESPECÍFICA DE TU EQUIPO O SECTOR.
## Comprobación de calidad
- ¿Están presentes todas las secciones y en el orden correcto?
- ¿Se puede rastrear cada afirmación hasta la información de entrada?
- ¿Está dentro del límite de longitud?
## Registro de cambios
- v1.0 PRIMERA VERSIÓN, FECHA
¿Quieres ver cómo son los Skill terminados? Ejemplos de Skill de Claude recorre línea por línea doce archivos SKILL.md reales; es la forma más rápida de calibrar cuántos detalles son suficientes.
Cinco errores que vuelven inútil un Skill
- Una descripción que diga qué es el Skill, no cuándo usarlo. «Un redactor experto» nunca se activa. «Escribe textos para páginas de producto a partir de una lista de características cuando el usuario solicita una descripción de producto, texto para una PDP o texto para una ficha» sí lo hace.
- Un solo Skill para todo un departamento. Presupuestos, nóminas y auditoría en un mismo archivo te dan tres respuestas a medias. Crea tres Skill.
- Sin formato de salida. Sin uno, cada ejecución parece diferente y nadie confía en ella.
- Secretos en el archivo. Nunca pegues claves de API, contraseñas ni datos de clientes en una Skill. Cualquiera con quien la compartas podrá leerla.
- Instalar la Skill de otra persona sin leerla. Una Skill son instrucciones que Claude seguirá, a veces con scripts. Léela como leerías un script antes de ejecutarlo.
Deja que Claude redacte el primer borrador por ti
No tienes que empezar desde un archivo en blanco. Claude puede entrevistarte sobre la tarea, redactar el frontmatter y el flujo de trabajo, generar un ejemplo de resultado y proponer los prompts de prueba anteriores. Anthropic incluye una Skill integrada llamada skill-creator precisamente para esto, y también puedes pedirlo con palabras sencillas: "Entrevístame sobre cómo escribo nuestro informe semanal para clientes y luego redacta un SKILL.md para ello." Tendrás que editar el borrador, especialmente la descripción y las reglas, pero elimina la mayor parte de la escritura.
¿Prefieres un formulario a un chat? El Claude Skill Builder gratuito convierte una breve descripción de la tarea en un SKILL.md listo para usar, con frontmatter y un flujo de trabajo, que puedes copiar o descargar como .zip para Claude.ai y Claude Code. No es necesario registrarse.
¿Quieres que hagamos por ti la entrevista, la autoevaluación y el empaquetado? Claude Skill Creator ($19) es una Skill que crea Skills: pregunta sobre el trabajo, las solicitudes que la gente escribe realmente y lo que nunca debe ocurrir, redacta una carpeta completa con el SKILL.md y un ejemplo de resultado, prueba la descripción con solicitudes que deberían activarla y otras que no, y empaqueta la carpeta para Claude, Claude Code y la API. Para auditar una Skill que hayas escrito o descargado, usa Claude Skill Reviewer & Security Linter, u obtén ambas, además de Skills de revisión de prompts, MCP y código, en el Build Your Own Claude Skills Kit ($49).
¿Crear la tuya o empezar con una prediseñada?
Crea la tuya cuando el flujo de trabajo sea único para tu equipo, cuando codifique conocimientos internos que nadie ajeno tenga o cuando disfrutes iterando. Empieza con una Skill prediseñada cuando el trabajo corresponda a una función estándar (contabilidad, informes de SEO, revisión de contratos, respuestas de soporte) y prefieras dedicar la tarde al trabajo en lugar de a las instrucciones. Una Skill de Claude prediseñada de nuestra biblioteca de Skills de Claude cuesta $19, incluye un ejemplo de resultado y es un archivo Markdown sencillo que puedes abrir y editar, por lo que también sirve como plantilla inicial para tu propia versión.
De cualquier manera, el siguiente paso es el mismo: elige una tarea que repitas cada semana, escribe las dos frases del Paso 1 y ten una Skill funcional antes de que termine el día.