Agent Skills

Por qué usar Skills

Las Skills son recursos reutilizables basados en el sistema de archivos que le dan a Claude 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. A diferencia de los prompts (instrucciones a nivel de conversación para tareas puntuales), las Skills se cargan bajo demanda, por lo que no tienes que repetir la misma orientación en cada conversación.

Beneficios clave:

• Especializa a Claude: Adapta las capacidades para tareas específicas de un dominio
• Reduce la repetición: Crea una vez, usa automáticamente
• Compón capacidades: Combina Skills para tareas complejas de varios pasos

Uso de Skills

Anthropic proporciona Agent Skills predefinidas para tareas comunes con documentos (PowerPoint, Excel, Word, PDF), y puedes crear tus propias Skills personalizadas. Ambas funcionan de la misma manera: una vez que una Skill está disponible en tu entorno, Claude la usa automáticamente cuando es relevante para tu solicitud.

Las Agent Skills predefinidas están disponibles en claude.ai, la API de Claude, Claude Platform on AWS y Microsoft Foundry. En Microsoft Foundry, las Agent Skills requieren un despliegue Hosted on Anthropic. Consulta Skills disponibles para ver la lista completa.

Las Skills personalizadas te permiten empaquetar experiencia de dominio y conocimiento organizacional. Están disponibles en todos los productos de Claude: créalas en Claude Code, súbelas a través de la API de Claude o agrégalas en la configuración de claude.ai. En Claude Platform on AWS y Microsoft Foundry, sube Skills personalizadas a través de la Skills API.

Cómo funcionan las Skills

Las Skills usan el entorno de máquina virtual de Claude para proporcionar capacidades más allá de lo que es posible solo con prompts. Claude opera en una máquina virtual con acceso al sistema de archivos, lo que permite que las Skills existan como directorios que contienen instrucciones, código ejecutable y materiales de referencia, organizados como una guía de incorporación que crearías para un nuevo miembro del equipo.

Esta arquitectura basada en el sistema de archivos permite la "progressive disclosure" (revelación progresiva): Claude carga la información por etapas según se necesita, en lugar de consumir contexto desde el principio.

Las Skills pueden contener tres tipos de contenido, cada uno cargado en un momento diferente:

Nivel 1: Metadatos (siempre cargados)

El frontmatter YAML de la Skill proporciona información de descubrimiento:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude carga estos metadatos al inicio y los incluye en el "system prompt" (indicación del sistema). La description es con lo que Claude compara tu solicitud al determinar si debe activar la Skill, por lo que debe indicar tanto qué hace la Skill como cuándo usarla. Este enfoque ligero significa que puedes instalar muchas Skills sin penalización de contexto: hasta que una Skill se activa, solo su nombre y descripción ocupan contexto.

Nivel 2: Instrucciones (cargadas cuando se activa)

El cuerpo principal de SKILL.md contiene conocimiento procedimental: flujos de trabajo, mejores prácticas y orientación:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Cuando solicitas algo que coincide con la descripción de una Skill, Claude lee SKILL.md desde el sistema de archivos usando bash. Solo entonces este contenido entra en la "context window" (ventana de contexto).

Nivel 3: Recursos y código (cargados según sea necesario)

Las Skills pueden incluir materiales adicionales:

• pdf-processing/
  • SKILL.md (instrucciones principales)
  • FORMS.md (guía para rellenar formularios)
  • REFERENCE.md (referencia detallada de la API)
  • scripts/
    • fill_form.py (script de utilidad)

Instrucciones: Archivos markdown adicionales (FORMS.md, REFERENCE.md) que contienen orientación y flujos de trabajo especializados

Código: Scripts ejecutables (fill_form.py, validate.py) que Claude ejecuta usando bash, proporcionando operaciones deterministas sin cargar su código en el contexto

Recursos: Materiales de referencia como esquemas de bases de datos, documentación de API, plantillas o ejemplos

