Anthropic explica 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 compañía afirma que ya usa cientos de estas skills y que ha comprobado en la práctica cuáles mejoran de verdad la calidad del trabajo y cuáles solo inflan el contexto.

Qué skills funcionan

La tesis principal de la guía: una skill no es solo un archivo markdown con instrucciones, sino una carpeta completa con configuraciones, scripts, plantillas, datos e incluso hooks. Por eso Anthropic aconseja determinar primero el tipo de skill y solo después escribir su contenido.

Según la compañía, las mejores skills suelen resolver una única tarea clara. Las que intentan ser a la vez manual de referencia, piloto automático, runbook y generador de código suelen confundir al modelo más que ayudarlo.

• Guías de referencia de APIs, SDK y bibliotecas internas
• Skills para verificar el producto mediante navegador, CLI y assertions
• Herramientas para analizar datos, métricas y monitorización
• Plantillas de scaffolding, tests y revisión de código
• Skills para CI/CD, runbooks y operaciones de infraestructura

Anthropic destaca por separado las skills de verificación y las operativas. En el primer caso, el agente no se limita a escribir código: ejecuta el escenario, comprueba los pasos y registra el resultado. En el segundo, recibe salvaguardas para acciones sensibles como limpiar recursos, desplegar o analizar alertas. Estas skills son especialmente valiosas donde un error sale caro: en producción, pagos, onboarding y plataformas internas. Son los escenarios donde mejor se ve si una skill convierte al modelo en una herramienta de trabajo fiable.

Cómo escribir una skill

Anthropic recomienda no gastar espacio en lo obvio, lo que Claude ya sabe sobre código y prácticas habituales. Resulta mucho más útil reunir en la skill una sección con "trampas" reales: fallos típicos, casos límite no triviales y reglas locales del equipo.

Otro principio importante es la revelación progresiva del contexto a través del sistema de archivos. Los detalles de la API pueden ir a references, las plantillas a assets y la lógica repetible a scripts. Así el modelo lee solo lo que necesita para el paso actual.

«La mejor manera de entender las skills es empezar, experimentar y ver

qué te funciona».

Los autores también recomiendan planificar de antemano la configuración inicial: por ejemplo, guardar los parámetros en config.json y hacer preguntas estructuradas al usuario si la configuración está vacía. El campo description debe escribirse no como un resumen de marketing, sino como la condición de activación para el propio modelo. Para la memoria se pueden usar logs, JSON o SQLite, pero los datos persistentes conviene guardarlos en un directorio estable como `${CLAUDE_PLUGIN_DATA}`.

Además, Anthropic promueve específicamente guardar dentro de las skills código y bibliotecas auxiliares, en lugar de obligar al modelo a reinventar el boilerplate cada vez. Para simplificarlo, la compañía incluso lanzó Skill Creator.

Cómo compartir dentro del equipo

Para distribuir skills, Anthropic describe dos opciones básicas: guardarlas directamente en el repositorio del proyecto o empaquetarlas como plugins para el marketplace de Claude Code. La primera es cómoda para equipos pequeños y un par de repositorios, pero tiene un coste: cada skill confirmada en el repositorio añade contexto al modelo. Cuando las skills se multiplican, es más lógico trasladarlas a un catálogo interno aparte, donde los equipos eligen qué instalar. Esto importa especialmente si los proyectos viven en bases de código distintas y los equipos tienen necesidades diferentes.

En Anthropic no existe un grupo central único que apruebe manualmente todas las skills desde el principio. Normalmente, los avances útiles aparecen primero en local, luego se comparten por GitHub y Slack y, tras una demanda orgánica, pasan al marketplace. El uso se puede medir con hooks PreToolUse y las dependencias entre skills se resuelven por ahora con simples referencias por nombre. La idea es hacer crecer la biblioteca poco a poco, sin llenar el sistema de duplicados ni de extensiones mal mantenidas.

Qué significa

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