Claude Skills API: qué cambia con la disponibilidad general y cómo usarla

El 20 de agosto de 2026, Anthropic convirtió en productos de disponibilidad general la Claude Skills API, computer use y Files API. Se acabaron las cabeceras beta, computer use ahora permite varios pasos por turno y llega una nueva herramienta para usar el navegador. Pero hay algo que la GA no resuelve: las skills solo se ejecutan cuando Claude decide invocarlas. El diseño de activación y el versionado siguen siendo responsabilidad del equipo.

Qué cambió realmente el 20 de agosto

Las integraciones beta existentes siguen funcionando mientras haces la migración. A partir de ahí, el anuncio de lanzamiento de Anthropic reúne varios cambios concretos:

• Adiós a las cabeceras beta. La actual guía de skills solo exige dos cosas: una clave de la Claude API y la ejecución de código activada en la petición. Las cabeceras beta que pedían los tutoriales anteriores a la GA ya no aparecen en la documentación.
• Varios pasos en un mismo turno. La herramienta actualizada de computer use ejecuta varias acciones por llamada del modelo —hacer clic, escribir, pulsar teclas y tomar capturas— en lugar de limitarse a una. La cuenta @ClaudeDevs asegura que algunos clientes con acceso anticipado han visto entre un 20 % y un 40 % menos de rondas por tarea.
• Una herramienta para usar el navegador. Combina capturas de pantalla con la estructura de la página para que el agente apunte a un campo o botón concreto, en vez de depender de coordenadas de píxeles. Está pensada para portales web, como los de tramitación de seguros.
• Más capacidad para Files API. Cada organización dispone de 1 TB de almacenamiento, límites de frecuencia 5 veces superiores —500 RPM, según el hilo de @ClaudeDevs— y caducidad automática de archivos.
• Vía de cumplimiento normativo. Computer use ya puede utilizarse en cargas reguladas por HIPAA dentro del BAA de Anthropic.
• Disponibilidad en la nube. Skills API y Files API también están disponibles a través de Microsoft Foundry. Las versiones actualizadas de computer use y browser use llegarán próximamente a Vertex AI, aunque no hay fecha anunciada.

Las tres API trabajando en un mismo flujo

El ejemplo de un agente de siniestros de Anthropic muestra el proceso completo: recuperar un documento de entrada mediante su identificador de archivo (Files API), aplicar una skill con el procedimiento de tramitación (Skills API), completar el portal de la aseguradora con browser use (computer use) y guardar después la confirmación como archivo. Los documentos se suben una sola vez y luego se referencian mediante file_id, en lugar de reenviarlos en cada petición.

Las dos series de cifras publicadas con el lanzamiento proceden de los propios proveedores. En el anuncio de lanzamiento, el ingeniero de investigación Davide Locatelli explicó que el flujo de siniestros más largo pasó de 32 minutos a 13 minutos, con una finalización del 100 %. Por separado, David Mlčoch, cofundador de Asteroid, probó flujos de computer use en el sector sanitario durante el acceso anticipado:

"Entre un 32 % y un 52 % menos de llamadas al modelo, entre un 25 % y un 32 % menos de coste por tarea, 100 % de finalización en todos los flujos, frente al 77 %" — @MlcochDavid

Cómo llamar a Claude Skills API desde Messages API

Adjuntar una skill requiere un único parámetro: un objeto container en la petición a Messages API que contenga un array skills. Cada entrada incluye un type (anthropic o custom), un skill_id y un version opcional.

Estas son las condiciones asociadas a ese parámetro, según la guía oficial de skills:

• La ejecución de código debe estar activada y el modelo tiene que admitirla; los ejemplos de la guía usan claude-opus-5, el tipo de herramienta code_execution_20250825 y max_tokens=4096.
• Una sola petición admite hasta 20 skills.
• Las skills se ejecutan en el sandbox de ejecución de código de Anthropic: no tienen acceso a la red ni pueden instalar paquetes durante la ejecución. Además, se crea un contenedor nuevo por petición, salvo que reutilices un container.id devuelto entre turnos. Cada respuesta incluye expires_at.
• No tienes que alojar los archivos de las skills: Anthropic los ejecuta dentro del contenedor.

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    tools=[{"type": "code_execution_20250825"}],
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "20251013"},
            {"type": "custom", "skill_id": "skill_01...", "version": "skver_01..."},
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue summary"}],
)

