¿Qué es la carpeta references de una skill?
references/ es la carpeta opcional donde una skill guarda la documentación que el agente abre solo si el procedimiento lo pide: tablas, especificaciones, ejemplos largos y formatos de salida. Es el tercer nivel de la carga progresiva.
- Última revisión
También: references · Carpeta de referencias
En corto
- Lo que está en `references/` no se carga al activar la skill, solo cuando el paso que lo menciona se ejecuta.
- Es donde va todo lo que es largo y consultable en vez de secuencial.
- Cada archivo debe estar mencionado desde el paso que lo necesita; un archivo que nadie referencia no se abre nunca.
Qué mover ahí
La prueba práctica: si el contenido se lee de principio a fin cada vez, es procedimiento y va en el cuerpo. Si se consulta buscando una entrada concreta — un listado de campos, una tabla de equivalencias, una guía de estilo, una especificación —, es referencia y va en un archivo aparte.
El coste de equivocarse solo se nota en sesiones largas, que es lo que lo hace fácil de ignorar: una skill con todo en el cuerpo funciona bien en la primera prueba y empieza a desplazar contexto útil a partir de la tercera activación.
Términos relacionados
Fuentes
- Agent Skills — Anthropic. Comprobado el .
- Equipping agents for the real world with Agent Skills — Anthropic Engineering. Comprobado el .
- anthropics/skills — Anthropic. Comprobado el .