Cargando
Cargando

Skills

Las Skills son carpetas de instrucciones, scripts y recursos que Claude carga dinámicamente para mejorar el rendimiento en tareas especializadas. En el núcleo de cada Skill hay un archivo SKILL.md — un conjunto de instrucciones empaquetado que subes una vez y luego adjuntas a cualquier llamada messages.create. Le estás enseñando a Claude cómo haces tú algo: el formato de tu informe de estado, tu lista de verificación de revisión, tus notas de lanzamiento. Claude lee la Skill, sigue el procedimiento y produce una salida con tu formato.

Skills frente a herramientas

Vale la pena tener clara la diferencia, porque ambas resuelven problemas distintos:

  • Las herramientas conectan a Claude con datos y acciones. "Busca esta sección de código", "envía este correo" — Claude llama a la herramienta, y algo más se ejecuta.
  • Las Skills le enseñan a Claude un procedimiento. "Genera el informe diario de estado siguiendo esta plantilla" — es un manual que Claude lee y sigue, lo que a veces implica ejecutar scripts incluidos por sí mismo.

Una forma sencilla de recordarlo: las herramientas tienen que ver con qué puede hacer Claude, mientras que las Skills tienen que ver con cómo quieres que se haga.

Comparación lado a lado de herramientas y Skills: las herramientas se conectan a datos, realizan acciones y ejecutan código — qué puede hacer Claude; las Skills enseñan un procedimiento solo con instrucciones, sin ejecutar código — cómo quieres que se haga

Otra cosa que vale la pena saber: las Skills no se cargan por completo en el contexto al inicio. Al principio solo se cargan el nombre y la descripción. Cuando tu agente decide que una Skill es relevante, entonces carga la Skill completa en el contexto. Eso mantiene tu contexto reducido incluso cuando hay muchas Skills disponibles.

Subir una Skill

Las Skills se suben una vez a tu espacio de trabajo y luego se referencian por ID. Puedes subirlas directamente en Claude Platform, o hacerlo de forma programática:

python
import anthropic
from anthropic.lib import files_from_dir

client = anthropic.Anthropic()

skill = client.skills.create(
    display_name="Status Report Generator",
    files=files_from_dir("status-report-skill"),  # folder containing SKILL.md
)

print(skill.id)  # reference this ID in future requests

Para este ejemplo, quiero un generador de informes de estado. Todas las reglas sobre qué hace que un buen informe de estado sea bueno — secciones, tono, cómo resumir, cómo manejar los bloqueos — están contenidas en una Skill empaquetada de antemano. El registro de actividad en sí es solo una cadena que se pasa en el momento de la solicitud.

Adjuntar una Skill a una solicitud

Las Skills se adjuntan a una solicitud a través de la configuración del contenedor — un arreglo skills dentro del contenedor, donde cada entrada nombra un skill_id y una version. Aquí está la llamada completa para el generador de informes de estado:

python
response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {
                "type": "custom",
                "skill_id": skill.id,
                "version": "latest",
            }
        ]
    },
    tools=[
        {
            "type": "code_execution_20250825",
            "name": "code_execution",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": f"Generate the daily status report from this activity log:\n\n{activity_log}",
        }
    ],
)

Algunas cosas que vale la pena señalar:

  • Estamos llamando al client.messages.create estándar, sin encabezado beta. Las Skills están disponibles de forma general en Claude API, por lo que el encabezado beta skills-2025-10-02 ya no es necesario; las solicitudes que aún lo envían siguen funcionando sin cambios.
  • container.skills es donde se adjunta la Skill. Es una lista, por lo que puedes superponer varias Skills en una sola llamada.
  • La ejecución de código también está activada aquí. Es obligatoria: en la API, las Skills se ejecutan dentro del contenedor de la herramienta de ejecución de código, que es lo que permite que los procedimientos de la Skill realicen trabajo real — como ejecutar scripts en una terminal.

Ejecutándolo

La salida es un informe de estado formateado exactamente de la forma en que la Skill indica que debe formatearse. Las secciones, el tono, el manejo de bloqueos — todo proviene del archivo SKILL.md que subiste. El prompt del usuario es una sola línea; el procedimiento vive en la Skill.

Salida de terminal del informe diario de estado generado, con secciones de Hecho y Bloqueos y un resumen formateado por la Skill

En una aplicación de producción, así es como un equipo estandariza la salida en toda una funcionalidad. Con este endpoint de informe diario de estado, cada gerente de producto obtiene la misma estructura, el mismo tono, las mismas secciones, en el mismo orden — sin que nadie tenga que copiar y pegar una plantilla en un prompt.

Una aplicación de gestión de proyectos con una página de Informes diarios, donde el registro de actividad de cada proyecto tiene un botón de Generar informe de un solo clic respaldado por la Skill

Resumen

  • Las Skills empaquetan tus procedimientos. Un archivo SKILL.md (además de cualquier script y recurso) le enseña a Claude cómo quieres que se haga algo.
  • Herramientas frente a Skills: las herramientas tienen que ver con qué puede hacer Claude; las Skills tienen que ver con cómo quieres que se haga.
  • Las Skills se cargan progresivamente. Al inicio solo se cargan el nombre y la descripción; la Skill completa se carga en el contexto cuando el agente decide usarla.
  • Súbela una vez con client.skills.create, y luego adjúntala con container.skills en cualquier llamada messages.create — una lista, para que puedas superponer varias Skills.
  • Combínala con la ejecución de código cuando el procedimiento de la Skill necesite realizar trabajo real.
  • Recurre a una Skill cuando el cómo importa tanto como el qué.