La eficiencia de las herramientas de IA depende del contexto que les proporcionamos. En particular, el modelo debería poder leer al menos: 1) instrucciones globales (AGENTS.md), 2) instrucciones/habilidades personalizadas (carpeta skills/), y 3) personalidades/agentes (carpeta agents/). Algunos repositorios de habilidades y agentes disponibles públicamente son excelentes; sin embargo, en el mundo de la IA, parece haber un consenso entre los usuarios de que los mejores resultados provienen de crear estos archivos manualmente con cuidado. Por lo tanto, la gestión de estos archivos a través de diferentes modelos se ha convertido en un aspecto clave para mantener un flujo de trabajo verdaderamente independiente del modelo (model-agnostic).
A pesar de la importancia de estos archivos, aún no existe un estándar unificado sobre cómo gestionarlos en las diferentes herramientas de IA. Cada herramienta (Claude Code, OpenCode, Antigravity CLI, Codex CLI, etc.) utiliza una estructura de carpetas diferente para almacenarlos. Por lo tanto, hacer un seguimiento del archivo más actualizado en cada directorio puede convertirse en una pesadilla administrativa.
La solución que he encontrado es mantener una sola copia real en una carpeta recién creada llamada ~/.agents/. Luego, estos archivos se replican en todas las herramientas de IA mediante enlaces simbólicos (symlinks). Un enlace simbólico no es una copia; es una dirección de reenvío.
~/.agents/AGENTS.mdpara mis instrucciones globales~/.agents/skills/para mis habilidades~/.agents/agents/para las definiciones de agentes
Todo lo que está bajo ~/.claude, ~/.gemini, ~/.codex y ~/.config/opencode es solo una señal que apunta de vuelta a ellos. Cuando una herramienta abre ~/.claude/CLAUDE.md, está leyendo exactamente los mismos bytes que ~/.agents/AGENTS.md.
Edita el original, y todos se actualizarán a la vez porque solo existe una única fuente de verdad.
Todo el proceso es una configuración que se hace una sola vez. Crea los directorios centrales, escribe tu AGENTS.md a mano y luego enlázalos usando comandos ln -s. Aquí tienes un ejemplo:
# Crea la carpeta unificadora/central
mkdir -p ~/.agents
# Diseña tus instrucciones globales a mano
nano ~/.agents/AGENTS.md
# Vincula el archivo de configuración que usa la herramienta a tu archivo central
ln -s ~/.agents/AGENTS.md ~/.claude/CLAUDE.mdAplica esta lógica a tus directorios skills/ y agents/. Ese es todo el sistema. Cada herramienta lee lo mismo. Cuando agregues una nueva herramienta, busca las rutas que lee, enlázalas con ln -s a su origen, y listo.
A continuación se muestra una tabla de las rutas de configuración nativas para mis herramientas más utilizadas y cómo este sistema las vincula con la carpeta central.
| Herramienta | 🧠 Ruta de Configuración Nativa | 🍳 Origen Central | 📋 Ruta de Habilidades | 📄 Tipo de Enlace | |||
|---|---|---|---|---|---|---|---|
| Claude Code | ~/.claude/CLAUDE.md | → | ~/.agents/AGENTS.md | → | ~/.claude/skills/ | → | enlace simbólico |
| Codex CLI | ~/.codex/AGENTS.md | → | ~/.agents/AGENTS.md | → | — | → | enlace simbólico |
| Antigravity CLI | ~/.gemini/GEMINI.md | → | ~/.agents/AGENTS.md | → | ~/.gemini/antigravity-cli/skills/ | → | enlace simbólico |
| OpenCode | ~/.config/opencode/AGENTS.md | → | ~/.agents/AGENTS.md | → | ~/.agents/skills/ | → | nativo |
* OpenCode lee ~/.agents/skills/ de forma nativa — no crees un enlace simbólico para su carpeta de habilidades o se leerá doble.
* Gemini CLI fue descontinuado el 18 de junio de 2026; su reemplazo es Antigravity CLI, que conservó la carpeta de configuración ~/.gemini/.
Si conectas alguna herramienta que no haya cubierto — o encuentras un truco más limpio — escríbeme a patricio@pperezh.com.