Las Skills se han convertido en uno de los puntos de extensión más utilizados en Claude Code. Son flexibles, fáciles de crear y sencillas de distribuir.
Pero esta flexibilidad también dificulta saber qué funciona mejor. ¿Qué tipo de Skills vale la pena crear? ¿Cuál es el secreto para escribir una buena Skill? ¿Cuándo compartirlas con otros?
Hemos estado usando Skills en Claude Code de forma extensiva en Anthropic, con cientos de ellas en uso activo. Estas son las lecciones que hemos aprendido sobre el uso de Skills para acelerar nuestro desarrollo.
¿Qué son las Skills?
Si eres nuevo en Skills, te recomiendo leer nuestra documentación o ver nuestro curso más reciente sobre Agent Skills en Skilljar; esta publicación asumirá que ya tienes cierta familiaridad con las Skills.
Un concepto erróneo común que escuchamos sobre las Skills es que son "solo archivos Markdown", pero la parte más interesante es que no es que no son solo archivos de texto. Son carpetas que pueden incluir scripts, activos, datos, etc., que el agente puede descubrir, explorar y manipular.
En Claude Code, las Skills también tienen una amplia variedad de opciones de configuración, incluyendo el registro de hooks dinámicos.
Hemos descubierto que algunas de las Skills más interesantes en Claude Code utilizan estas opciones de configuración y la estructura de carpetas de manera creativa.
Tipos de Skills
Después de catalogar todas nuestras Skills, notamos que se agrupan en algunas categorías recurrentes. Las mejores Skills 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
Skills 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 dificultades. Estas Skills suelen incluir una carpeta con fragmentos de código de referencia y una lista de gotchas para que Claude evite al escribir un script.
Ejemplos:
- billing-lib — tu librería de facturación interna: casos límite, footguns, etc.
- internal-platform-cli — todos los subcomandos de tu envoltorio CLI interno con ejemplos de cuándo usarlos
- frontend-design — hacer que Claude sea mejor en tu sistema de diseño
2. Verificación de Producto
Skills que describen cómo probar o verificar que tu código funciona. Suelen combinarse con una herramienta externa como Playwright, tmux, etc. para realizar la verificación.
Las Skills de verificación son extremadamente útiles para asegurarse de que la salida de Claude sea correcta. Puede valer la pena que un ingeniero dedique una semana a perfeccionar tus Skills de verificación.
Considera técnicas como que Claude grabe un video de su salida para que puedas ver exactamente lo que probó, o imponer comprobaciones programáticas sobre el estado en cada paso. Esto se logra a menudo incluyendo varios scripts en la Skill.
Ejemplos:
- signup-flow-driver — recorre registro → verificación de correo → incorporación en un navegador headless, con hooks para comprobar el estado en cada paso
- checkout-verifier — maneja la interfaz de pago con tarjetas de prueba de Stripe, verifica que la factura realmente caiga en el estado correcto
- tmux-cli-driver — para pruebas interactivas de CLI donde lo que se necesita un TTY
3. Obtención y Análisis de Datos
Skills que se conectan a tus stacks de datos y monitoreo. Pueden incluir librerías para obtener tus datos con credenciales, identificadores de paneles 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" y la tabla que realmente tiene el user_id canónico
- cohort-compare — comparar la retención o conversión de dos cohortes, marcar diferencias estadísticamente significativas, enlazar a las definiciones de segmento
- grafana — UIDs de origen de datos, nombres de clúster, tabla problema → panel de control
4. Procesos de Negocio y Automatización de Equipo
Skills que automatizan flujos de trabajo repetitivos en un solo comando. Estas Skills suelen ser instrucciones bastante simples, pero pueden tener dependencias más complejas en otras Skills o MCPs. Para estas Skills, guardar resultados anteriores en archivos de registro puede ayudar al modelo a mantenerse consistente y reflexionar sobre ejecuciones previas del flujo.
Ejemplos:
- standup-post — agrega tu gestos de tickets, actividad de GitHub y Slack previo → actualización formateada, solo diferencias
- create-<sistema-tickets>-ticket — impone esquema (valores de enumeración válidos, campos requeridos) más flujo posterior a la creación (notificar revisor, enlazar en Slack)
- weekly-recap — PRs fusionado PRs + tickets cerrados y flujos de datos → publicación de resumen formateada
5. Plantillas Generales de Código
Skills que generan el boilerplate de framework para una función específica en la base de código. Puedes combinar estas Skills con scripts que se puedan componer. Son especialmente útiles cuando tu generación de andamios tiene requisitos de lenguaje natural que no pueden cubrirse solo con código.
Ejemplos:
- new-<framework>-workflow — crea la estructura de un nuevo servicio/flujo de trabajo/manejador con tus anotaciones
- new-migration — plantilla de archivo de migración más gotchas comunes
- create-app — nueva aplicación interna con autenticación, registro y configuración de despliegue preconfigurada
6. Calidad de Código y Revisión
Skills que aplican calidad de código dentro de tu organización y ayudan a revisar el código. Pueden incluir scripts deterministas o herramientas para máxima robustez. Puedes querer ejecutar estas Skills automáticamente como parte de hooks o dentro de una GitHub Action.
- adversarial-review — inicia un subagente con ojos frescos para criticar, implementa correcciones e itera hasta que las conclusiones se reduzcan a minucias
- code-style — aplica el estilo de código, especialmente estilos que Claude no maneja bien por defecto
- testing-practices — instrucciones sobre cómo escribir pruebas y qué probar
7. CI/CD y Despliegue
Skills que ayudan a obtener, enviar y desplegar código dentro de tu base de código. Pueden referenciar otras Skills para recolectar 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 con comparación de tasa de error → reversión automática ante regresión
- cherry-pick-prod — worktree aislado → cherry-pick → resolución de conflictos → PR con plantilla
8. Runbooks
Skills que toman un síntoma (como un hilo de Slack, una alerta o una firma de error), recorren una investigación multiherramienta y producen un informe estructurado.
Ejemplos:
- <servicio>-debugging — mapea síntomas → herramientas → patrones de consulta para tus servicios de alto 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 podría haberla tocado
9. Operaciones de Infraestructura
Skills que realizan mantenimiento rutinario y procedimientos operativos, algunos de los cuales implican acciones destructivas que se benefician de barreras de protección. Facilitan que los ingenieros sigan las mejores prácticas en operaciones críticas.
Ejemplos:
- <r curso>-orphans — encuentra pods/volúmenes huérfanos → publica en Slack → período de espera → usuario confirma → limpieza en cascada
- dependency-management — flujo de trabajo de aprobación de dependencias de tu organización
- cost-investigation — "por qué se disparó nuestra factura de almacenamiento/egreso" y los buckets y patrones de consulta específicos
Consejos para Crear Skills
Una vez que has decidido qué Skill crear, ¿cómo la escribes? Estos son algunos de las mejores prácticas, consejos y trucos que hemos encontrado.
También lanzamos recientemente Skill Creator para facilitar la creación de Skills en Claude Code.
No Digamos lo obvio
Claude Code sabe mucho sobre tu base de código, y Claude sabe mucho sobre programación, incluidas muchas opiniones por defecto. Si estás publicando una Skill que es principalmente sobre conocimiento, intenta centrarte en información que saque a Claude de su forma normal de pensar.
La Skill de diseño frontend es un gran ejemplo: fue construida 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 gradientes púrpura.
Crea una Sección de Gotchas
El contenido de mayor señal en cualquier Skill es la sección de Gotchas. Estas secciones deben basarse en puntos de fallo comunes que Claude encuentra al usar tu Skill. Idealmente, actualizarás tu Skill con el tiempo para capturar estos gotchas.
Usa el Sistema de Archivos y la Divulgación Progresiva
Como dijimos antes, una Skill 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 Skill, y los leerá en los momentos adecuados.
La forma más simple de divulgación progresiva es apuntar a otros archivos Markdown para que Claude los use. Por ejemplo, puedes dividir firmas de funciones detalladas y ejemplos de uso en references/api.md.
Otro ejemplo: si tu salida final es un archivo Markdown, puedes incluir un archivo de plantilla para él en assets/ para copiar y usar.
Puedes tener carpetas de referencias, scripts, ejemplos, etc., que ayuden a Claude a trabajar de manera más efectiva.
Evita encarrilar a Claude
Claude generalmente intentará seguir tus instrucciones, y dado que las Skills 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
Algunas Skills pueden necesitar configurarse con contexto del usuario. Por ejemplo, si estás haciendo una Skill que publica tu actualización en Slack, podrías querer que Claude pregunte en qué canal de Slack publicarla.
Un buen patrón para esto es almacenar esta información de configuración en un archivo config.json en el directorio de la Skill, como el ejemplo anterior. Si la configuración no está establecida, el agente puede luego pedirle al usuario la información.
Si quieres que el agente presente preguntas estructuradas de opción múltiple, puedes instruir a Claude para que use la herramienta AskUserQuestion.
El Campo de Descripción es para el Modelo
Cuando Claude Code inicia una sesión, construye un listado de cada Skill disponible con su descripción. Este listado es lo que Claude escanea para decidir "¿hay una Skill para esta solicitud?" Lo que significa que el campo de descripción no es un resumen: es una descripción de cuándo activar esta Skill.
Memoria y Almacenamiento de Datos
Algunas Skills pueden incluir una forma de memoria almacenando datos dentro de ellas. Podrías almacenar datos en cualquier cosa, desde un archivo de registro de texto de solo añadir archivos JSON, hasta tan complejo como una base de datos SQLite.
Por ejemplo, una Skill de 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 leerá su propio historial y podrá decir qué ha cambiado desde ayer.
Los datos almacenados en el directorio de la Skill pueden eliminarse cuando actualices la Skill, por lo que debes almacenarlos en una carpeta estable; actualmente proporcionamos ${**CLAUDE_PLUGIN_DATA**} como carpeta estable por Skill para almacenar datos.
Almacenamiento de Scripts y Generación de Código
Una de las herramientas más poderosas que puedes darle a Claude es código. Darle scripts y librerías permite que Claude gaste sus turnos en composición, decidiendo qué hacer a continuación en lugar de reconstruir boilerplate.
Por ejemplo, en tu Skill 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:
Claude luego puede generar scripts sobre la marcha para componer esta funcionalidad y realizar análisis más avances para indicaciones como "¿Qué pasó el martes?"
Hooks bajo Demanda
Las Skills pueden incluir hooks que solo se activan cuando se llama a la Skill y duran lo que dure la sesión. Usa esto para hooks más opinados que no quieras ejecutar todo el tiempo, pero que son extremadamente útiles a veces.
Por ejemplo:
- /careful — bloquea rm -rf, DROP TABLE, force-push, kubectl delete a través de un 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 logs pero sigo 'arreglando' accidentalmente cosas no relacionadas."
Distribución de Skills
Uno de los mayores beneficios de las Skills es que puedes compartirlas con el resto de tu equipo.
Hay dos formas en las que podrías compartir Skills con otros:
- incluir tus Skills en tu repositorio (bajo ./.claude/skills)
- crear un plugin y tener un mercado de Plugins Claude Code donde los usuarios puedan cargar e instalar plugins (lee más en la documentación
Para equipos pequeños que trabajan en relativamente pocos repositorios, incluir las Skills en los repos funciona bien. Pero cada Skill que se incluye también agrega un poco al contexto del modelo. A medida que escalas, un mercado de plugins interno te permite distribuir Skills y que tu equipo decida cuáles instalar.
Gestión de un Mercado
¿Cómo decides qué Skills van en un mercado? ¿Cómo las presenta la gente?
No tenemos un equipo centralizado que decida; en cambio, intentamos encontrar las Skills más útiles orgánicamente. Si tienes una Skill que quieres que la gente pruebe, puedes subirla a una carpeta sandbox en GitHub y señalarla en Slack u otros foros.
Una vez que una Skill ha ganado tracción (lo cual depende del dueño de la Skill decidir), pueden hacer un PR para moverla al mercado.
Una nota de advertencia: puede ser bastante fácil crear Skills malas o redundantes, por lo que es importante tener algún método de curaduría antes del lanzamiento.
Composición de Skills
Puede que quieras tener Skills que dependan unas de otras. Por ejemplo, podrías tener una Skill de carga de archivos que suba un archivo, y una Skill de generación de CSV que haga un CSV y lo suba. Este tipo de gestión de dependencias aún no está integrado nativamente en los mercados o Skills, pero puedes simplemente simplemente hacer referencia a otras Skills por su nombre, y el modelo las invocará si están instaladas.
Medición de Skills
Para entender cómo le está yendo a una Skill, usamos un hook PreToolUse que nos permite registrar el uso de Skills dentro de la empresa (ejemplo de código aquí). Esto significa que podemos encontrar Skills que son populares o que están infra-activadas en comparación con nuestras expectativas.
Conclusión
Las Skills son herramientas increíblemente poderosas y flexibles para los agentes, pero aún es temprano y todos estamos descubriendo cómo usarlas mejor.
Piensa en esto más como un conjunto de consejos útiles que hemos visto funcionar que como una guía definitiva. La mejor manera de entender las Skills es empezar, experimentar y ver qué funciona para ti. La mayoría de las nuestras comenzaron como unas pocas líneas y un solo gotcha, y mejoraron porque la gente seguía agregando a medida que Claude encontraba nuevos casos límite.
Espero que esto haya sido útil. Si tienes alguna pregunta, házmelo saber.