Los documentos de entrada siguen el camino inverso: primero se suben mediante Files API y después se referencian en un bloque de carga del contenedor. La petición mantiene el formato estándar de Anthropic Messages API, así que funciona tanto con una clave directa como con un relay compatible con Anthropic, por ejemplo la Claude API de AIReiter.

Las skills integradas utilizan identificadores breves y legibles, como pptx, xlsx, docx y pdf, con versiones en formato de fecha como 20251013 o latest. Las skills personalizadas reciben identificadores skill_01... asociados a tu espacio de trabajo.

Publicar una Skill personalizada: las reglas que pueden bloquearla

Una skill personalizada es un directorio cuyo archivo SKILL.md raíz contiene frontmatter YAML con name y description. También puede incluir scripts y archivos de referencia. Este sería el archivo mínimo:

---
name: eu-claims-filing
description: Use when filing or amending EU insurance claims. Loads the
  carrier-specific submission procedure, required fields, and rejection
  codes before filling any portal form.
---

# EU claims filing procedure
1. Pull the intake document by file_id ...

La subida se realiza como archivo ZIP o mediante archivos individuales —el SDK de Python ofrece files_from_dir—. Anthropic aplica estos límites estrictos antes de que la skill llegue a ejecutarse; todos aparecen en la guía de skills:

La gestión se hace con la CLI ant o con los endpoints de la API que utiliza internamente, según la misma guía. Este es el recorrido desde el archivo hasta una versión fijada:

ant skills create ./eu-claims-filing   # returns skill_01...
ant skills:versions create skill_01...  # returns skver_01... — pin this in production

Hay dos comportamientos que suelen sorprender a los equipos: una versión nueva es una instantánea completa, por lo que hay que volver a subir todos los archivos y lo que se omita no se conserva; además, eliminar una skill borra todas sus versiones.

Lista para producción: fija versiones, aísla y aprovecha la caché

En producción, los problemas más habituales son las versiones mutables, los permisos compartidos por todo el espacio de trabajo y los fallos de caché. La guía de skills es muy clara sobre los tres.

1. Fija las versiones. Si usas latest o no especificas ninguna versión, cualquier persona con acceso al espacio de trabajo puede subir una versión nueva y cambiar al instante lo que ejecuta tu agente desplegado. En producción, fija los identificadores skver_...; reserva latest para el desarrollo activo.
2. Considera el espacio de trabajo como límite entre clientes. Todas las claves de API de un mismo espacio pueden leer, invocar y eliminar cualquier skill personalizada que contenga. El aislamiento se establece por espacio de trabajo, no por usuario ni por sesión. Las aplicaciones multiinquilino deberían utilizar un espacio por cliente y tener en cuenta el límite predeterminado de 100 espacios.
3. Mantén estable la lista de skills para conservar la caché. Cambiar la lista, incluido su orden, modifica el prefijo del prompt del sistema y vacía la caché de prompts. Fijar también las versiones personalizadas protege ese prefijo, ya que volver a subir una descripción con latest la reescribiría. Con facturación por token, una lista de skills que cambia entre peticiones puede eliminar silenciosamente el ahorro de los aciertos de caché.
4. Gestiona pause_turn. Las skills de larga duración devuelven stop_reason: "pause_turn". Para continuar, reenvía el contenido devuelto en una petición posterior; si quieres interrumpir, modifica la conversación.
5. Ten claro cuánto se conservan los datos. Agent Skills no está cubierto por los acuerdos de retención cero de datos: las definiciones de las skills y los datos de ejecución siguen la política de retención estándar de Anthropic. Con Compliance API activada, Activity Feed registra la creación y eliminación de skills y versiones de skills, pero solo desde el momento en que se habilita.
6. Captura los errores adecuados. Envuelve las llamadas para capturar anthropic.BadRequestError y separar los fallos relacionados con skills de otros errores de peticiones no válidas.
7. No adjuntes skills que no uses. La documentación lo dice explícitamente: incluir skills innecesarias afecta al rendimiento.

