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.

Antes de comenzar

Necesitas un SDK de cliente para tu lenguaje, o curl y jq, y familiaridad básica con la realización de solicitudes a la API.

1. 1

   Crea una cuenta de Claude Console

   Regístrate para obtener una cuenta de Claude Console, o inicia sesión en la que ya tienes.

2. 2

   Elige cómo autenticarte

   Se recomienda iniciar sesión con la CLI para el desarrollo local.

   CLIClave de API

brew install anthropics/tap/ant

VERSION=2.9.0
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
  x86_64) ARCH=amd64 ;;
  aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latest

export PATH="$PATH:$(go env GOPATH)/bin"

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, comprueba qué Skills están disponibles. Usa la API de Skills para listar todas las Skills administradas por Anthropic. El ejemplo es un extracto de un único script continuo, con las importaciones y la configuración del cliente, si las hay, al principio:

# 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