Documentación

¿Qué son las Claude Agent Skills?

Una Claude Agent Skill es un archivo SKILL.md que enseña a Claude conocimiento de dominio, convenciones, flujos de trabajo y buenas prácticas — todo en texto plano.

Cómo funcionan las Skills

  1. 1 Coloca un archivo SKILL.md en tu proyecto (o en el directorio ~/.claude/skills/).
  2. 2 Claude lo lee al inicio de cada sesión — absorbiendo el conocimiento sin necesidad de prompts repetidos.
  3. 3 Las Skills usan carga diferida: Claude primero ve solo el nombre y la descripción, y lee el archivo completo solo cuando es relevante — ahorrando tokens.

Ejemplos

  • Una skill de Laravel que conoce la arquitectura, convenciones de nombres y patrones comunes de tu app.
  • Una skill de auditoría de seguridad con listas de verificación OWASP y procedimientos de revisión de código.
  • Una skill de guía de marca para que Claude siempre escriba con la voz de tu empresa.

Carga diferida

Las Skills son eficientes en tokens. Claude primero solo ve el nombre y una descripción de una línea. Solo lee el SKILL.md completo cuando la tarea actual es relevante — así puedes tener muchas Skills instaladas sin sobrecargar el contexto.

Skills vs herramientas MCP

Las Skills y las herramientas MCP (Model Context Protocol) son complementarias — resuelven problemas diferentes.

Skills

  • Proporcionan conocimiento, experiencia y flujos de trabajo
  • Texto plano — sin ejecución de código
  • Funcionan en web, escritorio y CLI
  • Ideal para: convenciones, conocimiento de dominio, estilo de escritura

Herramientas MCP

  • Conectan con APIs, bases de datos y herramientas externas
  • Ejecutan código y realizan llamadas de red
  • Requieren escritorio o CLI (no web)
  • Ideal para: datos en tiempo real, operaciones de archivos, integraciones