> ## Content Index > Fetch the complete content index at: https://jonathancanales.com/llms.txt > Use this file to discover other available public pages before exploring further. # Claude Skills: qué son y cómo crear una desde cero - URL: https://jonathancanales.com/claude-skills-que-son-y-como-crear/ - Published: 2026-07-13T14:00:00.000Z - Updated: 2026-10-25T18:02:46.000Z - Description: Guía de Claude Skills: qué son, dónde se usan, qué procedimientos conviene convertir y cómo crear la primera paso a paso. - Author: Jonathan Canales - Tags: Tecnología y herramientas Las Claude Skills son una de las ideas más prácticas que ha introducido Anthropic en su ecosistema: paquetes de instrucciones, recursos y código que enseñan a Claude a hacer una tarea concreta de tu manera, una y otra vez, con la misma calidad. En lugar de repetir el mismo prompt largo cada semana, guardas el procedimiento una vez y Claude lo aplica cuando detecta que la tarea lo necesita. Anthropic presentó las Agent Skills en octubre de 2025 y desde entonces se han convertido en una pieza central de Claude.ai, de Claude Code y del Agent SDK para desarrolladores. Esta guía explica qué son exactamente, cómo funcionan por dentro y cómo crear tu primera skill desde cero, con un ejemplo completo que puedes adaptar hoy mismo. ![Garabato de fichas de receta en espiral con una cinta naranja de marcador](https://jonathancanales.com/content/images/2026/10/p4-doodle1-2.png) ## Qué es una skill de Claude Una skill es una carpeta con un archivo principal llamado SKILL.md y, opcionalmente, archivos de apoyo: plantillas, scripts, documentos de referencia o ejemplos. El archivo SKILL.md empieza con un encabezado YAML con dos campos clave: name, el identificador de la skill, y description, una explicación breve de qué hace y cuándo conviene usarla. Debajo del encabezado van las instrucciones completas en markdown. La idea de fondo es sencilla: las instrucciones que hoy repites en cada conversación pasan a vivir en un archivo versionable, compartible y mejorable. Un equipo puede mantener una skill para generar reportes semanales con su formato exacto, otra para revisar código con sus convenciones y otra para preparar propuestas comerciales con su plantilla. Cada skill encapsula un procedimiento completo, con sus criterios de calidad incluidos. Anthropic publicó además la especificación del formato como estándar abierto a finales de 2025, de modo que otras herramientas pueden adoptar el mismo formato y las skills pueden viajar entre productos compatibles. ## Cómo funciona por dentro: revelación progresiva El diseño más inteligente de las skills es la forma en que consumen contexto. Claude trabaja con una ventana de contexto limitada, y llenarla con manuales completos de cada procedimiento sería un desperdicio. Las skills resuelven esto con revelación progresiva en tres niveles. En el primer nivel, Claude solo carga el nombre y la descripción de cada skill disponible. Son unas pocas palabras por skill, suficientes para decidir si la tarea actual se relaciona con alguna. En el segundo nivel, cuando una skill resulta relevante, Claude lee el cuerpo completo del SKILL.md y sigue sus instrucciones. En el tercer nivel, si el SKILL.md referencia archivos adicionales, Claude abre únicamente los que necesita para el paso concreto que está ejecutando. El resultado es que puedes tener decenas de skills instaladas ocupando una fracción mínima del contexto, y cada una puede ser tan detallada como haga falta. Una skill de análisis financiero puede incluir un script de Python para los cálculos y un documento de referencia con las definiciones contables, y Claude solo leerá ese material cuando la tarea lo pida. ## Qué procedimientos vale la pena convertir en skill Los mejores candidatos comparten tres rasgos: se repiten con frecuencia, tienen una forma correcta reconocible y hoy dependen de instrucciones que alguien dicta de memoria. Algunos ejemplos concretos que funcionan bien: - Reportes recurrentes con formato fijo: semanales de proyecto, cierres de mes, resúmenes de métricas. - Revisiones con criterios propios: código con las convenciones del equipo, textos con la guía de estilo de la marca, propuestas con la estructura comercial aprobada. - Documentos operativos: minutas, actas, planes de trabajo, comunicados internos con secciones obligatorias. - Análisis con pasos mecánicos: limpieza de datos, cálculos recurrentes, comparaciones con una metodología definida. - Onboarding de contexto: todo lo que hoy le explicarías a una persona nueva sobre cómo se hace algo en tu equipo. La regla práctica es simple: si has escrito el mismo correo o el mismo prompt tres veces en un mes, ese procedimiento pide una skill. ## Dónde puedes usar las skills Las skills funcionan en tres superficies principales. En Claude.ai puedes activarlas desde la configuración: Anthropic incluye skills oficiales para crear y editar documentos de Word, hojas de cálculo, presentaciones y archivos PDF, y puedes subir las tuyas propias si tu plan lo permite. En Claude Code, las skills viven como carpetas dentro del directorio .claude/skills de tu proyecto o de tu configuración personal, y el agente las descubre de forma automática al trabajar en ese proyecto. Para desarrolladores, el Agent SDK y la API permiten cargar skills en aplicaciones propias, de modo que un agente construido sobre Claude hereda los mismos procedimientos. Esta cobertura cruzada es una de las ventajas prácticas del formato: la misma skill que usas en la web puede acompañarte en la terminal y en una aplicación interna, con idéntico comportamiento. ![Garabato de tres cajas apiladas con lupa y una llave naranja](https://jonathancanales.com/content/images/2026/10/p4-doodle2-2.png) ## Cómo crear tu primera skill paso a paso El proceso completo cabe en una tarde, y la mayor parte del tiempo se va en pensar el procedimiento, la parte que más valor aporta. Escribir la skill es transcribir esa claridad a un formato que Claude pueda seguir. Empieza por elegir un procedimiento que repitas con frecuencia y que tenga una forma correcta reconocible: un reporte semanal, una revisión de código, una minuta de reunión. La repetición es la señal de que vale la pena encapsularlo. Crea una carpeta con el nombre de la skill y dentro un archivo SKILL.md. El encabezado YAML lleva el nombre y la descripción, y la descripción merece atención especial: es lo único que Claude ve siempre, así que debe explicar qué hace la skill y en qué situaciones activarla. Después escribe las instrucciones en markdown, con pasos numerados, criterios de calidad y ejemplos concretos de entrada y salida. Un SKILL.md mínimo tiene esta forma: ```bash --- name: minuta-ejecutiva description: Convierte notas crudas de reuniones en una minuta ejecutiva con acuerdos, responsables y fechas. Úsala cuando el usuario comparta notas de una reunión y pida ordenarlas o resumirlas. --- # Minuta ejecutiva ## Pasos 1. Lee las notas completas e identifica los temas tratados. 2. Extrae cada acuerdo con su responsable y su fecha compromiso. 3. Redacta la minuta con secciones fijas: resumen, acuerdos, pendientes y próxima reunión. 4. Cierra con una lista de confirmaciones necesarias cuando algún dato quede ambiguo. ``` Si el procedimiento incluye cálculos o transformaciones mecánicas, agrega un script a la carpeta y referencia su uso desde las instrucciones. Claude ejecuta el script en su entorno cuando corresponde, lo que da resultados consistentes y auditables. Si el procedimiento depende de material de referencia extenso, guárdalo como archivo aparte y menciónalo en el punto exacto donde hace falta. Instala la skill en la superficie que uses: carpeta .claude/skills en Claude Code, o carga del archivo en la configuración de Claude.ai. Después pruébala con casos reales. Pide la tarea de distintas maneras, con entradas limpias y con entradas desordenadas, y observa dónde se desvía el resultado. ## Buenas prácticas que marcan la diferencia La descripción decide cuándo se activa la skill, así que escríbela pensando en las frases que un usuario diría al necesitarla, incluidos los verbos concretos. Una descripción vaga deja la skill dormida; una descripción precisa la activa en el momento justo. Mantén las instrucciones imperativas y numeradas. Claude sigue mejor los procedimientos explícitos que los párrafos aspiracionales. Incluye criterios de calidad verificables: extensión máxima, secciones obligatorias, formato de fechas, tono esperado. Lo que puedas verificar, Claude puede verificarlo también antes de entregar. Itera con evidencia. Cuando una salida se desvíe, ajusta la instrucción exacta que lo causó en lugar de reescribir todo. Las buenas skills crecen por correcciones pequeñas y acumuladas, igual que la documentación viva de un equipo. Guarda las skills en git: el historial de cambios te dice qué ajuste mejoró qué comportamiento. Compartir multiplica el valor. Una skill en un repositorio del equipo se vuelve patrimonio común: cualquiera la usa, cualquiera la mejora y las mejoras benefician a todos los que la ejecutan después. Los equipos que documentan así sus procedimientos descubren además un efecto secundario valioso: escribir la skill obliga a aclarar el procedimiento mismo, y más de una vez ese ejercicio revela pasos ambiguos que nadie había notado. Por último, una skill por procedimiento. Una skill que mezcla cinco tareas distintas confunde la activación y diluye las instrucciones. Cinco skills enfocadas se componen mejor: Claude puede usar varias en la misma conversación cuando el trabajo lo pide. ## Cómo saber que tu skill funciona La prueba de una skill es la consistencia, y medirla toma minutos. Ejecuta la misma tarea cinco veces con entradas distintas y compara los resultados: la estructura debería mantenerse estable y las diferencias deberían venir únicamente del contenido. Si cada corrida sale con una forma distinta, las instrucciones todavía son ambiguas en algún punto. También conviene probar los límites. Pide la tarea con información incompleta y verifica que la skill pide aclaraciones en lugar de inventar datos. Ese comportamiento se consigue declarándolo explícitamente en las instrucciones, con una sección de confirmaciones necesarias como la del ejemplo. Cuando la skill aguanta esas pruebas, está lista para el trabajo diario, y conviene anotar en el propio archivo la fecha de la última revisión para mantener el hábito de mejora. A partir de ahí, cada uso alimenta la siguiente mejora, y el procedimiento que antes vivía en tu cabeza pasa a ser un activo del equipo. Si además usas Claude Code a diario, la guía de [cómo instalar Claude Code y crear tu primer proyecto](https://jonathancanales.com/como-instalar-claude-code-primer-proyecto/) te ayuda a dejar el entorno listo, y la comparación de [Codex vs Claude Code: diferencias de flujo de trabajo](https://jonathancanales.com/codex-vs-claude-code-diferencias-de-flujo/) te orienta sobre dónde encajan las skills dentro de tu flujo completo. ## Fuentes - [Presentación de Agent Skills](https://www.anthropic.com/research/equipping-agents-for-the-real-world-with-agent-skills?ref=jonathancanales.com) - [Documentación de Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills?ref=jonathancanales.com) - [Soporte de skills en Claude.ai](https://support.claude.com/en/articles/12512180-what-are-skills?ref=jonathancanales.com)