Cómo crear tus propias habilidades para Claude Code: tutorial completo
Las habilidades son la característica más poderosa de Claude Code y también la menos explorada. Si bien la mayoría de los usuarios se ciñen a indicaciones individuales, aquellos que dominan las habilidades transforman Claude Code en un asistente personalizado que conoce sus patrones, sigue sus reglas y ofrece resultados consistentes.
En este tutorial, aprenderá cómo crear una habilidad desde cero. No es necesario saber programar. Las habilidades están escritas en Markdown, con instrucciones en lenguaje natural. Si sabes explicar una tarea por escrito, sabes cómo crear una habilidad.
Al final, tendrás una habilidad funcional instalada y lista para usar. Construyamos una habilidad juntosrevisión de código automatizadacomo ejemplo práctico.
1. ¿Qué son las habilidades en Claude Code?
Una habilidad es un conjunto de instrucciones persistentes que Claude Code sigue cuando la invocas. A diferencia de un mensaje que escribes y descartas, una habilidad se guarda en tu proyecto y se puede reutilizar infinitas veces.
En la práctica, funciona así:
- Creas un archivo Markdown con instrucciones detalladas.
- Guardar en el directorio correcto (
.claude/commands/) - Convocatorias con
/nome-da-skillen Claude Code - Claude sigue las instrucciones de habilidad con precisión.
Analogía:Si Claude Code es chef, aparecerá un mensaje diciendo "prepara algo delicioso". Una habilidad es una receta detallada con ingredientes, cantidades, tiempo de preparación y presentación. El resultado es consistente cada vez.
Las habilidades resuelven tres problemas fundamentales con indicaciones separadas:
- Inconsecuencia:Los mensajes generan resultados diferentes en cada ejecución. Las competencias estandarizan el formato y la calidad
- Olvidado:no es necesario recordar todos los detalles del mensaje cada vez. Todo está documentado en la habilidad.
- Reutilizabilidad:escribe una vez, úsalo para siempre. Comparte con tu equipo o entre proyectos
2. Estructura de carpetas y archivos
La estructura de una habilidad en Claude Code es simple:
Cada archivo.mdadentro.claude/commands/se convierte automáticamente en un comando de barra diagonal disponible en Claude Code. El nombre del archivo (sin la extensión) es el nombre del comando.
| Archivo | Dominio |
|---|---|
code-review.md | /code-review |
deploy-checklist.md | /deploy-checklist |
seo-audit.md | /seo-audit |
Para habilidades más complejas con evaluaciones y referencias, la estructura se puede ampliar:
3. Anatomía de una habilidad: el archivo .md
El archivo Markdown de una habilidad tiene una estructura simple pero poderosa. Analicemos cada parte:
Elementos clave de una buena habilidad
- Contexto:define el "rol" que Claude debe asumir. Esto influye drásticamente en la calidad del resultado.
- Instrucciones:paso a paso de que hacer. Cuanto más específico, mejor
- Formato de salida:define exactamente cómo se debe presentar el resultado. Garantiza la coherencia entre ejecuciones.
- Restricciones:límites y reglas negativas (qué NO hacer). Evita que Claude divague o genere ruido.
4. Ejemplo paso a paso: creación de una habilidad de revisión de código
Creemos la habilidad completa, desde cero hasta la primera ejecución.
Paso 1: crea la estructura de carpetas
Paso 2: crea el archivo de habilidades
Paso 3: escribe las instrucciones
Abre el archivo.claude/commands/review.mdy escribe:
Paso 4: prueba la habilidad
[Claude Code lee la habilidad y realiza la revisión...]
**src/api/users.js** línea 42
- Gravedad: CRÍTICA
- Problema: la entrada del usuario se utiliza directamente en la consulta SQL sin desinfección
- Solución sugerida: use parámetros preparados en lugar de concatenación de cadenas
**src/utils/cache.js** línea 18
- Gravedad: ALERTA
- Problema: la caché sin TTL puede crecer indefinidamente y provocar pérdida de memoria
- Solución sugerida: agregue maxAge o límite de entradas en el Mapa
Resumen: 4 números (1 crítica, 2 alertas, 1 información)
Nota: APROBADO CON DISPOSICIONES
Acción: corrija la inyección de SQL en usuarios.js antes de fusionar
Listo. Tu habilidad está funcionando. Cada vez que escribes/review, Claude Code seguirá estas instrucciones exactamente.
¿Quieres dominar esto más rápido?
Todo lo que estás aprendiendo aquí se vuelve 10 veces más poderoso con habilidades ya preparadas. En lugar de escribir comandos manualmente, las habilidades hacen el trabajo pesado por usted. Más de 748 habilidades profesionales, se instala en 2 minutos.
Quiero las Habilidades — R$ 195. Carpeta de evaluaciones: prueba tu habilidad
la carpetaevals/le permite probar su habilidad sistemáticamente. Cada evaluación es un escenario de prueba que verifica si la habilidad produce el resultado esperado.
ejemplo de evaluación
Las evaluaciones hacen dos cosas: validar que la habilidad funcione como se esperaba y documentar el comportamiento deseado para cuando necesite actualizar las instrucciones.
6. Carpeta de referencias: contexto adicional
la carpetareferences/almacena documentos que la habilidad puede consultar durante la ejecución. Esto permite que las habilidades accedan al contexto especializado sin saturar el archivo principal.
En la habilidad, hace referencia a estos archivos:
Claude Code lee los archivos referenciados y los utiliza como contexto adicional. Esto es especialmente útil para reglas específicas de su empresa o proyecto que no caben en el archivo de habilidades.
7. Dónde guardar: proyecto vs global
Hay dos lugares para guardar habilidades:
| Ubicación | Camino | Alcance | cuando usar |
|---|---|---|---|
| Proyecto | .claude/commands/ |
Sólo disponible en este proyecto. | Habilidades específicas del proyecto (revisión, implementación, etc.) |
| Global | ~/.claude/commands/ |
Disponible en todos los proyectos. | Habilidades genéricas que utilizas en cualquier proyecto. |
Recomendación
- Habilidades de proyecto:revisión de código (cada proyecto tiene estándares diferentes), lista de verificación de implementación, pruebas específicas
- Habilidades globales:Generador README, creación de .gitignore, análisis de dependencia, formato de mensaje de confirmación
Si una habilidad del proyecto funciona tan bien que desea usarla en todo, cópiela en el directorio global. Simple.
8. Buenas prácticas para las competencias profesionales
Después de crear decenas de habilidades, estos son los patrones que diferencian las habilidades amateur de las profesionales:
1. Sea específico en contexto
Malo: "Eres un desarrollador". Bien: "Usted es un desarrollador senior de Node.js con experiencia en API REST, está familiarizado con Express, Prisma y PostgreSQL. Prioriza la seguridad sobre la conveniencia".
2. Establezca el formato de salida explícitamente
No dejes que Claude decida cómo formatear. Si desea una tabla, especifique las columnas. Si desea viñetas, especifique el patrón. La coherencia del formato es esencial para las habilidades que utilizará repetidamente.
3. Incluir restricciones (qué NO hacer)
Las habilidades sin restricciones tienden a producir resultados detallados y ruidosos. Agregue reglas negativas: "No explicar conceptos básicos", "No sugerir cambios estéticos", "Limitar a 10 elementos en el resultado".
4. Utilice ejemplos de entrada/salida
Si es posible, incluya un ejemplo de cómo debería verse el resultado en la habilidad. Esto reduce drásticamente la ambigüedad:
5. Iterar y perfeccionar
Tu primera versión no será perfecta. Utilice la habilidad de 5 a 10 veces, observe dónde el resultado difiere de lo esperado y ajuste las instrucciones. Las mejores habilidades pasan por varias iteraciones.
6. Documentar los parámetros opcionales
Las habilidades pueden aceptar argumentos. Documente esto al principio del archivo:
Asesoramiento profesional:Comience con habilidades simples (5 a 10 líneas de instrucción) y agregue complejidad según sea necesario. Una habilidad simple que funciona es infinitamente mejor que una habilidad compleja que nadie usa.
Siguiente paso: instale skills y vea la diferencia
Ya sabes lo básico. Ahora imagina a Claude Code sabiendo cómo hacer todo esto por sí mismo: SEO, redacción, revisión de código, implementación, análisis de datos. Eso es lo que hacen las habilidades. Acceso de por vida, actualizaciones incluidas.
Ver el Mega Paquete – R$ 19Preguntas frecuentes
Las habilidades de Claude Code están en la carpeta..claude/commands/dentro del directorio del proyecto (para habilidades del proyecto) o en~/.claude/commands/(para habilidades globales, disponibles en cualquier proyecto). Cada habilidad es un archivo Markdown (.md) que contiene las instrucciones que Claude Code debe seguir cuando se invoca la habilidad.
No. Las habilidades están escritas en Markdown con instrucciones en lenguaje natural. Describe lo que debe hacer Claude Code, qué formato de salida usar, qué restricciones seguir. Y cómo redactar un informe detallado para un asistente. Si sabes explicar una tarea por escrito, sabes cómo crear una habilidad.
Crear habilidades desde cero requiere tiempo para investigar buenas prácticas, probarlas, perfeccionarlas e iterarlas. Un paquete ya preparado como el demishabilidades.ioofrece más de 748 habilidades profesionales o más de 748 habilidades en 7 categorías ya probadas y optimizadas por profesionales. Puede utilizar el paquete como base y personalizar las habilidades para su contexto específico. Es la diferencia entre construir una PC desde cero y comprar una preensamblada que puedes actualizar.