Skills

Las "skills" (habilidades) son recursos reutilizables, basados en el sistema de archivos, que le dan a tu agente experiencia específica de un 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 implica un costo modesto en la "context window" (ventana de contexto) de la sesión, ya que añade 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 con 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 más cualquier archivo de apoyo, subido a tu espacio de trabajo como un archivo zip o como archivos individuales. Al crear la skill se devuelve el ID skill_* al que haces referencia cuando la adjuntas 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 Skills API no requiere un encabezado beta. Las solicitudes que aún envían anthropic-beta: skills-2025-10-02 siguen funcionando y devuelven los campos de respuesta anteriores.

Estos ejemplos omiten el campo opcional display_name, por lo que el nombre visible de la skill se deriva del campo name en SKILL.md. Un display_name explícito puede tener hasta 255 caracteres y no necesita ser único dentro de tu espacio de trabajo.

ant skills create \
  --file example_skill.zip

Para listar, recuperar, eliminar y versionar skills personalizadas, consulta Administració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 Skills API 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 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 vivir 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 subida 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, incluidos los scripts y recursos que la skill incluye. 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 deshabilitada no carga skills del repositorio.

El descubrimiento encuentra skills exactamente en .claude/skills/<skill-name>/SKILL.md, a 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 a 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 un 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 que se usa para cualquier montaje de repositorio; consulta Acceso a GitHub.

Las skills descubiertas siguen el estado del checkout del repositorio: la rama o el 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 se inicia. Los commits enviados a mitad de la 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