Cómo Funcionan Realmente los Agent Skills: El Sistema de Divulgación Progresiva de 30-50 Tokens

Perspectiva

Esta es la explicación oficial de Anthropic sobre cómo funcionan mecánicamente los Agent Skills - breve y práctica.

El sistema de divulgación progresiva. Al iniciar, solo se cargan el nombre y la descripción de cada skill instalado en el system prompt - aproximadamente 30-50 tokens por skill. Esto hace que Claude sea consciente de los skills sin consumir contexto. Cuando un prompt del usuario coincide con la descripción de un skill, Claude carga dinámicamente el skill.md completo. Si ese skill hace referencia a otros archivos o scripts, se cargan progresivamente según sea necesario. Resultado: puedes instalar muchos skills para tareas complejas sin saturar el contexto.

Cómo encajan los skills con otras características de Claude:

• Claude.md = contexto específico del proyecto (stack tecnológico, convenciones de código, estructura del repositorio). Vive junto a tu código. “Usamos Next.js y Tailwind.”
• Skills = experiencia portable que funciona en cualquier proyecto. Un skill de diseño front-end que enseña estándares de tipografía se activa automáticamente al construir UI.
• Servidores MCP = protocolo de integración universal que conecta Claude a fuentes externas (GitHub, Linear, Postgres). “MCP conecta a datos. Los skills enseñan a Claude qué hacer con ellos.”
• Sub-agentes = asistentes de IA especializados con roles fijos, ventanas de contexto propias, prompts personalizados. Los skills proporcionan experiencia portable que cualquier agente puede usar.

La sinergia: Claude.md establece la base → Servidores MCP conectan datos → Sub-agentes especializan → Skills aportan experiencia.

Puntos Clave

• 30-50 tokens por skill - Solo nombre/descripción cargados al inicio; contenido completo cargado cuando coincide
• Carga progresiva - skill.md cargado al coincidir; archivos/scripts referenciados se cargan según sea necesario
• Portable entre superficies - Funciona en Claude Code, API y claude.ai
• Claude.md = proyecto, skills = experiencia - Claude.md es específico del repo; skills son reutilizables entre proyectos
• MCP = datos, skills = qué hacer - MCP da acceso; skills enseñan patrones (optimización de consultas, etc.)
• Los sub-agentes pueden compartir skills - El agente de front-end y el revisor pueden usar ambos el skill de accesibilidad
• Casos de uso - Incorporación de nuevos empleados, prácticas de seguridad en PR, metodología de análisis de datos

Panorama General

Los skills usan divulgación progresiva para empaquetar cientos de capacidades en 30-50 tokens cada uno - solo cargando contenido completo cuando es necesario. Combinados con MCP para datos y Claude.md para contexto del proyecto, los skills forman la capa de experiencia que convierte agentes generales en especializados.