Comienza a usar Agent Skills en la API

Este tutorial te muestra cómo usar Agent Skills (habilidades de agente) para crear una presentación de PowerPoint. Aprenderás cómo habilitar Skills, realizar una solicitud y acceder al archivo generado.

Requisitos previos

• Una clave de API de Claude o una sesión iniciada en la CLI ant
• Un SDK de cliente para tu lenguaje, o curl y jq
• Familiaridad básica con la realización de solicitudes a la API

Descripción general de Agent Skills

Las Agent Skills predefinidas amplían las capacidades de Claude con experiencia especializada para tareas como crear documentos, analizar datos y procesar archivos. Anthropic proporciona las siguientes Agent Skills predefinidas en la API:

• PowerPoint (pptx): Crea y edita presentaciones
• Excel (xlsx): Crea y analiza hojas de cálculo
• Word (docx): Crea y edita documentos
• PDF (pdf): Genera documentos PDF

Paso 1: Lista las Skills disponibles

Primero, verifica qué Skills están disponibles. Usa la API de Skills para listar todas las Skills administradas por Anthropic. Cada pestaña de lenguaje es un extracto de un único script continuo, con las importaciones y la configuración del cliente en la parte superior:

# Listar las Skills administradas por Anthropic
skills = client.skills.list(source="anthropic")

for skill in skills.data:
    print(f"{skill.id}: {skill.display_name}")

Verás las siguientes Skills: pptx, xlsx, docx y pdf.

Esta API devuelve los metadatos de cada Skill: su nombre y descripción. Claude carga estos metadatos al inicio para determinar qué Skills están disponibles. Este es el primer nivel de "progressive disclosure" (divulgación progresiva), donde Claude descubre las Skills sin cargar aún sus instrucciones completas.

Paso 2: Crea una presentación

Usa la Skill de PowerPoint para crear una presentación sobre energía renovable. Especifica las Skills usando el parámetro container en la Messages API:

# Crear un mensaje con la Skill de PowerPoint
response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pptx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a presentation about renewable energy with 5 slides",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

print(f"stop_reason={response.stop_reason}, blocks={len(response.content)}")

La solicitud incluye las siguientes partes:

• model: Un modelo que admite la herramienta de ejecución de código
• container.skills: Especifica qué Skills puede usar Claude
• type: "anthropic": Indica que esta es una Skill administrada por Anthropic
• skill_id: "pptx": El identificador de la Skill de PowerPoint
• version: "latest": La versión de la Skill establecida en la publicada más recientemente
• tools: Habilita la ejecución de código (requerida para las Skills)

Cuando realizas esta solicitud, Claude asocia automáticamente tu tarea con la Skill relevante. Como pediste una presentación, Claude determina que la Skill de PowerPoint es relevante y carga sus instrucciones completas: el segundo nivel de divulgación progresiva. Luego, Claude ejecuta el código de la Skill para crear tu presentación.

Paso 3: Descarga el archivo creado

La presentación se creó en el contenedor de ejecución de código y se guardó como un archivo. La response del Paso 2 incluye una referencia de archivo con un ID de archivo. Extrae el ID de archivo y descarga el archivo con la Files API. El ejemplo lo guarda en el directorio temporal de tu sistema:

# Extraer el ID del archivo. La herramienta de ejecución de código ejecuta el código de la Skill mediante
# su subherramienta Bash, y los archivos generados aparecen como elementos bash_code_execution_output
# dentro del bloque bash_code_execution_tool_result.
file_id = None
for block in response.content:
    if block.type == "bash_code_execution_tool_result":
        if block.content.type == "bash_code_execution_result":
            for output in block.content.content:
                file_id = output.file_id

if file_id:
    # Descargar el archivo y guardarlo
    output_path = Path(tempfile.gettempdir()) / "renewable_energy.pptx"
    file_content = client.files.download(file_id=file_id)
    file_content.write_to_file(output_path)
    print(f"Presentation saved to {output_path}")

Prueba más ejemplos

Prueba estas variaciones:

Crea una hoja de cálculo

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "xlsx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Create a quarterly sales tracking spreadsheet with sample data",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Crea un documento de Word

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "docx", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Write a 2-page report on the benefits of renewable energy",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Genera un PDF

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=16000,
    container={
        "skills": [{"type": "anthropic", "skill_id": "pdf", "version": "latest"}]
    },
    messages=[
        {
            "role": "user",
            "content": "Generate a PDF invoice template",
        }
    ],
    tools=[{"type": "code_execution_20260521", "name": "code_execution"}],
)

Próximos pasos