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. Cada skill que agregas incurre en un costo modesto en la ventana de contexto de la sesión, añadiendo instrucciones y metadatos que ayudan al modelo a usar la skill. Obtén más información en la descripción general de Agent Skills.

Las skills llegan a tu agente de dos maneras: adjúntalas a través del array skills del agente, o cárgalas desde un repositorio de GitHub montado en la sesión. Las skills adjuntas son de dos tipos. Todas las skills 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 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 más cualquier archivo de soporte, subido a tu espacio de trabajo como un archivo zip o como archivos individuales. Crear la skill 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.

La API de Skills no requiere un encabezado beta. El ejemplo de cURL aún envía anthropic-beta: skills-2025-10-02, y los comandos beta de la CLI y el SDK lo agregan automáticamente; las solicitudes que lo incluyen continúan funcionando sin cambios.

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

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 API de Files.



Adjuntar skills a un agente

Adjunta skills al crear un agente. Cada sesión admite hasta 500 skills, contadas como el conjunto deduplicado entre todos los agentes de la sesión (consulta Orquestación multiagente).

Cada entrada en el array skills usa los siguientes campos:

ant beta:agents create < agent.yaml

name: Financial Analyst
model: claude-opus-5
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest



Cargar skills desde un repositorio de GitHub

Las skills también pueden residir en tu base de código. Cuando una sesión monta un repositorio a través del recurso github_repository, el directorio raíz .claude/skills del repositorio se escanea al inicio de la sesión, y cada skill encontrada allí queda disponible para el agente. No se requiere ninguna carga ni ninguna entrada en el array skills del agente. El agente ve el nombre, la descripción y la ruta en el sandbox de cada skill descubierta, y lee el SKILL.md de la skill cuando una tarea coincide, incluyendo cualquier script y recurso que la skill incluya. El descubrimiento depende de la herramienta read del agente del conjunto de herramientas del agente, que está habilitada de forma predeterminada; un agente con read deshabilitado no carga skills del repositorio.

El descubrimiento encuentra skills exactamente en .claude/skills/<skill-name>/SKILL.md, un nivel de directorio de profundidad en la raíz del repositorio:

• your-repo/
  • .claude/
    • skills/
      • code-review/
        • SKILL.md
      • release-process/
        • SKILL.md
        • scripts/
          • run_checks.sh
  • src/

Las ubicaciones que no coinciden con esta estructura no se descubren al inicio de la sesión:

• .claude/skills/SKILL.md: un SKILL.md sin un directorio de skill que lo contenga
• .claude/skills/tools/code-review/SKILL.md: anidado más de un nivel de directorio de profundidad
• skills/code-review/SKILL.md: un directorio skills fuera de .claude

Un directorio .claude/skills en otra parte del repositorio, como dentro de un subdirectorio de paquete, no se anuncia al inicio de la sesión; esas skills aún pueden aparecer cuando el agente lee archivos bajo ese subárbol.

Las skills del repositorio usan el mismo formato SKILL.md que las skills personalizadas que subes. Para el formato y la guía de creación, consulta Agent Skills y Mejores prácticas para la creación de skills.

Para cargar skills desde un repositorio, crea una sesión que lo monte. Esta es la misma solicitud que se muestra en Acceso a GitHub; mount_path es opcional y su valor predeterminado es /workspace/<repo-name>:

SESSION_ID=$(ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --transform id --raw-output <<'EOF'
resources:
  - type: github_repository
    url: https://github.com/org/repo
    mount_path: /workspace/repo
    authorization_token: ghp_your_github_token
EOF
)

Para repositorios privados, el authorization_token del recurso debe tener acceso al repositorio. Este es el mismo flujo de token de acceso personal usado para cualquier montaje de repositorio; consulta Acceso a GitHub.

Las skills descubiertas siguen el estado extraído del repositorio: la rama o commit de checkout cuando el recurso establece uno, de lo contrario la rama predeterminada del repositorio. El escaneo se ejecuta una vez, cuando la sesión comienza. Los commits enviados a mitad de sesión no se detectan; para cargar skills actualizadas, inicia una nueva sesión.

Las skills del repositorio funcionan junto con las skills adjuntas a través del array skills del agente. Si una skill del repositorio comparte nombre con una skill adjunta, o con una skill de otro repositorio montado, ambas están disponibles; cada una se anuncia con su propia ruta.



Próximos pasos