# ¿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.

Fuente: https://skillsagentes.com/glosario/carpeta-references
Markdown: https://skillsagentes.com/glosario/carpeta-references.md

Área: Anatomía de una skill. Publicado el 2026-09-14. Última revisión: 2026-09-14. También: references, Carpeta de referencias.

---

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.

## 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

- [Carga progresiva](https://skillsagentes.com/glosario/carga-progresiva.md) — ¿Qué es la carga progresiva en una skill?
- [SKILL.md](https://skillsagentes.com/glosario/skill-md.md) — ¿Qué es un archivo SKILL.md?
- [scripts/](https://skillsagentes.com/glosario/carpeta-scripts.md) — ¿Qué es la carpeta scripts de una skill?
- [Ventana de contexto](https://skillsagentes.com/glosario/ventana-de-contexto.md) — ¿Qué es la ventana de contexto?

## Fuentes

- [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) — Anthropic. Comprobado el 2026-09-14.
- [Equipping agents for the real world with Agent Skills](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) — Anthropic Engineering. Comprobado el 2026-09-14.
- [anthropics/skills](https://github.com/anthropics/skills) — Anthropic. Comprobado el 2026-09-14.

---

[Glosario completo](https://skillsagentes.com/glosario.md) · [Guía de Claude Skills](https://skillsagentes.com/claude-skills.md) · [Todas las skills](https://skillsagentes.com/skills.md)

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)