Anthropic explicó cómo crear skills para Claude Code y por qué los equipos necesitan su propio marketplace

Anthropic ha publicado una guía detallada sobre skills para Claude Code — extensiones que ayudan al agente a trabajar mejor con código, datos y procesos internos. La empresa afirma que ya utiliza cientos de tales skills y ha descubierto en la práctica cuáles realmente mejoran la calidad del trabajo y cuáles solo inflan el contexto.

Qué skills funcionan

El punto principal de la guía: una skill no es simplemente un archivo markdown con instrucciones, sino una carpeta completa con configuraciones, scripts, templates, datos e incluso hooks. Por eso Anthropic recomienda primero determinar el tipo de skill y luego escribir su contenido. Según las observaciones de la empresa, las mejores skills generalmente resuelven una tarea clara. Aquellas que intentan ser simultáneamente referencia, piloto automático, runbook y generador de código confunden el modelo más a menudo de lo que lo ayudan.

• Referencias de API, SDK y bibliotecas internas
• Skills para verificación de producto a través de navegador, CLI y assertions
• Herramientas para análisis de datos, métricas y monitoreo
• Templates para scaffolding, tests y code review
• Skills para CI/CD, runbooks y operaciones de infraestructura

Anthropic destaca por separado las skills de verificación y operacionales. En el primer caso, el agente no solo escribe código, sino que ejecuta el escenario él mismo, verifica los pasos y registra el resultado. En el segundo caso, obtiene salvaguardas para acciones sensibles como limpieza de recursos, despliegue o triage de alertas. Tales skills son especialmente valiosas donde los errores son costosos: en producción, pagos, onboarding y plataformas internas. Estos escenarios muestran mejor si una skill convierte el modelo en una herramienta de trabajo confiable.

Cómo escribir una skill

Anthropic recomienda no desperdiciar espacio en cosas obvias que Claude ya conoce sobre código y prácticas típicas. Es mucho más útil reunir en una skill una sección con "trampas" reales: fallos típicos, casos extremos no triviales y reglas locales del equipo. Otro principio importante es la divulgación gradual del contexto a través del sistema de archivos. Los detalles de API pueden ir a referencias, templates a assets, y lógica repetitiva a scripts. De esta forma el modelo solo lee lo que necesita para el paso actual.

"La mejor manera de entender skills es comenzar, experimentar y ver

qué funciona para ti."

Los autores también recomiendan planificar por adelantado la configuración inicial: por ejemplo, almacenar parámetros en config.json y hacer preguntas estructuradas al usuario si el config está vacío. El campo description debe escribirse no como un resumen de marketing, sino como una condición de disparo para el propio modelo. Para memoria, puedes usar logs, JSON o SQLite, pero los datos persistentes se mantienen mejor en un directorio estable como `${CLAUDE_PLUGIN_DATA}`. Además, Anthropic promueve por separado la idea de almacenar código y librerías auxiliares dentro de skills en lugar de forzar al modelo a reinventar boilerplate cada vez. Para simplificar este proceso, la empresa incluso lanzó Skill Creator.

Cómo compartir dentro de un equipo

Para distribuir skills, Anthropic describe dos escenarios básicos: almacenarlas directamente en el repositorio del proyecto o empaquetarlas como plugins para el marketplace de Claude Code. La primera opción es conveniente para equipos pequeños y un par de repositorios, pero tiene un costo: cada skill commitada añade contexto al modelo. Cuando hay muchas skills, tiene sentido moverlas a un catálogo interno separado donde los equipos eligen qué instalar. Esto es especialmente importante si diferentes proyectos viven en diferentes bases de código y los equipos tienen necesidades diferentes.

Dicho esto, Anthropic no tiene un único equipo central que apruebe manualmente todas las skills desde el principio. Generalmente, los desarrollos útiles primero aparecen localmente, luego se comparten a través de GitHub y Slack, y después de demanda orgánica, se promocionan al marketplace. El uso puede medirse a través de hooks PreToolUse, y las dependencias entre skills se resuelven actualmente por simples enlaces basados en nombres. La idea es hacer crecer la librería gradualmente, sin saturar el sistema con duplicados y extensiones mal mantenidas.

Lo que significa

La guía de Anthropic muestra un cambio importante: el valor de las herramientas de IA para el desarrollo cada vez más reside no solo en el modelo, sino en cómo el equipo empaqueta su conocimiento, verificaciones y procesos seguros a su alrededor. Para los usuarios de Claude Code, esto es una señal de invertir no en "prompts mágicos", sino en una capa customizada de skills que hace el agente más predecible, útil y más cercano a las tareas reales de trabajo en el ambiente de ingeniería.