Skills

Las "skills" (habilidades) son recursos reutilizables basados en el sistema de archivos que proporcionan a tu agente experiencia específica de dominio: flujos de trabajo, contexto y mejores prácticas que convierten a un agente de propósito general en un especialista. A diferencia de los prompts (instrucciones a nivel de conversación para tareas puntuales), las skills se cargan bajo demanda y solo afectan la ventana de contexto cuando son necesarias.

Puedes adjuntar dos tipos de skill. Ambos funcionan de la misma manera: tu agente las invoca automáticamente cuando son relevantes para la tarea.

• Skills predefinidas de Anthropic: Tareas comunes de documentos como el manejo de PowerPoint, Excel, Word y PDF (pptx, xlsx, docx, pdf).
• Skills personalizadas: Skills que tú creas y subes a tu espacio de trabajo.

Para aprender a crear skills personalizadas, consulta Agent Skills y Mejores prácticas para la creación de skills. Para subir una skill personalizada a tu espacio de trabajo, consulta Crear una skill personalizada.



Crear una skill personalizada

Una skill personalizada es un directorio que contiene un archivo SKILL.md junto con cualquier archivo de soporte, subido a tu espacio de trabajo como un archivo zip o como archivos individuales. Al crear la skill se devuelve el ID skill_* que referencias al adjuntarla a un agente. Las skills predefinidas de Anthropic ya están disponibles en todos los espacios de trabajo y no requieren este paso. Para usar solo skills predefinidas, salta a Adjuntar skills a un agente.

Cuando llames a la API de Skills directamente con cURL o la CLI, pasa el encabezado anthropic-beta: skills-2025-10-02 de forma explícita. Los SDK lo envían automáticamente.

Estos ejemplos omiten el campo opcional display_title, por lo que el título de la skill se deriva de SKILL.md. Un display_title pasado explícitamente debe ser único entre las skills personalizadas de tu espacio de trabajo.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

Para listar, recuperar, eliminar y versionar skills personalizadas, consulta Gestión de skills personalizadas. Para los esquemas completos de solicitud y respuesta, consulta la referencia de la API Create Skill. Los paquetes de skills se suben directamente a la API de Skills en lugar de a través de la Files API.



Adjuntar skills a un agente

Adjunta skills al crear un agente. Cada sesión admite hasta 20 skills en total, contadas entre todos los agentes de la sesión (consulta Sesiones multiagente).

Cada entrada en el arreglo skills usa los siguientes campos:

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



Próximos pasos