Claude accede a estos archivos solo cuando se hace referencia a ellos. El modelo de sistema de archivos significa que cada tipo de contenido tiene diferentes fortalezas: instrucciones para orientación flexible, código para confiabilidad, recursos para consulta de datos.

La divulgación progresiva garantiza que solo el contenido relevante ocupe la ventana de contexto en un momento dado.

La arquitectura de las Skills

Las Skills se ejecutan en un entorno de ejecución de código donde Claude tiene acceso al sistema de archivos, comandos bash y capacidades de ejecución de código. Las Skills existen como directorios en una máquina virtual, y Claude interactúa con ellas usando los mismos comandos bash que usarías para navegar por los archivos de tu computadora.

Cómo accede Claude al contenido de una Skill:

Cuando se activa una Skill, Claude usa bash para leer SKILL.md desde el sistema de archivos, incorporando sus instrucciones a la ventana de contexto. Si esas instrucciones hacen referencia a otros archivos (como FORMS.md o un esquema de base de datos), Claude también lee esos archivos usando comandos bash adicionales. Cuando las instrucciones mencionan scripts ejecutables, Claude los ejecuta a través de bash y recibe solo la salida (el código del script en sí nunca entra en el contexto).

Lo que permite esta arquitectura:

• Acceso a archivos bajo demanda: Claude lee solo los archivos que necesita cada tarea. Una Skill puede incluir docenas de archivos de referencia, pero si tu tarea solo necesita el esquema de ventas, ese es el único archivo que Claude carga. El resto permanece en el sistema de archivos y no cuesta ningún token.
• Ejecución eficiente de scripts: Cuando Claude ejecuta validate_form.py, el código del script nunca se carga en la ventana de contexto. Solo su salida (como "Validation passed" o un mensaje de error específico) consume tokens, lo que hace que los scripts sean mucho más eficientes que hacer que Claude genere código equivalente sobre la marcha.
• Sin límite práctico para el contenido incluido: Los archivos no consumen contexto hasta que se accede a ellos, por lo que las Skills pueden incluir documentación completa de API, grandes conjuntos de datos o ejemplos extensos. No hay penalización de contexto por el contenido incluido que no se usa.

Ejemplo: Carga de una Skill de procesamiento de PDF

Así es como Claude carga y usa la Skill personalizada pdf-processing de los ejemplos anteriores (no la Skill prediseñada pdf):

1. Inicio: La indicación del sistema incluye: pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
2. Solicitud del usuario: "Extrae el texto de este PDF y resúmelo"
3. Claude invoca: bash: cat pdf-processing/SKILL.md → Instrucciones cargadas en el contexto
4. Claude determina: No es necesario rellenar formularios, por lo que no se lee FORMS.md
5. Claude ejecuta: Usa las instrucciones de SKILL.md para completar la tarea

Dónde funcionan las Skills

Las Skills están disponibles en todos los productos de agentes de Claude:

API de Claude

La API de Claude admite tanto Agent Skills prediseñadas como Skills personalizadas. Ambas funcionan de forma idéntica: especifica el skill_id correspondiente en el parámetro container junto con la herramienta de ejecución de código.

Requisitos previos: Usar Skills a través de la API requiere la herramienta de ejecución de código, en cuyo contenedor se ejecutan las Skills.

Usa las Agent Skills prediseñadas haciendo referencia a su skill_id (pptx, xlsx, docx o pdf), o crea y sube las tuyas a través de la API de Skills (endpoints /v1/skills). Las Skills personalizadas se comparten en todo el espacio de trabajo: todos los miembros del espacio de trabajo pueden acceder a ellas.

Las Skills en la API se ejecutan en un contenedor aislado sin acceso a la red y sin instalación de paquetes en tiempo de ejecución. Consulta Limitaciones y restricciones para obtener más detalles.

Para obtener más información, consulta Uso de Agent Skills con la API.

Claude Code

