¿Qué son las skills?

¿Qué son las skills?

Puntos clave

• Las skills son carpetas de instrucciones que Claude Code puede descubrir y usar para manejar tareas con mayor precisión. Cada skill vive en un archivo SKILL.md con un nombre y una descripción en su frontmatter
• Claude usa la descripción para hacer coincidir las skills con las solicitudes. Cuando le pides a Claude que haga algo, compara tu solicitud con las descripciones de las skills disponibles y activa las que coinciden
• Las skills personales van en ~/.claude/skills y te acompañan en todos los proyectos. Las skills de proyecto van en .claude/skills dentro de un repositorio y se comparten con cualquiera que lo clone
• Las skills se cargan a demanda — a diferencia de CLAUDE.md (que se carga en cada conversación) o los comandos slash (que requieren invocación explícita), las skills se activan automáticamente cuando Claude reconoce la situación
• Si te encuentras explicándole lo mismo a Claude repetidamente, eso es una skill esperando a ser escrita

Cada vez que le explicas a Claude los estándares de codificación de tu equipo, te estás repitiendo. En cada revisión de PR, vuelves a describir cómo quieres que se estructure la retroalimentación. En cada mensaje de commit, le recuerdas a Claude tu formato preferido. Las skills solucionan esto.

Una skill es un archivo markdown que le enseña a Claude cómo hacer algo una vez. Claude luego aplica ese conocimiento automáticamente cada vez que es relevante.

Qué son las skills

Las skills son carpetas de instrucciones y recursos que Claude Code puede descubrir y usar para manejar tareas con mayor precisión. Cada skill vive en un archivo SKILL.md con un nombre y una descripción en su frontmatter.



La descripción es cómo Claude decide si usar la skill. Cuando le pides a Claude que revise un PR, compara tu solicitud con las descripciones de las skills disponibles y encuentra la relevante. Claude lee tu solicitud, la compara con todas las descripciones de skills disponibles, y activa las que coinciden.

Así es como se ve el frontmatter de una skill:

---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

Debajo del frontmatter, escribes las instrucciones reales — tu lista de verificación de revisión, preferencias de formato, o lo que Claude necesite saber para esa tarea.

Dónde viven las skills

Puedes almacenar las skills en diferentes lugares dependiendo de quién las necesite:

• Las skills personales van en ~/.claude/skills (tu directorio home). Estas te acompañan en todos tus proyectos — tu estilo de mensajes de commit, tu formato de documentación, cómo te gusta que se explique el código.
• Las skills de proyecto van en .claude/skills dentro del directorio raíz de tu repositorio. Cualquiera que clone el repositorio obtiene estas skills automáticamente. Aquí es donde viven los estándares del equipo, como las guías de marca de tu empresa, las fuentes preferidas y los colores para el diseño web.

En Windows, las skills personales viven en C:/Users/<your-user>/.claude/skills.

Las skills de proyecto se incluyen en el control de versiones junto con tu código, por lo que todo el equipo las comparte.

Skills vs. CLAUDE.md vs. comandos slash

Claude Code tiene varias formas de personalizar el comportamiento. Las skills son únicas porque son automáticas y específicas para cada tarea. Así es como se comparan:

• Los archivos CLAUDE.md se cargan en cada conversación. Si quieres que Claude siempre use el modo estricto de TypeScript, eso va en CLAUDE.md.
• Las skills se cargan a demanda cuando coinciden con tu solicitud. Claude solo carga el nombre y la descripción inicialmente, así que no llenan toda tu ventana de contexto. Tu lista de verificación de revisión de PR no necesita estar en el contexto cuando estás depurando — se carga cuando realmente pides una revisión.
• Los comandos slash requieren que los escribas explícitamente. Las skills no. Claude las aplica cuando reconoce la situación.

Cuando Claude hace coincidir una skill con tu solicitud, verás que se carga en la terminal:



Cuándo usar las skills

Las skills funcionan mejor para conocimiento especializado que se aplica a tareas específicas:

• Estándares de revisión de código que sigue tu equipo
• Formatos de mensajes de commit que prefieres
• Guías de marca para tu organización
• Plantillas de documentación para tipos específicos de documentos
• Listas de verificación de depuración para frameworks particulares

La regla general es simple: si te encuentras explicándole lo mismo a Claude repetidamente, eso es una skill esperando a ser escrita.

Reflexión de la lección

• Piensa en tus interacciones más recientes con Claude Code. ¿Qué instrucciones te encontraste repitiendo? ¿Cómo podría una skill haberte ahorrado tiempo?
• Considera el flujo de trabajo de tu equipo. ¿Qué estándares o procesos se beneficiarían más de codificarse como skills?

Qué sigue

En la próxima lección, crearás tu primera skill desde cero y aprenderás cómo Claude Code descubre, hace coincidir y carga las skills detrás de escena.