Skills son el superpoder secreto de Claude Code. En lugar de escribir los mismos prompts una y otra vez, podés crear "comandos personalizados" que encapsulan tu conocimiento y workflows. Con una sola línea como /refactor-clean, podés activar procesos complejos que normalmente tomarían 10 prompts individuales.
A principios de 2026, Claude Code unificó dos sistemas antes separados—Slash Commands y Skills—en un solo framework cohesivo. Esto significa que hoy es más fácil que nunca extender las capacidades de Claude sin escribir una sola línea de código.
En esta guía vas a aprender qué son exactamente las Skills, cómo crear tu primera en 5 minutos, y patrones probados para automatizar tu workflow diario.
"Skills son archivos de markdown que convierten prompts complejos en comandos simples. El sistema unificado de 2026 permite crear comandos personalizados como /mi-skill que Claude puede invocar manualmente o cargar automáticamente según el contexto. No necesitas saber programar: solo escribís instrucciones en lenguaje natural y Claude hace el resto."
¿Qué Son Exactamente las Skills de Claude Code?
Skills son conjuntos de instrucciones reutilizables que transforman a Claude de un "asistente general" en un "experto especializado" bajo demanda. Cuando invocás una Skill con /nombre-skill, Claude carga temporalmente la personalidad, conocimientos y reglas que definiste para esa tarea específica.
Cuando empecé a usar Claude Code, repetía constantemente el mismo prompt para code reviews: "revisá este código buscando bugs, problemas de seguridad, y sugerencias de optimización". Un día me di cuenta: si estoy escribiendo esto 10 veces por día, debería ser una Skill. Creé /review y ahora solo escribo ese comando. Claude carga automáticamente su "modo reviewer" y aplica consistentemente los mismos criterios que definiría manualmente.
Las Skills viven en dos ubicaciones principales:
Skills globales:
~/.claude/skills/— disponibles en todos tus proyectosSkills de proyecto:
./.claude/skills/— específicas para un proyecto
La diferencia clave con otros sistemas es que Skills son declarativas: no escribís código que se ejecuta, escribís en lenguaje natural qué debería hacer Claude. Claude interpreta tu instrucción y aplica su inteligencia para cumplir tu intención.
"En 2026, Claude Code unificó Slash Commands y Skills en un solo sistema. Ahora tanto .claude/commands/review.md como .claude/skills/review/SKILL.md crean el comando /review y funcionan idénticamente. Esta unificación simplifica el ecosistema mientras mantiene backward compatibility."
¿Por Qué Deberías Usar Skills en 2026?
En septiembre de 2025, Anthropic lanzó el Claude Agent SDK con más de 18 herramientas built-in para desarrollo de agentes autónomos (Anthropic). Skills son la capa que te permite aprovechar este poder sin necesidad de entender la arquitectura subyacente.
El beneficio más inmediato es velocidad. Una tarea que tomaría 45 minutos manualmente—como un code review completo—puede reducirse a 8 minutos con una Skill bien diseñada. Pero la ventaja real va más allá del ahorro de tiempo.
Consistencia: Cuando definís una Skill, establecés un estándar. Todos los code reviews siguen los mismos criterios. Todos los refactorings respetan las mismas convenciones. Esta consistencia es especialmente valiosa en equipos donde diferentes personas tienen diferentes estilos.
Conocimiento compartido: Las Skills pueden compartirse a través de Git. Cuando un miembro del equipo crea una Skill útil—digamos, /review-security—todos los demás pueden beneficiarse. Es knowledge transfer automatizado: el expertise de senior developers se encapsula en comandos que cualquiera puede usar.
Encadenamiento: Podés combinar múltiples Skills con &&. Por ejemplo: /refactor-clean && /test-coverage primero limpia código muerto y luego verifica que los tests todavía pasen. Esto permite crear workflows complejos desde piezas simples.
"Según la documentación oficial de Claude Code, el sistema de Skills sigue el Agent Skills Open Standard (agentskills.io), lo que significa que las Skills que creás hoy pueden funcionar potencialmente en múltiples plataformas de IA en el futuro. Es una inversión en conocimiento portable."
Tu Primera Skill: Creación Paso a Paso
Crear tu primera Skill es sorprendentemente simple. No necesitás saber Python, JavaScript, o ningún lenguaje de programación. Solo necesitás saber escribir en markdown.
Paso 1: Crear la Estructura de Directorios
Primero, decidí si esta Skill será global (para todos tus proyectos) o específica para un proyecto. Para empezar, hagamos una Skill global:
# Crear el directorio para tu skill
mkdir -p ~/.claude/skills/explicar-codigoPaso 2: Escribir el Archivo SKILL.md
Cada Skill necesita un archivo SKILL.md con dos partes: frontmatter YAML (entre ---) y contenido markdown. El frontmatter controla cómo se invoca la Skill; el contenido define qué hace.
---
name: explicar-codigo
description: Explica código usando analogías del mundo real y diagramas visuales
category: development
priority: 5
---
Cuando te pidan explicar código, seguí estos pasos:
1. **Identificá el propósito principal** del código en una frase
2. **Usá analogías del mundo real** para conceptos abstractos
3. **Creá un diagrama de flujo mental** mostrando cómo se conectan las partes
4. **Destacá patrones importantes** o decisiones arquitectónicas
5. **Mencioná posibles mejoras** o problemas que veas
Ejemplo de analogía: "Una función recursiva es como una muñeca rusa que
contiene una versión más pequeña de sí misma hasta llegar al caso base."Paso 3: Probar tu Skill
Ahora cerrá y volvé a abrir Claude Code (o recargá las Skills con el comando correspondiente). Tu nueva Skill está disponible como /explicar-codigo:
/explicar-codigo
¿Qué hace este código?
function fibonacci(n) {
if (n <= 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}Paso 4: Refinar y Mejorar
Tu primera Skill probablemente no será perfecta. Usala y prestá atención a qué funciona bien y qué no. ¿Las analogías ayudan? ¿Falta algo en la explicación? Iterá sobre tu Skill basándote en el uso real.
Anatomía de una Skill: Frontmatter y Contenido
El frontmatter YAML es el cerebro de tu Skill. Cada campo controla un aspecto diferente de cómo se comporta:
name: El nombre que usás para invocar la Skill. Se convierte en /name. Usá guiones para multi-palabra: code-review.
description: Quizás el campo más importante. Claude usa este texto para decidir cuándo cargar automáticamente tu Skill. Si la descripción es "ayuda con código", Claude casi nunca la cargará. Si es "revisa código buscando bugs de seguridad, problemas de concurrencia, y fugas de memoria", Claude la cargará específicamente para esas tareas.
category: Organización interna. Valores comunes: development, testing, documentation, security.
priority: Del 1 al 10. Cuando múltiples Skills podrían cargar, gana la de mayor prioridad. Usá 9-10 para tus Skills críticas, 1-3 para experimentales.
El contenido markdown es donde definís el comportamiento. Acá hay patrones que funcionan bien:
Estructura numerada: Paso 1, Paso 2, Paso 3. Claude respeta el orden.
Ejemplos concretos: "Por ejemplo: 'una función recursiva es como...'"
Verificaciones explicitas: "Antes de sugerir cambios, verificá que..."
Output format: "Presentá el resultado en una tabla con columnas X, Y, Z"
"Las Skills soportan directorios completos con archivos opcionales: scripts/ para ejecutables, references/ para documentación de referencia, y assets/ para templates. Esto permite Skills muy sofisticadas que combinan instrucciones de IA con scripts tradicionales."
Errores Comunes al Crear Skills
Las Skills son simples, pero hay trampas comunes que pueden hacer que tu Skill no funcione bien:
Error 1: Descripciones demasiado vagas. "Ayuda con código" es inútil. Claude nunca sabrá cuándo cargarla. Mejor: "Revisa código React buscando hooks mal usados, problemas de performance en renders, y violaciones de las rules of hooks".
Error 2: No priorizar correctamente. Si tenés Skills similares con la misma prioridad, Claude puede cargar la incorrecta. Usá prioridades altas (8-10) para tus Skills core, bajas (1-3) para experimentales.
Error 3: Skills que hacen demasiado. Una Skill que "revisa, refactoriza, documenta, testea y deploya" es probablemente demasiado compleja. Mejor separar en Skills focales: /review, /refactor, /document, /test. Luego las encadenás según necesites.
"Un error sutil pero común es olvidar que Skills son contextuales. Una Skill diseñada para React puede ser contraproducente en un proyecto de Python. Considerá incluir una verificación en tu Skill: "Este comando es para proyectos React. Si no detectás React, informale al usuario.""
El Futuro de Skills: ¿Qué Viene en 2027?
[DATO ORIGINAL] Basado en la dirección actual del ecosistema y las hojas de ruta públicas, mi proyección es que para 2027 las Skills serán multi-plataforma. El Agent Skills Open Standard (agentskills.io), que Claude Code ya implementa, permitirá que la misma Skill funcione en Claude, ChatGPT, Gemini, y otros agentes compatibles. Tu inversión en crear Skills hoy será portable.
Otro desarrollo interesante es la compartición de Skills. En 2026 ya podés compartir Skills a través de Git. En 2027, es probable que veamos un marketplace oficial donde los desarrolladores puedan publicar, descubrir, y calificar Skills de la comunidad, similar a lo que existe para extensions de VS Code.
También expectamos Skills más sofisticadas que combinen IA con scripts tradicionales. Imaginá una Skill /deploy que: 1) analiza los cambios con IA para determinar el riesgo, 2) corre tests automatizados, 3) construye el proyecto, 4) hace deploy a staging, y 5) monitorea los logs en busca de problemas. La IA dirige; los scripts ejecutan.
FAQs:
¿Skills funciona solo en Claude Code?
No exactamente. Skills de Claude Code siguen el Agent Skills Open Standard (agentskills.io), que es un estándar emergente. Hoy funcionan mejor en Claude Code, pero la idea es que eventualmente sean portables a otros agentes compatibles (Agent Skills Official).
¿Necesito saber programar para crear skills?
No. Las Skills se escriben en markdown con instrucciones en lenguaje natural. Si podés escribir un email claro, podés crear una Skill. Para Skills avanzadas que ejecutan scripts, sí ayuda saber bash o Python, pero no es obligatorio para la mayoría de casos.
¿Puedo compartir mis skills con mi equipo?
Sí, y es una de las features más poderosas. Agregá .claude/skills/ a tu repo Git y todo el equipo tendrá tus Skills automáticamente. Es knowledge transfer automatizado: cuando un senior crea una buena Skill de code review, todos los juniors se benefician.
¿Cuál es la diferencia entre Skills y MCP?
MCP (Model Context Protocol) conecta Claude a herramientas externas—APIs, bases de datos, servicios. Skills le dicen a Claude cómo usar esas herramientas efectivamente. La analogía oficial: si MCP es el puerto USB, Skills son el software que se conecta a ese puerto (Claude Code Docs).
¿Cuántas skills debería tener?
Calidad sobre cantidad. Empezá con 3-5 Skills para tareas que hacés repetidamente. Si una tarea te toma más de 10 prompts o la hacés más de 2 veces por día, es candidata para ser una Skill. Muchos desarrolladores productivos tienen 10-20 Skills bien diseñadas.
Las Skills de Claude Code son una de las features más subestimadas pero poderosas del ecosistema. En minutos, podés convertir prompts repetitivos en comandos reutilizables que te ahorran horas a la semana. Para recordar: Skills son markdown + frontmatter YAML Viven en ~/.claude/skills/ (global) o ./.claude/skills/ (proyecto) Se invocan con /nombre-skill o se cargan automáticamente Pueden encadenarse con && para workflows complejos Se comparten fácilmente a través de Git Tu primera Skill está a 5 minutos de distancia. Abrí tu terminal, creá el directorio, y escribí tu primer SKILL.md. Una vez que experimentás el poder de convertir workflows complejos en comandos simples, no volverás al trabajo manual.