Claude Code admite Skills personalizadas. Las Skills de documentos prediseñadas (PowerPoint, Excel, Word, PDF) no están disponibles en Claude Code, aunque la skill de la API de Claude de código abierto viene incluida con él. Consulta la lista completa de comandos y Skills integrados que se incluyen con Claude Code.

Skills personalizadas: Crea Skills como directorios con archivos SKILL.md. Claude las descubre y las usa automáticamente.

Las Skills personalizadas en Claude Code se basan en el sistema de archivos y no requieren subidas a la API: colócalas en ~/.claude/skills/ (personales) o .claude/skills/ (de proyecto).

Para obtener más información, consulta Usar Skills en Claude Code.

claude.ai

claude.ai admite tanto Agent Skills prediseñadas como Skills personalizadas.

Agent Skills prediseñadas: Estas Skills están activas cuando creas documentos. Claude las usa sin necesidad de configuración.

Skills personalizadas: Sube tus propias Skills como archivos zip a través de Settings > Features (Configuración > Funciones). Disponible en los planes Pro, Max, Team y Enterprise con la ejecución de código habilitada. Las Skills personalizadas son individuales para cada usuario. No se comparten en toda la organización y los administradores no pueden gestionarlas de forma centralizada.

Para obtener más información sobre el uso de Skills en claude.ai, consulta los siguientes recursos en el Centro de ayuda de Claude:

• ¿Qué son las Skills?
• Uso de Skills en Claude
• Cómo crear Skills personalizadas
• Enséñale a Claude tu forma de trabajar usando Skills

Estructura de una Skill

Cada Skill requiere un archivo SKILL.md con frontmatter YAML:

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Campos obligatorios: name y description

Requisitos de los campos:

name:

• Máximo 64 caracteres
• Debe contener solo letras minúsculas, números y guiones
• No puede contener etiquetas XML
• No puede contener palabras reservadas: "anthropic", "claude"

description:

• No debe estar vacío
• Máximo 1024 caracteres
• No puede contener etiquetas XML

La description debe incluir tanto qué hace la Skill como cuándo debe usarla Claude. Para una guía completa de creación, consulta Mejores prácticas para la creación de Skills.

Consideraciones de seguridad

Usa Skills solo de fuentes confiables: las que creaste tú mismo o las que obtuviste de Anthropic. Las Skills le dan a Claude nuevas capacidades a través de instrucciones y código, lo que también significa que una Skill maliciosa puede dirigir a Claude a invocar herramientas o ejecutar código de maneras que no coinciden con el propósito declarado de la Skill.

Consideraciones clave de seguridad:

• Audita minuciosamente: Revisa todos los archivos incluidos en la Skill: SKILL.md, scripts, imágenes y otros recursos. Busca patrones inusuales como llamadas de red inesperadas, patrones de acceso a archivos u operaciones que no coincidan con el propósito declarado de la Skill
• Las fuentes externas son riesgosas: Las Skills que obtienen datos de URL externas representan un riesgo particular, ya que el contenido obtenido puede contener instrucciones maliciosas. Incluso las Skills confiables pueden verse comprometidas si sus dependencias externas cambian con el tiempo
• Uso indebido de herramientas: Las Skills maliciosas pueden invocar herramientas (operaciones de archivos, comandos bash, ejecución de código) de formas dañinas
• Exposición de datos: Las Skills con acceso a datos sensibles podrían estar diseñadas para filtrar información a sistemas externos
• Trátalo como instalar software: Ten especial cuidado al integrar Skills en sistemas de producción con acceso a datos sensibles u operaciones críticas

Para orientación sobre gobernanza, evaluación y despliegue a escala organizacional, consulta Skills para empresas. Las organizaciones de Claude Enterprise también pueden activar el escaneo de contenido de Skills para las Skills personalizadas subidas en claude.ai y Claude Cowork. El escaneo no cubre las Skills subidas a través de la Skills API o la Claude Console.

Skills disponibles

Agent Skills predefinidas

Las siguientes Agent Skills predefinidas están disponibles para uso inmediato:

