Las habilidades se han convertido en uno de los puntos de extensión más utilizados en Claude Code. Son flexibles, fáciles de crear y simples de distribuir.
Pero esta flexibilidad también hace que sea difícil saber qué funciona mejor. ¿Qué tipo de habilidades vale la pena crear? ¿Cuál es el secreto para escribir una buena habilidad? ¿Cuándo compartirlas con otros?
Hemos estado usando habilidades en Claude Code de forma intensiva en Anthropic, con cientos de ellas en uso activo. Estas son las lecciones que hemos aprendido sobre el uso de habilidades para acelerar nuestro desarrollo.
¿Qué son las Habilidades?
Si eres nuevo en las habilidades, te recomiendo leer nuestra documentación o ver nuestro curso más reciente en el nuevo Skilljar sobre Habilidades de Agente. Este artículo asumirá que ya tienes cierta familiaridad con las habilidades.
Un error común que escuchamos sobre las habilidades es que son "solo archivos markdown", pero la parte más interesante de las habilidades es que no son solo archivos de texto. Son carpetas que pueden incluir scripts, recursos, datos, etc., que el agente puede descubrir, explorar y manipular.
En Claude Code, las habilidades también tienen una amplia variedad de opciones de configuración que incluyen el registro de hooks dinámicos.
Hemos descubierto que algunas de las habilidades más interesantes en Claude Code utilizan estas opciones de configuración y la estructura de carpetas de forma creativa.
Tipos de Habilidades
Después de catalogar todas nuestras habilidades, notamos que se agrupan en algunas categorías recurrentes. Las mejores habilidades encajan claramente en una; las más confusas abarcan varias. Esta no es una lista definitiva, pero es una buena forma de pensar si te falta alguna dentro de tu organización.
1. Referencia de Librerías y API
Habilidades que explican cómo usar correctamente una librería, CLI o SDK. Pueden ser tanto para librerías internas como para librerías comunes con las que Claude Code a veces tiene problemas. Estas habilidades suelen incluir una carpeta con fragmentos de código de referencia y una lista de errores comunes que Claude debe evitar al escribir un script.
Ejemplos:
- billing-lib — tu librería de facturación interna: casos límite, errores comunes, trampas, etc.
- internal-platform-cli — cada subcomando de tu envoltorio CLI interno con ejemplos de cuándo usarlos
- frontend-design — mejora el rendimiento de Claude con tu sistema de diseño
2. Verificación de Producto
Habilidades que describen cómo probar o verificar que tu código funciona. A menudo se combinan con una herramienta externa como playwright, tmux, etc. para realizar la verificación.
Las habilidades de verificación son extremadamente útiles para asegurar que el resultado de Claude sea correcto. Puede valer la pena que un ingeniero dedique una semana solo a mejorar tus habilidades de verificación.
Considera técnicas como que Claude grabe un video de su resultado para que puedas ver exactamente lo que probó, o imponer aserciones programáticas sobre el estado en cada paso. Esto a menudo se hace incluyendo una variedad de scripts en la habilidad.
Ejemplos:
- signup-flow-driver — recorre el flujo de registro → verificación de correo → incorporación en un navegador headless, con hooks para verificar el estado en cada paso
- checkout-verifier — maneja la interfaz de pago con tarjetas de prueba de Stripe, verifica que la factura realmente llegue al estado correcto
- tmux-cli-driver — para pruebas interactivas de CLI donde lo que estás verificando necesita un TTY
3. Obtención y Análisis de Datos
Habilidades que se conectan a tus stacks de datos y monitoreo. Estas habilidades pueden incluir librerías para obtener tus datos con credenciales, IDs de dashboard específicos, etc., así como instrucciones sobre flujos de trabajo comunes o formas de obtener datos.
Ejemplos:
- funnel-query — "qué eventos debo unir para ver registro → activación → pago" más la tabla que realmente tiene el user_id canónico
- cohort-compare — compara la retención o conversión de dos cohortes, marca diferencias estadísticamente significativas, enlaza a las definiciones de segmento
- grafana — UIDs de fuentes de datos, nombres de clúster, tabla de búsqueda de problema → dashboard
4. Procesos de Negocio y Automatización de Equipos
Habilidades que automatizan flujos de trabajo repetitivos en un solo comando. Estas habilidades suelen ser instrucciones bastante simples, pero pueden tener dependencias más complejas en otras habilidades o MCPs. Para estas habilidades, guardar resultados anteriores en archivos de registro puede ayudar al modelo a mantenerse coherente y reflexionar sobre ejecuciones anteriores del flujo de trabajo.
Ejemplos:
- standup-post — agrega tu rastreador de tickets, actividad de GitHub y Slack anterior → informe de estado formateado, solo cambios
- create-<sistema-de-tickets>-ticket — aplica esquema (valores de enumeración válidos, campos obligatorios) más flujo posterior a la creación (notificar revisor, enlazar en Slack)
- weekly-recap — PRs fusionados + tickets cerrados + despliegues → resumen semanal formateado
5. Andamiaje de Código y Plantillas
Habilidades que generan el boilerplate de un framework para una función específica en la base de código. Puedes combinar estas habilidades con scripts que se pueden componer. Son especialmente útiles cuando tu andamiaje tiene requisitos de lenguaje natural que no pueden cubrirse puramente con código.
Ejemplos:
- new-<framework>-workflow — crea un nuevo servicio/flujo de trabajo/manejador con tus anotaciones
- new-migration — tu plantilla de archivo de migración más errores comunes
- create-app — nueva aplicación interna con tu configuración de autenticación, registro y despliegue preconfigurada
6. Calidad y Revisión de Código
Habilidades que aplican la calidad del código dentro de tu organización y ayudan a revisar el código. Estas pueden incluir scripts o herramientas deterministas para máxima robustez. Es posible que quieras ejecutar estas habilidades automáticamente como parte de hooks o dentro de una GitHub Action.
- adversarial-review — genera un subagente con ojos nuevos para criticar, implementa correcciones, itera hasta que los hallazgos se reduzcan a detalles menores
- code-style — aplica el estilo de código, especialmente aquellos estilos que Claude no maneja bien por defecto.
- testing-practices — instrucciones sobre cómo escribir pruebas y qué probar.
7. CI/CD y Despliegue
Habilidades que te ayudan a obtener, enviar y desplegar código dentro de tu base de código. Estas habilidades pueden hacer referencia a otras habilidades para recopilar datos.
Ejemplos:
- babysit-pr — monitorea un PR → reintenta CI inestable → resuelve conflictos de fusión → habilita auto-merge
- deploy-<servicio> — compilación → prueba de humo → despliegue gradual del tráfico con comparación de tasa de error → reversión automática en caso de regresión
- cherry-pick-prod — árbol de trabajo aislado → cherry-pick → resolución de conflictos → PR con plantilla
8. Runbooks
Habilidades que toman un síntoma (como un hilo de Slack, una alerta o una firma de error), recorren una investigación con múltiples herramientas y producen un informe estructurado.
Ejemplos:
- <service>-debugging — mapea síntomas → herramientas → patrones de consulta para tus servicios de mayor tráfico
- oncall-runner — obtiene la alerta → verifica los sospechosos habituales → formatea un hallazgo
- log-correlator — dado un ID de solicitud, extrae registros coincidentes de cada sistema que pueda haberlo tocado
9. Operaciones de Infraestructura
Habilidades que realizan tareas de mantenimiento rutinario y procedimientos operativos, algunos de los cuales implican acciones destructivas que se benefician de salvaguardas. Estas facilitan que los ingenieros sigan las mejores prácticas en operaciones críticas.
Ejemplos:
- <resource>-orphans — encuentra pods/volúmenes huérfanos → publica en Slack → período de espera → el usuario confirma → limpieza en cascada en cascada
- dependency-management — tu flujo de aprobación de dependencias de la organización
- cost-investigation — "por qué aumentó nuestra factura de almacenamiento/transferencia" con los buckets y patrones de consulta específicos
Consejos para Crear Habilidades
Una vez que has decidido qué habilidad crear, ¿cómo se escribe? Estos son algunos de los mejores prácticas, consejos y trucos que hemos encontrado.
También lanzamos recientemente Skill Creator para facilitar la creación de habilidades en Claude Code.
No Digas lo Obvio
Claude Code sabe mucho sobre tu base de código, y Claude sabe mucho sobre programación, incluyendo muchas opiniones predeterminadas. Si estás publicando una habilidad que se basa principalmente en conocimiento, concéntrate en información que saque a Claude de su forma de pensar habitual.
La habilidad de diseño frontend es un gran ejemplo: fue creada por uno de los ingenieros de Anthropic iterando con clientes para mejorar el gusto de diseño de Claude, evitando patrones clásicos como la fuente Inter y los degradados púrpura.
Crea una Sección de Errores Comunes
El contenido de mayor valor en cualquier habilidad es la sección de Errores Comunes. Estas secciones deben construirse a partir de los puntos de fallo comunes que Claude encuentra al usar tu habilidad. Idealmente, actualizarás tu habilidad con el tiempo para capturar estos errores.
Usa el Sistema de Archivos y la Divulgación Progresiva
Como dijimos antes, una habilidad es una carpeta, no solo un archivo markdown. Debes pensar en todo el sistema de archivos como una forma de ingeniería de contexto y divulgación progresiva. Dile a Claude qué archivos hay en tu habilidad, y los leerá en los momentos adecuados.
La forma más simple de divulgación progresiva es señalar otros archivos markdown para que Claude los use. Por ejemplo, puedes dividir firmas de funciones detalladas y ejemplos de uso en referencias/api.md.
Otro ejemplo: si tu resultado final es un archivo markdown, puedes incluir un archivo de plantilla en assets/ para copiar y usar.
Puedes tener carpetas de referencias, scripts, ejemplos, etc., que ayudan a Claude a trabajar de manera más efectiva.
Evita Encarrilar a Claude
Claude generalmente intentará seguir tus instrucciones, y como las habilidades son tan reutilizables, debes tener cuidado de no ser demasiado específico en tus instrucciones. Dale a Claude la información que necesita, pero dale la flexibilidad para adaptarse a la situación. Por ejemplo:
Piensa en la Configuración Inicial
Algunas habilidades pueden necesitar configurarse con contexto del usuario. Por ejemplo, si estás creando una habilidad que publica tu informe de estado en Slack, es posible que quieras que Claude pregunte en qué canal de Slack publicarlo.
Un buen patrón para hacer esto es almacenar esta información de configuración en un archivo config.json en el directorio de la habilidad, como en el ejemplo anterior. Si la configuración no está lista, el agente puede preguntar al usuario por la información.
Si quieres que el agente presente preguntas estructuradas de opción múltiple, puedes indicarle a Claude que use la herramienta AskUserQuestion.
El Campo de Descripción es para el Modelo
Cuando Claude Code inicia una sesión, crea un listado de cada habilidad disponible con su descripción. Este listado es lo que Claude escanea para decidir "¿hay una habilidad para esta solicitud?" Esto significa que el campo de descripción no es un resumen, sino una descripción de cuándo activar esta habilidad.
Memoria y Almacenamiento de Datos
Algunas habilidades pueden incluir una forma de memoria almacenando datos dentro de ellas. Puedes almacenar datos en algo tan simple como un archivo de registro de texto solo de anexado o archivos JSON, o algo tan complejo como una base de datos SQLite.
Por ejemplo, una habilidad standup-post podría mantener un archivo standups.log con cada publicación que ha escrito, lo que significa que la próxima vez que la ejecutes, Claude lee su propio historial y puede decir qué ha cambiado desde ayer.
Los datos almacenados en el directorio de la habilidad pueden eliminarse cuando actualices la habilidad, por lo que debes almacenarlos en una carpeta estable. Hoy en día, proporcionamos ${**CLAUDE_PLUGIN_DATA**} como una carpeta estable por plugin para almacenar datos.
Almacena Scripts y Genera Código
Una de las herramientas más poderosas que puedes darle a Claude es código. Darle a Claude scripts y librerías le permite a Claude dedicar sus turnos a la composición, decidiendo qué hacer a continuación en lugar de reconstruir boilerplate.
Por ejemplo, en tu habilidad de ciencia de datos podrías tener una librería de funciones para obtener datos de tu fuente de eventos. Para que Claude pueda hacer análisis complejos, podrías darle un conjunto de funciones auxiliares como las siguientes:
Claude puede entonces generar scripts sobre la marcha para componer esta funcionalidad y realizar análisis más avanzados para indicaciones como "¿Qué pasó el martes?"
Hooks Bajo Demanda
Las habilidades pueden incluir hooks que solo se activan cuando se llama a la habilidad y duran toda la sesión. Úsalos para hooks más opinados que no quieres ejecutar todo el tiempo, pero que son extremadamente útiles en ocasiones.
Por ejemplo:
- /careful — bloquea rm -rf, DROP TABLE, force-push, kubectl delete mediante el matcher PreToolUse en Bash. Solo quieres esto cuando sabes que estás tocando producción; tenerlo siempre activo te volvería loco
- /freeze — bloquea cualquier Edición/Escritura que no esté en un directorio específico. Útil al depurar: "Quiero agregar registros pero sigo 'arreglando' sin querer cosas no relacionadas"
Distribución de Habilidades
Uno de los mayores beneficios de las habilidades es que puedes compartirlas con el resto de tu equipo.
Hay dos formas en las que puedes compartir habilidades con otros:
- incluir tus habilidades en tu repositorio (bajo ./.claude/skills)
- crear un plugin y tener un mercado de plugins de Claude Code donde los usuarios puedan subir e instalar plugins (lee más en la documentación
Para equipos más pequeños que trabajan en relativamente pocos repositorios, incluir las habilidades en los repositorios funciona bien. Pero cada habilidad que se incluye también añade un poco al contexto del modelo. A medida que escalas, un mercado interno de plugins te permite distribuir habilidades y dejar que tu equipo decida cuáles instalar.
Gestionar un Mercado
¿Cómo decides qué habilidades van en un mercado? ¿Cómo las envían las personas?
No tenemos un equipo centralizado que decida; en su lugar, intentamos encontrar las habilidades más útiles de forma orgánica. Si tienes una habilidad que quieres que la gente pruebe, puedes subirla a una carpeta sandbox en GitHub y señalarla a la gente en Slack u otros foros.
Una vez que una habilidad ha ganado tracción (lo cual depende del propietario de la habilidad decidir), pueden enviar un PR para moverla al mercado.
Una advertencia: puede ser bastante fácil crear habilidades malas o redundantes, por lo que es importante asegurarse de tener algún método de curación antes del lanzamiento.
Componer Habilidades
Es posible que quieras tener habilidades que dependan unas de otras. Por ejemplo, puedes tener una habilidad de carga de archivos que suba un archivo, y una habilidad de generación de CSV que haga un CSV y lo suba. Este tipo de gestión de dependencias aún no está integrada de forma nativa en los mercados o las habilidades, pero puedes simplemente referenciar otras habilidades por su nombre, y el modelo las invocará si están instaladas.
Medir Habilidades
Para entender cómo está funcionando una habilidad, usamos un hook PreToolUse que nos permite registrar el uso de habilidades dentro de la empresa (código de ejemplo aquí). Esto significa que podemos encontrar habilidades que son populares o que están teniendo menos activación de lo esperado.
Conclusión
Las habilidades son herramientas increíblemente potentes y flexibles para los agentes, pero aún es temprano y todos estamos descubriendo cómo usarlas mejor.
Considera esto más como una bolsa de trucos útiles que hemos visto funcionar que como una guía definitiva. La mejor manera de entender las habilidades es empezar, experimentar y ver qué funciona para ti. La mayoría de las nuestras comenzaron como unas pocas líneas y un solo error común, y mejoraron porque la gente siguió añadiendo a medida que Claude encontraba nuevos casos límite.
Espero que esto haya sido útil, házmelo saber si tienes alguna pregunta.
