Claude Skills: qué son y cómo gobernarlas a escala

¿Qué son las habilidades de Claude?

Las habilidades de Claude, a veces llamadas habilidades de agente, son paquetes de capacidades reutilizables que enseñan a un agente a realizar una tarea especializada, como consultar una base de datos, clasificar una alerta, seguir un protocolo de escalada o redactar notas de lanzamiento. Una habilidad se crea una vez y se reutiliza en todas partes, de modo que el mismo procedimiento sirve para un agente en producción, una sesión local de Claude Code o Cursor sin tener que reescribirlo para cada uno.

La idea clave es que una habilidad no es un prompt que se pega. Es un paquete pequeño e independiente que el agente lee bajo demanda cuando la tarea lo requiere.

Cómo se estructura una habilidad

Cada habilidad es un directorio que tiene como raíz un archivo SKILL.md. Ese archivo consta de dos partes:

• Frontmatter YAML con un nombre y una descripción. Este es el único texto que el agente ve sobre la habilidad de antemano, por lo que la descripción debe estar orientada a la acción ("Usar cuando el usuario solicite cifras de ventas, uso o costes") para que el modelo elija la habilidad correcta en el momento adecuado.
• Un cuerpo en Markdown con el procedimiento real que sigue el agente una vez que selecciona la habilidad.

Una habilidad también puede incluir archivos de soporte junto a SKILL.md, como documentos de referencia y scripts, que el modelo lee bajo demanda una vez que la habilidad está en el ámbito de aplicación. Una habilidad típica con múltiples activos tiene este aspecto:

---

name: analytics-helper

description: Cómo consultar el almacén de datos analíticos. Usar cuando el usuario solicite cifras de ventas, uso o costes.

---

‍

# Habilidad de asistente de análisis

‍

## Consulta de tablas

1. Utiliza el script `query.py` que se encuentra en el directorio `scripts/` de esta habilidad.

2. Consulta los esquemas en `references/sales-tables.md`.

3. Limita los resultados a 1000 filas, a menos que el usuario solicite una exportación completa.

‍

## Agregaciones comunes

Para los ingresos, agrupa por `month_start` y suma `gross_revenue`.

‍

Cuando un usuario pregunta "¿cuántos ingresos obtuvimos en octubre?", el agente lee la habilidad, sigue los pasos y utiliza los scripts y referencias incluidos para responder, en lugar de intentar adivinar el esquema.

Las habilidades de Claude funcionan mejor cuando

• Una tarea es repetitiva y tiene un procedimiento correcto conocido.
• Los pasos son demasiado largos o demasiado específicos para incluirlos en un prompt del sistema.
• El mismo flujo de trabajo debe ejecutarse en varios agentes o herramientas.
• Quieres que el procedimiento mejore en un solo lugar y se propague a todas partes.

Por qué gestionar las habilidades de Claude se vuelve difícil

Escribir tu primera habilidad lleva minutos. Ejecutar una biblioteca de ellas en toda una empresa es donde los equipos encuentran fricción, y suele manifestarse como el mismo conjunto de problemas.

‍

Los archivos de habilidades terminan dispersos por los repositorios, por lo que nadie sabe qué habilidades existen o cuál es la versión canónica. No hay fijación de versiones independiente del código, por lo que un cambio en una habilidad puede alterar silenciosamente el comportamiento de un agente en producción. No hay control de acceso por habilidad, por lo que cualquier equipo puede leer o cambiar cualquier procedimiento. Y la misma habilidad se copia en tres repositorios y, poco a poco, deja de estar sincronizada.

‍

Estos son problemas de gobernanza, no de creación, y son exactamente para lo que sirve un registro central.

Cómo el Registro de Habilidades de TrueFoundry gobierna las habilidades de Claude

En TrueFoundry, las habilidades residen en el Registro de Habilidades, un catálogo centralizado, versionado y gobernado por RBAC. Esto contrasta deliberadamente con la experiencia predeterminada, donde los archivos de habilidades se confirman en los repositorios de los agentes o se cargan de forma ad hoc sin un registro compartido, sin fijación de versiones y sin control de acceso por habilidad.

‍

Captura de pantalla del producto, documentación de TrueFoundry: el Registro de Habilidades.

‍

El registro añade los controles que necesita una biblioteca de habilidades en crecimiento:

‍

• Descubrimiento. Un catálogo único para todos los equipos, para que las personas puedan buscar, explorar y reutilizar las habilidades existentes en lugar de volver a escribirlas.
• Control de versiones. Cada habilidad cuenta con su propio control de versiones, lo que te permite fijar una versión específica por agente para garantizar la estabilidad en producción.
• Control de acceso. Las habilidades heredan el control de acceso basado en roles (RBAC) de su repositorio principal, por lo que tú decides quién puede leer, utilizar o publicar cada una de ellas.
• Reversión. Vuelve al instante a una versión que funcione correctamente si una nueva versión presenta errores.
• Registro de auditoría. Cada cambio de versión y cada uso quedan registrados.
• Reutilización entre agentes. La misma habilidad puede potenciar múltiples agentes sin duplicaciones ni desviaciones.

‍

Captura de pantalla del producto, documentación de TrueFoundry: publicación de una versión de habilidad.

‍

Dado que el registro se encuentra junto al puerta de enlace de IA (AI Gateway) y la puerta de enlace MCP, una habilidad no es un archivo aislado. Los equipos de plataforma gestionan qué habilidades están disponibles para qué agentes y equipos, y los desarrolladores de agentes eligen de un catálogo aprobado en lugar de gestionar archivos manualmente. La habilidad que un desarrollador utiliza en Claude Code es el mismo artefacto gobernado que utiliza un agente en producción, lo cual mantiene la coherencia del comportamiento a medida que escalas.

‍