Saltar al contenido
Christian Monge

Claude Skills

Claude Skills: qué son y cómo usarlas paso a paso

Claude skills explicadas en español: qué son, cómo cargan solo cuando hacen falta, dónde funcionan y cómo crear tu primera skill para que Claude la use bien.

cmChristian Monge4 min de lectura
Una caja de herramientas de cristal esmerilado con cubos modulares azules, uno flotando hasta encajar

Las Claude skills son carpetas con instrucciones, scripts y archivos de referencia que Claude carga solo cuando una tarea las necesita. Cada una tiene un archivo SKILL.md con un nombre, una descripción de cuándo usarla y los pasos a seguir.

Escribes el proceso una vez y Claude lo aplica cada vez que encaja.

Buena parte de mi negocio funciona con skills. Una audita cada artículo del blog contra 38 reglas y no deja pasar un borrador que rompa alguna. Otra convierte una lista de palabras clave en un brief con los umbrales que debe cumplir quien escribe. En esta guía te explico cómo funcionan y cómo crear una que Claude use de verdad.

Qué son las Claude skills

La documentación oficial lo resume así: las skills convierten un agente de propósito general en un especialista. Sirven para aplicar las guías de marca, seguir el flujo de análisis de tu empresa o automatizar una rutina personal.

Hay cuatro tipos:

  • Skills de Anthropic para crear archivos de Word, Excel, PowerPoint y PDF, que claude.ai usa automáticamente.
  • Skills personalizadas que escribes tú o tu equipo.
  • Skills de organización que los administradores de Team y Enterprise ponen a disposición de todos.
  • Skills de partners de empresas como Notion, Figma o Atlassian.

Además, Agent Skills es un estándar abierto publicado en agentskills.io, así que una skill que escribes no queda atada a Claude.

Cómo funcionan las skills

La idea clave es la divulgación progresiva. Claude no mete todas las skills en memoria; las carga en tres niveles:

NivelQué se cargaCuándoCoste aproximado
1. MetadatosNombre y descripciónSiempre, al iniciarUnos 100 tokens por skill
2. InstruccionesEl cuerpo del SKILL.mdCuando la petición encaja con la descripciónMenos de 5.000 tokens
3. RecursosArchivos y scripts extraSolo si las instrucciones los pidenNada hasta que se usan

Por eso puedes instalar decenas de skills sin que Claude se vuelva lento. Y hay una ventaja menos obvia: cuando una skill ejecuta un script, solo su resultado entra en el contexto, no el código.

Aprende Claude Code Skills en 18 Minutos · Agustín Medina

Dónde puedes usar Claude skills

DóndeSkills propiasCómo se añaden
claude.aiSí, con ejecución de código activadaSubiendo un ZIP en Personalizar, Skills
Claude CodeSíCarpetas en ~/.claude/skills/ o .claude/skills/
API de ClaudeSíSkills API con la herramienta de ejecución de código

Un detalle que la documentación deja claro: las skills no se sincronizan entre superficies. Una skill subida a claude.ai no aparece en la API, y una de Claude Code vive en tu disco. Guárdalas en un repositorio Git y despliégalas donde las necesites.

Si todavía no usas Claude Code, empieza por qué es Claude Code.

Cómo crear tu primera skill paso a paso

Una skill necesita un solo archivo. Este es un ejemplo real y pequeño:

---
name: resumiendo-cambios
description: Resume los cambios sin confirmar como notas de versión para lectores no técnicos. Úsala cuando el usuario pregunte qué cambió, pida notas de versión o prepare un changelog.
---
 
Pasos:
 
1. Ejecuta `git diff --stat` y `git diff` para ver qué cambió.
2. Agrupa los cambios por efecto visible, no por archivo.
3. Escribe una viñeta en lenguaje claro por cada efecto.
4. Termina con una lista de lo que necesita atención.

Guárdala como ~/.claude/skills/resumiendo-cambios/SKILL.md y pregunta en Claude Code "¿qué cambió hoy?". La descripción encaja y la skill se carga.

El frontmatter tiene dos campos obligatorios:

  • name: hasta 64 caracteres, solo minúsculas, números y guiones, y no puede contener "claude" ni "anthropic".
  • description: hasta 1.024 caracteres, y tiene que decir qué hace la skill y cuándo usarla.

