¿Qué son los Claude Skills?
Instrucciones reutilizables, enséñale a Claude tu flujo de trabajo
⏱ Estim. ~7 min
01 · Leer
Llevas un tiempo usando Claude Code para crear proyectos. Pero cada vez que abres una conversación nueva, tienes que volver a explicar tus preferencias: estilo de código, formato de mensajes de commit, forma de probar, convenciones del proyecto.
¿Y si Claude pudiera recordar tus reglas de flujo de trabajo de forma permanente?
Eso es Claude Skills. Un Skill es un archivo de instrucciones reutilizable que le dice a Claude exactamente cómo quieres que trabaje. Escribes las reglas una vez, y Claude las sigue en cada conversación, automáticamente.
Se acabó repetir. Se acabaron las salidas inconsistentes. Es Claude trabajando justo como tú quieres.
💡 Imagínalo asíPiensa en un skill como entrenar a un colega nuevo. En lugar de explicar las convenciones del equipo cada mañana, las escribes en el manual del equipo. Un Skill es el manual de Claude: permanente, reutilizable, actualizable en cualquier momento.
Puntos clave
- Cada conversación nueva de Claude Code empieza de cero — no recuerda preferencias previas
- Un Skill es un archivo de instrucciones reutilizable que Claude carga automáticamente
- Una vez escrito, el skill aplica en cada conversación de ese proyecto
- Los Skills convierten tus reglas no escritas en instrucciones permanentes y compartibles
02 · Leer
Un Claude Skill es simplemente una carpeta con un archivo SKILL.md dentro. Eso es todo.
El SKILL.md contiene instrucciones en lenguaje natural, con metadatos YAML opcionales arriba. También puedes incluir archivos de referencia — como una guía de estilo o el schema de una base de datos — para darle a Claude más contexto.
Los skills viven en carpetas específicas donde Claude los busca: - Los skills de proyecto van en .claude/skills/ — solo se cargan en ese proyecto - Los skills de usuario van en ~/.claude/skills/ — se cargan en cada proyecto de tu máquina
Cuando un skill se activa, Claude lee sus instrucciones y las sigue, como si las hubieras escrito tú mismo en la conversación.
Puntos clave
- Skill = una carpeta que contiene un archivo SKILL.md
- SKILL.md tiene dos partes: frontmatter YAML (metadatos) + cuerpo markdown (instrucciones)
- Opcional: archivos de referencia en la misma carpeta dan contexto extra
- Skills de proyecto: .claude/skills/ — Skills de usuario: ~/.claude/skills/
03 · Ejemplo de código
Así se ve un skill mínimo en disco: solo una carpeta y un archivo.
Estructura de carpetas
.claude/skills/my-skill/
└── SKILL.md
Contenido de SKILL.md
---
name: My First Skill
description: A simple example skill
---
When working on this project, always use TypeScript strict mode.
Prefer functional components over class components.
Use camelCase for variables and PascalCase for components.
Las líneas --- delimitan el frontmatter YAML — los metadatos del skill. Todo lo que está debajo del --- final es el cuerpo de las instrucciones — las reglas en lenguaje natural que Claude sigue cuando este skill está activo.
04 · Quiz
Piensa en lo que pasa al inicio de cada conversación nueva de Claude Code. ¿Cuál es el problema principal que resuelven los Claude Skills?
- Tienes que repetir tus preferencias en cada conversación nueva
- Claude Code corre demasiado lento
- Claude Code no puede leer archivos sin un skill
- Claude Code no soporta TypeScript
05 · Completar
El archivo principal en cada carpeta de skill se llama _____.md
06 · Leer
Claude Code busca skills en ubicaciones específicas. Cuando escribes /skill en una conversación, Claude lista todos los skills disponibles para que los actives.
Pero los skills también se pueden cargar automáticamente según dónde estén guardados: - Los skills de proyecto van en .claude/skills/ dentro del repo — ideal para convenciones de equipo que todos los desarrolladores del proyecto deben seguir - Los skills de usuario van en ~/.claude/skills/ en tu directorio personal — ideal para preferencias personales que te acompañan en todos los proyectos
Los skills de proyecto sirven para cosas como "nuestra API usa URLs en kebab-case" o "usamos Conventional Commits". Los skills de usuario sirven para cosas como "explícame las cosas" o "siempre sugiere tests".
Puntos clave
- El comando /skill lista y activa los skills disponibles
- Los skills de proyecto (.claude/skills/) se comparten con el equipo vía git
- Los skills de usuario (~/.claude/skills/) son personales y aplican a todos los proyectos
- Skill de proyecto = convención del equipo; skill de usuario = preferencia personal
07 · Quiz
Tu equipo tiene la regla de que todas las rutas de API usen URLs en kebab-case. Quieres que cada desarrollador la siga automáticamente al usar Claude Code. ¿Dónde debe ir este skill?
- ~/.claude/skills/ para que aplique a todos tus proyectos
- .claude/skills/ dentro del repo del proyecto
- Un archivo de texto en el escritorio
- Un comentario en el código fuente
08 · Completar
Para guardar skills que apliquen a todos los proyectos de tu máquina (preferencias personales), van en ~/._____/skills/
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.