El problema de activación que ninguna modificación de la API resuelve

La GA ha mejorado la infraestructura que rodea a las skills, pero no la forma en que Claude decide utilizarlas. Una preocupación recurrente en los hilos de usuarios es que las skills funcionan como procedimientos que se activan bajo ciertas condiciones, no como un segundo prompt del sistema.

"Mi problema con Claude Skills es que no son skills. Nada obliga a Claude a usarlas realmente. Claude hace lo que quiere... No son más que archivos md." — @Yampeleg, escrito antes de la GA; el mecanismo de invocación no ha cambiado

El hilo de r/ClaudeAI sobre si las skills funcionan de verdad resume los ajustes prácticos:

"userstyle se añade al principio en cada turno, pero las skills solo se activan cuando Claude decide invocarlas basándose en la descripción." — u/samxu01

"Las skills deben tener una descripción de metadatos sencilla y clara, centrada también en una acción que Claude esté realizando." — u/Chadum

De esos hilos se desprenden cuatro reglas:

• Redacta la descripción en torno a frases de activación y acciones concretas, no alrededor de una personalidad.
• Incluye los pasos, comprobaciones, reglas y herramientas en el cuerpo de la skill. La prueba de u/MartinMystikJonas lo resume así: "Si tus skills definen los pasos que debe seguir el agente, lo que debe comprobar, las reglas que debe respetar y las herramientas que debe usar, entonces resultan útiles."
• Codifica aquello que Claude no hace bien de forma nativa, como apunta u/Actual_Committee4670.
• Lleva los requisitos que deben cumplirse siempre al prompt del sistema o a CLAUDE.md —se añaden en cada turno, según u/samxu01— y reserva los hooks para momentos del ciclo de vida, como justo antes de un commit.

Respuestas rápidas

¿Sigo necesitando cabeceras beta para Skills API?

No. Desde la disponibilidad general del 20 de agosto de 2026, solo necesitas una clave de Claude API y la ejecución de código activada; la documentación actual ya no incluye ninguna cabecera beta.

¿Las skills consumen espacio de mi ventana de contexto?

Al principio, solo sus metadatos. Según la guía de skills, Claude recibe de entrada el frontmatter de cada skill, copia los archivos al contenedor y carga las instrucciones completas únicamente cuando la tarea las necesita. De ahí que la documentación recomiende no adjuntar skills que no se vayan a utilizar.

¿Qué diferencia hay entre una Skill y MCP?

Una skill es un paquete de instrucciones y scripts que se ejecuta dentro del sandbox de Claude, sin acceso a la red. MCP conecta Claude con sistemas externos en tiempo real. Esa es la diferencia que establece Anthropic en su descripción general de las skills. Un flujo de siniestros puede utilizar ambos: un servidor MCP para la base de datos de pólizas y una skill para el procedimiento de tramitación.

¿Puede ejecutarse el mismo SKILL.md en Claude.ai, Claude Code y la API?

El formato SKILL.md es compartido, pero la forma de distribuirlo cambia según el entorno: skills subidas al espacio de trabajo en la API, directorios .claude/skills en Claude Code y cargas asociadas al plan en la aplicación Claude.ai.

¿La Skills API funciona con retención cero de datos?

No. Agent Skills está excluido de los acuerdos de retención cero de datos; las definiciones de las skills y los datos de ejecución siguen la política de retención estándar.

Qué mecanismo corresponde a cada requisito

La elección depende del momento de activación:

El 20 de agosto convirtió el mecanismo de skills en una opción lista para producción, pero no hizo intercambiables las filas de esta tabla.

Lecturas relacionadas: precios de Claude API por modelo y token y cómo registrar una skill de Claude en Claude Code.