• PowerPoint (pptx): Crea presentaciones, edita diapositivas, analiza el contenido de presentaciones
• Excel (xlsx): Crea hojas de cálculo, analiza datos, genera informes con gráficos
• Word (docx): Crea documentos, edita contenido, da formato al texto
• PDF (pdf): Genera documentos e informes PDF con formato

Estas Skills están disponibles en la API de Claude, Claude Platform on AWS, Microsoft Foundry y claude.ai. Consulta el tutorial de inicio rápido para empezar a usarlas en la API.

Skills de código abierto

Anthropic también publica Skills de código abierto en el repositorio de skills:

• Claude API skill: Proporciona a Claude material de referencia actualizado de la API, documentación de los SDK y mejores prácticas para ocho lenguajes de programación. Viene incluida con Claude Code y también está disponible para instalarse desde el repositorio de skills.

Ejemplos de Skills personalizadas

Para ejemplos completos de Skills personalizadas, consulta el Skills cookbook.

Retención de datos

Agent Skills no está cubierto por los acuerdos de ZDR. Las definiciones de Skills y los datos de ejecución se retienen de acuerdo con la política estándar de retención de datos de Anthropic.

Para conocer la elegibilidad de ZDR en todas las funciones, consulta API y retención de datos.

Para el registro de auditoría de las operaciones de la Skills API, consulta Registro de auditoría en Uso de Agent Skills con la API.

Limitaciones y restricciones

Claude Platform on AWS y Microsoft Foundry siguen las mismas limitaciones que la API de Claude en las siguientes subsecciones. Además, en Microsoft Foundry, no se admite el endpoint de descarga de versiones de Skills (GET /v1/skills/{skill_id}/versions/{version}/content).

Disponibilidad entre superficies

Las Skills personalizadas no se sincronizan entre superficies. Las Skills subidas a una superficie no están disponibles automáticamente en otras:

• Las Skills subidas a claude.ai deben subirse por separado a la API
• Las Skills subidas a través de la API no están disponibles en claude.ai
• Las Skills de Claude Code se basan en el sistema de archivos y son independientes tanto de claude.ai como de la API

Gestiona y sube las Skills por separado para cada superficie donde quieras usarlas.

Alcance de uso compartido

Las Skills tienen diferentes modelos de uso compartido según dónde las uses:

• claude.ai: Solo usuario individual. Cada miembro del equipo debe subirlas por separado.
• API de Claude: Todo el workspace. Todos los miembros del workspace pueden acceder a las Skills subidas.
• Claude Code: Personales (~/.claude/skills/) o basadas en proyecto (.claude/skills/). También se pueden compartir a través de Claude Code Plugins.

claude.ai no admite la gestión centralizada por administradores ni la distribución de Skills personalizadas en toda la organización.

Restricciones del entorno de ejecución

El entorno de ejecución exacto disponible para tu Skill depende de la superficie del producto donde la uses.

• claude.ai:
  • Acceso a la red variable: Dependiendo de la configuración del usuario/administrador, las Skills pueden tener acceso a la red completo, parcial o nulo. Para más detalles, consulta el artículo de soporte Create and Edit Files.
• API de Claude:
  • Sin acceso a la red: Las Skills no pueden hacer llamadas a API externas ni acceder a internet.
  • Sin instalación de paquetes en tiempo de ejecución: Solo están disponibles los paquetes preinstalados. No puedes instalar paquetes nuevos durante la ejecución.
  • Solo dependencias preconfiguradas: Consulta la documentación de la herramienta de ejecución de código para ver la lista de paquetes disponibles.
• Claude Code:
  • Acceso completo a la red: Las Skills tienen el mismo acceso a la red que cualquier otro programa en la computadora del usuario.
  • Se desaconseja la instalación global de paquetes: Las Skills solo deben instalar paquetes localmente para evitar interferir con la computadora del usuario.

Planifica tus Skills para que funcionen dentro de estas restricciones.

Próximos pasos