En Claude Code puedes añadir campos opcionales. Con disable-model-invocation: true solo tú puedes activarla, que es lo que quieres para cualquier cosa con efectos, como publicar. La documentación de skills de Claude Code explica el resto.

Cómo escribir skills que Claude use de verdad

Casi todas las skills que "no funcionan" tienen una descripción vaga. Claude compara tu petición con esa frase, así que escríbela como un disparador, no como un eslogan. Las buenas prácticas de Anthropic se resumen en pocos hábitos:

  1. Sé conciso. Claude ya sabe mucho; añade solo lo que no sabe: tus convenciones, umbrales y casos límite.
  2. Mantén el SKILL.md por debajo de 500 líneas y mueve el detalle a archivos de referencia enlazados.
  3. Usa scripts para lo que deba ser exacto. Las instrucciones guían; el código obliga.
  4. Empieza por las pruebas. Escribe tres casos en los que Claude falla hoy y luego las instrucciones justas para pasarlos.
  5. Evita datos que caducan, como precios o fechas, dentro de la skill.

El tercer hábito es el que más uso. Mi skill de auditoría no le pide a Claude que juzgue si un título es largo: ejecuta un script que cuenta caracteres y devuelve un error. Esa es la diferencia entre una skill que sugiere y una que bloquea.

Dónde encontrar buenas skills

  • El repositorio de Anthropic. anthropics/skills tiene ejemplos para trabajo creativo, técnico y empresarial. En Claude Code se añade con /plugin marketplace add anthropics/skills.
  • Colecciones de la comunidad. Hay conjuntos para marketing, diseño e ingeniería; reviso los mejores de marketing en Claude skills para marketing, en inglés.
  • Tu propio trabajo. La mejor skill suele ser el proceso que le explicas dos veces al mes a alguien nuevo.

Una nota de seguridad: una skill puede ejecutar código y llamar herramientas, así que instalarla es como instalar software. Lee todos los archivos antes.

Siguiente paso

Elige un proceso que repitas cada semana y conviértelo en tu primera skill hoy. Si quieres profundizar, la guía completa en inglés incluye más detalles técnicos. Y si prefieres aprenderlo en vivo sobre tu propio trabajo, las skills ocupan la segunda semana de mi curso de Claude Code en español. Para equipos, lo llevo a medida en la formación en IA para empresas.

Preguntas frecuentes

¿Qué son las Claude skills?

Son carpetas con instrucciones, scripts y recursos que Claude carga cuando una tarea lo requiere. Cada skill tiene un archivo SKILL.md con un nombre y una descripción que le dicen a Claude cuándo usarla, más los pasos a seguir.

¿Las Claude skills son gratis?

Las skills están disponibles en los planes Free, Pro, Max, Team y Enterprise de claude.ai con la ejecución de código activada. En Claude Code funcionan con cualquier plan que incluya Claude Code, y en la API mediante la herramienta de ejecución de código.

¿Dónde se guardan las skills en Claude Code?

Las personales van en ~/.claude/skills/nombre-skill/SKILL.md y las del proyecto en .claude/skills/nombre-skill/SKILL.md. El nombre de la carpeta se convierte en el comando, así que .claude/skills/publicar-post se ejecuta con /publicar-post.

¿Qué diferencia hay entre una skill y un prompt?

Un prompt vale para una conversación y lo repites cada vez. Una skill se guarda una vez, se carga sola cuando la petición encaja con su descripción y puede incluir scripts y archivos de referencia.

Fuentes

  1. 01Agent Skills overview (documentación de Claude Platform)
  2. 02Extend Claude with skills (documentación de Claude Code)
  3. 03Skill authoring best practices (documentación de Claude Platform)
  4. 04Use skills in Claude (Claude Help Center)
  5. 05Repositorio anthropics/skills (GitHub)
cm

Christian Monge

Construye segundos cerebros de IA con Obsidian y Claude Code, cofundó el SaaS de inteligencia competitiva Pengu Insights y forma equipos en español e inglés desde Madrid.

Más sobre mí

Curso Claude Code

Apréndelo en vivo, sobre tu propio trabajo.

Cuatro semanas, grupo pequeño, repositorios reales. Terminas con skills, subagentes y flujos MCP que de verdad usas.

Unirme a la lista del curso

Sigue leyendo