Tu primer agente de IA vive en una carpeta

Del chat al agente

Qué vas a construir y por qué vale la pena. Todavía no hay que instalar nada.

Cuando usas ChatGPT, Claude o Gemini en el navegador, pasan tres cosas:

• Cada conversación empieza casi de cero. Algunas apps recuerdan un poco, pero no decides tú qué. Le vuelves a explicar quién eres y qué quieres.
• Tú haces de cartero. Copias un texto de tus archivos, lo pegas en el chat, copias la respuesta y la pegas en otro sitio.
• No puede tocar tus archivos. No puede abrir tus apuntes, ni apuntar tu entreno en una tabla, ni guardar un PDF en tu ordenador.

Un agente resuelve las tres. Es un modelo de IA (el "cerebro" que entiende y escribe texto) que, además de hablar, puede actuar: leer archivos, escribirlos y seguir varios pasos solo. Para actuar necesita una app en tu ordenador que le dé esas manos, y una carpeta donde trabajar.

La trampa del chat eterno

Como cada chat nuevo empieza casi de cero, mucha gente hace lo lógico: abre un chat para una cosa (las clases, la dieta, la obra) y lo usa durante semanas. Así no tiene que volver a explicarlo todo. Pero eso crea otro problema, y casi nadie lo ve.

Todo lo que el modelo lee para responder se llama el contexto: sus reglas, la conversación entera y tu mensaje nuevo. El contexto tiene un tamaño máximo. Cuando un chat eterno lo llena, la app tiene que hacer sitio: según la app, compacta los mensajes antiguos en un resumen o deja de leerlos. No te avisa, y por el camino se pierden detalles.

Y aunque todo quepa, un contexto enorme funciona peor. Piénsalo así: si te doy una página y te pregunto algo sobre ella, aciertas casi seguro. Si te doy la Biblia entera y te pregunto lo mismo, es mucho más fácil que se te escape algo. A un modelo le pasa igual: cuanto más largo es el contexto, más le cuesta tener en cuenta cada cosa.

Un agente con carpeta lo resuelve, porque lo importante vive en archivos, no en el chat. Así puedes abrir un chat nuevo para cada tarea, con el contexto limpio, y el agente lee solo los archivos que esa tarea necesita.

Y además, un agente puede…

Más allá de recordar, trabajar en una carpeta abre cosas que un chat no hace:

• Crear archivos de verdad en tu ordenador. Una página para imprimir, una tabla para Excel y, si tu app sabe, un PDF o un Word, guardados directamente en tu carpeta.
• Trabajar con muchos archivos. En un chat adjuntas unos pocos. En una carpeta puedes tener cientos o miles: 300 facturas escaneadas, por ejemplo. El agente las abre una a una y te deja una tabla con el total de cada mes. Tardará y gastará uso, pero no hay un límite de archivos que subir.
• Usar programas de tu ordenador, con tu permiso: ordenar fotos, convertir documentos o hacer cuentas exactas con un script.
• Dejar rastro. Todo lo que hace queda en archivos que puedes revisar, corregir o borrar.

Así que el agente que vas a crear tiene tres piezas:

• El modelo, el cerebro. Lo pone una empresa (Anthropic, OpenAI, Google) o un proyecto abierto. Casi siempre no vive en tu ordenador: está en internet.
• La app, las manos. Un programa de escritorio que conecta el modelo con tu ordenador. Le deja leer y escribir archivos, y te pide permiso antes.
• La carpeta, la casa y la memoria. Dentro van sus instrucciones, lo que debe recordar y lo que te entrega. Es tuya y la puedes abrir siempre.

Elige tu ejemplo

La guía es igual para todos. Solo cambia lo que el agente sabe hacer. Elige el ejemplo que más se parezca a lo tuyo; luego lo puedes adaptar a cualquier cosa.

• EstudianteUn tutor que te hace preguntas de examen, recuerda lo que ya dominas y lleva tus entregas.
• DocenteUn ayudante que prepara fichas y lleva cómo va cada grupo de clase.
• Salud y deporteUn entrenador que apunta entrenos y comidas y te dice cómo vas hacia tu objetivo.
• DiarioUn diario que guarda cada día y te ayuda a ver qué se repite.
• Reforma en casaUn jefe de obra para tu baño o tu cocina: pasos, contactos y presupuesto.

Sin JavaScript verás los cinco ejemplos en cada paso, cada uno con su nombre. Sigue solo el tuyo.

Paso 1 de 8

Elige tu app

Eliges e instalas el programa que conectará el modelo con tu carpeta.

Aquí lo llamo simplemente "la app". Si lo lees por ahí, su nombre técnico es harness (en inglés, "arnés"): lo que envuelve al modelo y le da herramientas.

Necesitas un ordenador (Windows, Mac o Linux), no el móvil: el agente trabaja con los archivos de tu ordenador.

Cada app funciona con unas cuentas y no con otras. Así que la mejor app para ti depende de lo que ya pagas. Marca lo que tengas:

Esta tabla resume la recomendación:

Paso 2 de 8

Crea la carpeta

Creas la casa del agente.

Una carpeta es un contenedor de tu ordenador que guarda archivos. Un archivo es un documento con un nombre, y su final (.md, .csv, .pdf) dice qué tipo de contenido guarda.

El agente solo ve lo que hay dentro de su carpeta. Eso es bueno: tú decides qué sabe y qué no. Pero recuerda que lo que lea lo manda al modelo, en internet, para poder responder. No metas en la carpeta nada que no contarías a esa empresa.

1. Crea una carpeta en el Escritorio (o en Documentos, si prefieres). En Mac: clic derecho en el Escritorio, "Nueva carpeta". En Windows: clic derecho, "Nuevo", "Carpeta".
2. Ponle un nombre sin espacios ni tildes, por ejemplo: Estudiante mi-tutor-de-estudio Docente mi-ayudante-de-clase Salud mi-entrenador Diario mi-diario Reforma reforma-del-bano . Los nombres sencillos evitan problemas con algunas apps.
3. Dentro, crea dos carpetas: datos y exportaciones. El resto lo creará el agente más adelante.

Cuando termines la guía, la carpeta tendrá estas partes. Cada una tiene un color, el mismo en toda la página. Toca una parte para ver para qué sirve y quién la lee.

¿Sabías que…? Si copias la carpeta a otro ordenador, el agente viaja con ella: sus instrucciones y su memoria van dentro. Y si prefieres partir de uno hecho, descarga tu ejemplo y sigue leyendo para entender cada parte.

Paso 3 de 8

Abre la carpeta en tu app y saluda

Conectas la app con la carpeta y compruebas que el agente la ve.

A partir de aquí, casi todo lo hará el agente: tú le dices qué quieres y él crea los archivos.

Ahora escribe tu primer mensaje:

Hola. ¿Qué hay en esta carpeta?

Verás algo así. El agente usa sus herramientas (leer, escribir, buscar) y te enseña cada paso:

El robot es el agente; la persona de la derecha eres tú.

Cada app tiene un modo de permisos: decide qué hace el agente solo y qué te pregunta antes. Al principio, elige el modo más prudente de tu app (el que te indico arriba). Algunos te preguntan antes de cada cambio; otros cambian archivos dentro de tu carpeta sin preguntar, pero te piden permiso antes de salir de ella, de usar internet o de ejecutar programas. Cuando te pida permiso, lee qué quiere hacer y acepta si tiene sentido. Por ejemplo, si te pregunta si puede crear el archivo que le acabas de pedir, acepta. Cuando te fíes, podrás darle más libertad dentro de esa carpeta.

Si no ve la carpeta, revisa que elegiste la carpeta correcta y no el Escritorio entero. En Mac, la primera vez el sistema pregunta si la app puede acceder al Escritorio: pulsa "Permitir". Si dijiste que no, ve a "Ajustes del Sistema", "Privacidad y seguridad", "Archivos y carpetas", y activa tu app.

Paso 4 de 8

Dale instrucciones: el archivo AGENTS.md

Le dices al agente quién es y cómo tiene que trabajar, una sola vez y para siempre.

Eso va en un archivo llamado AGENTS.md, en la raíz de la carpeta (dentro de ella, no en una subcarpeta).

Recuerda el contexto, del principio: el modelo no recuerda nada entre mensajes. Cada vez que escribes, la app le manda de golpe todo lo que debe tener en cuenta. Esto es lo que entra:

(Las skills son recetas para tareas que repites; las verás en el paso 6.) Por eso AGENTS.md es tan potente: entra en el contexto de todas las conversaciones. Lo que escribas ahí, el agente lo tiene presente siempre. Y es un estándar abierto: lo leen Claude, ChatGPT (Codex), Antigravity, Goose y muchas otras apps. Así no dependes de ninguna.

Tu AGENTS.md

Este es el AGENTS.md de tu ejemplo. Léelo: verás que dice quién es el agente, qué hace, dónde guarda cada cosa y unas reglas. Cambia los datos que son tuyos (tu curso, tus grupos, tu objetivo) y deja la estructura.

# Mi tutor de estudio

Eres mi tutor personal. Estudio 2.º de Bachillerato.
Me hablas en español, con frases cortas y ejemplos.

## Qué haces
- Me explicas los temas de forma sencilla, con ejemplos.
- Cuando te lo pido, me haces preguntas tipo examen, una a una, y me corriges.
- Llevas la cuenta de lo que ya domino y de lo que me cuesta.
- Me recuerdas las entregas pendientes.

## Dónde guardas las cosas
- datos/asignaturas.md: mis asignaturas, sus temas y las fechas de examen.
- datos/progreso.md: una tabla con cada tema, su estado (nuevo, en curso, dominado), la fecha del último repaso y lo que me cuesta.
- datos/entregas.md: cada entrega con su fecha y su estado.
- datos/apuntes/: mis apuntes, un archivo por tema.
- exportaciones/: los exámenes de práctica y los resúmenes.

## Reglas
- Antes de responder, lee lo que haga falta de datos/.
- Al final de cada sesión de estudio, actualiza datos/progreso.md.
- Si algo no está en mis apuntes, dímelo. No te lo inventes.
- Para preparar un examen de práctica, usa la skill preparar-examen.

# Mi ayudante de clase

Eres mi ayudante de clase. Doy Matemáticas en 4.º de primaria, a dos grupos: 4.º A y 4.º B.
Me hablas en español, de forma clara y práctica.

## Qué haces
- Preparas fichas de ejercicios adaptadas al nivel de cada grupo.
- Llevas cómo va cada grupo: qué temas hemos visto y qué cuesta más.
- Me ayudas a planificar la semana.

## Dónde guardas las cosas
- datos/grupos.md: cada grupo, el tema actual y lo que más le cuesta.
- datos/notas.csv: las notas, con las columnas alumno,grupo,actividad,fecha,nota. Una fila por alumno y actividad.
- datos/calendario.md: las sesiones y las evaluaciones previstas.
- exportaciones/: las fichas y los planes, listos para imprimir.

## Reglas
- Nunca guardes nombres completos de alumnos. Usa su número de lista (A01, A02…).
- Las fichas llevan las soluciones en una página aparte.
- Antes de preparar algo, mira datos/grupos.md.
- Para preparar una ficha, usa la skill preparar-ficha.

# Mi entrenador

Eres mi entrenador personal. Mi objetivo está en datos/objetivo.md.
Me hablas en español, con ánimo pero sin exagerar.

## Qué haces
- Apuntas cada entreno y cada comida que te cuento.
- Me propones entrenos según mi rutina y cómo voy.
- Cada semana me dices cómo voy hacia mi objetivo, con números.

## Dónde guardas las cosas
- datos/objetivo.md: mi objetivo, mi punto de partida y la fecha límite.
- datos/registro.csv: una fila por dato, con las columnas fecha,tipo,detalle,cantidad,unidad. Por ejemplo: 2026-10-20,carrera,suave,5,km. El tipo es carrera, gimnasio o comida. Una carrera son dos filas, una en km y otra en min. El gimnasio va en min y las comidas en kcal.
- datos/rutina.md: mi rutina semanal.
- exportaciones/: los resúmenes semanales.

## Reglas
- Apunta en datos/registro.csv en cuanto te cuente algo. No esperes al final.
- Si te pregunto algo médico, o te cuento un dolor que no se va, dime que lo consulte con un profesional.
- Para el resumen de la semana, usa la skill resumen-semanal.

# Mi diario

Eres mi diario personal. Te cuento cómo me ha ido el día y tú lo ordenas.
Me hablas en español, con calma. No juzgas: escuchas y ordenas.

## Qué haces
- Guardas lo que te cuento cada día, con mis palabras.
- Me haces una o dos preguntas si quiero profundizar, nunca más.
- Cuando te lo pido, me ayudas a ver qué se repite: personas, temas, estados de ánimo.

## Dónde guardas las cosas
- datos/entradas/: un archivo por día, con la fecha como nombre (2026-10-25.md).
- datos/temas.md: los temas y las personas que salen a menudo.
- exportaciones/: los resúmenes que te pida.

## Reglas
- Cada entrada empieza con dos líneas: la fecha (# 2026-10-25) y el ánimo en una palabra (Ánimo: tranquilo).
- No cambies lo que escribí: si lo resumes, guarda el resumen aparte.
- Para cerrar el día, usa la skill cerrar-el-dia.

# Reforma del baño

Eres el jefe de obra de la reforma de mi baño. Yo no sé de obras: explícamelo todo.
Me hablas en español, de forma clara y ordenada.

## Qué haces
- Llevas la lista de pasos de la reforma y su estado.
- Guardas los contactos de los profesionales y lo que hemos hablado con cada uno.
- Llevas el presupuesto: lo previsto y lo gastado.
- Me avisas de lo que bloquea el siguiente paso.

## Dónde guardas las cosas
- datos/pasos.md: cada paso en orden, con su estado (pendiente, en curso, hecho) y de qué depende.
- datos/contactos.md: cada profesional, su teléfono y un resumen de cada conversación.
- datos/medidas.md: las medidas del baño que yo te dé.
- datos/presupuesto.csv: una fila por partida, con las columnas partida,previsto,gastado.
- datos/ideas/: fotos y notas de ideas para el diseño.
- exportaciones/: listas para llevar a la tienda, resúmenes, planos sencillos.

## Reglas
- Antes de responder, mira datos/pasos.md.
- No des por buena una medida que no te haya dado yo.
- Para preparar una llamada con un profesional, usa la skill preparar-llamada.

Para crearlo, lo más fácil es pedírselo al agente. Pulsa "Copiar" en el texto de arriba. Luego escribe este mensaje y, debajo, pega el texto con Ctrl + V (Cmd + V en Mac):

Crea un archivo AGENTS.md en esta carpeta con este contenido:

(pega aquí el texto)

Si lo creas a mano en Windows, vigila que no acabe en .txt: Windows esconde el final de los nombres y el agente no lo encontraría. Más abajo, en "Prefiero crearlo a mano", tienes cómo evitarlo.

Ahora empieza una conversación nueva, porque el AGENTS.md se lee al empezar. Pregunta:

¿Quién eres y qué sabes hacer?

Si te contesta con lo que pusiste en el AGENTS.md, funciona.

Paso 5 de 8

Dale memoria: la carpeta datos

Creas los archivos donde el agente guarda lo que debe recordar.

Es lo que convierte un chat que olvida en un agente que te conoce.

Tu AGENTS.md ya dice qué archivos usar y cuándo actualizarlos. Así que solo tienes que pedírselo:

Crea los archivos de datos que dice el AGENTS.md. Para rellenarlos, hazme las preguntas que necesites, una a una.

El agente te hará preguntas y creará los archivos. En tu ejemplo:

Abre los archivos tú también. Un .md se abre con cualquier editor de texto (TextEdit, el Bloc de notas); un .csv, con Excel o Google Sheets. Son tuyos: si algo está mal, corrígelo a mano o díselo al agente. Y si un día quieres empezar de cero, bórralos.

¿Por qué no basta con la memoria de ChatGPT? La memoria de ChatGPT es una lista corta de notas que guarda la app, y solo sirve en esa app. Tus archivos los lees enteros, los corriges y los llevas a cualquier app.

Paso 6 de 8

Enséñale recetas: las skills

Le enseñas al agente una tarea que repites, paso a paso, para que la haga siempre igual de bien.

Eso es una skill (en inglés, "habilidad"): una receta.

Podrías poner todos los pasos en el AGENTS.md, pero ocuparían el contexto de todas las conversaciones, también las que no los necesitan. Una skill es más lista: el agente solo ve su nombre y una frase que la describe. Cuando le pides algo que encaja con esa frase, abre la receta entera y la sigue.

Una skill es una carpeta con un archivo SKILL.md dentro. La carpeta se llama igual que la skill. Ese archivo empieza con un bloque entre dos líneas --- con el nombre y la descripción, y luego van los pasos. Las skills de la carpeta del agente van aquí:

En Mac, el punto del principio esconde la carpeta. El Finder no muestra las carpetas cuyo nombre empieza por un punto, y no te deja crearlas. Para verlas, pulsa Cmd + Mayús + . en el Finder. En Windows se ven normalmente. Lo más fácil, en los dos: deja que la cree el agente.

Esta es la skill de tu ejemplo:

---
name: preparar-examen
description: Prepara un examen de práctica de los temas que te pida, con preguntas como las de clase. Úsala cuando quiera practicar para un examen.
---

# Preparar un examen de práctica

1. Pregúntame qué asignatura y qué temas entran, si no lo he dicho.
2. Lee mis apuntes de esos temas en datos/apuntes/ y su estado en datos/progreso.md.
3. Escribe 10 preguntas: 4 de los temas que me cuestan más y 6 del resto. Mezcla preguntas cortas y de desarrollo.
4. Guarda el examen en exportaciones/examen-ASIGNATURA-FECHA.md, con las soluciones al final.
5. Pregúntame si lo quiero hacer ahora contigo, pregunta a pregunta.
6. Al acabar, actualiza datos/progreso.md con lo que he acertado y fallado.

---
name: preparar-ficha
description: Prepara una ficha de ejercicios para un grupo y un tema, lista para imprimir. Úsala cuando pida una ficha o ejercicios para clase.
---

# Preparar una ficha

1. Pregúntame el grupo y el tema, si no lo he dicho.
2. Lee datos/grupos.md para saber el nivel del grupo y lo que más le cuesta.
3. Escribe 8 ejercicios, de más fácil a más difícil. Los dos primeros, con un ejemplo resuelto.
4. Guarda la ficha en exportaciones/ficha-GRUPO-TEMA.html, sin espacios ni tildes en el nombre (por ejemplo ficha-4B-fracciones.html), con letra grande y espacio para responder, y las soluciones en una página aparte.
5. Dime cómo imprimirla: ábrela en el navegador y usa Imprimir.

---
name: resumen-semanal
description: Hace el resumen de la semana de entrenos y comidas y lo compara con el objetivo. Úsala cuando pida el resumen o pregunte cómo voy.
---

# Resumen de la semana

1. Lee datos/registro.csv y quédate con los últimos 7 días.
2. Si existe scripts/resumen.py, ejecútalo para tener los totales. Si no, súmalos tú con cuidado.
3. Compara con datos/objetivo.md: ¿voy al ritmo que toca?
4. Escribe el resumen en exportaciones/resumen-FECHA.md: totales, lo que ha ido bien y una sola cosa para mejorar.
5. Dime el resumen en tres frases.

---
name: cerrar-el-dia
description: Guarda la entrada del día a partir de lo que te cuente. Úsala cuando diga que quiero cerrar el día o escribir en el diario.
---

# Cerrar el día

1. Si no te he contado el día, pregúntame: "¿Cómo ha ido hoy?".
2. Escucha. Hazme como mucho dos preguntas para entenderlo mejor.
3. Guarda la entrada en datos/entradas/FECHA.md con el formato que dice el AGENTS.md: la fecha, el ánimo y lo que conté, con mis palabras.
4. Si sale una persona o un tema que ya está en datos/temas.md, súmale una mención. Si es nuevo y lo he nombrado dos veces, añádelo.
5. Despídete con una frase corta.

---
name: preparar-llamada
description: Prepara una llamada o una visita con un profesional de la obra, con lo que hay que preguntar y decidir. Úsala cuando vaya a hablar con un fontanero, un albañil, un electricista o una tienda.
---

# Preparar una llamada

1. Pregúntame con quién voy a hablar, si no lo he dicho.
2. Lee datos/pasos.md, datos/contactos.md y datos/presupuesto.csv.
3. Escribe una lista corta: lo que tengo que contarle, lo que tengo que preguntarle y lo que tenemos que decidir.
4. Guárdala en exportaciones/llamada-PROFESIONAL-FECHA.md.
5. Después de la llamada, pregúntame qué se habló y actualiza datos/contactos.md y datos/pasos.md.

Para crearla, pídeselo al agente con el texto pegado:

Crea una skill con este SKILL.md, en la carpeta de skills que usa esta app:

(pega aquí el texto)

Después, en una conversación nueva, pídele algo que encaje con la descripción. Verás que abre la skill y sigue sus pasos:

Prepárame un examen del tema 3.

Prepárame una ficha de multiplicaciones para 4.º A.

¿Cómo voy esta semana?

Quiero cerrar el día.

Mañana llamo a la fontanera. Prepárame la llamada.

Paso 7 de 8 · opcional

Herramientas fijas: la carpeta scripts

Le das al agente una herramienta que da siempre el mismo resultado. Puedes saltarte este paso.

Es útil para cuentas, sumas y fechas.

Un modelo escribe muy bien, pero calcula como una persona con prisa: casi siempre bien, a veces mal. Un script es un programa pequeño que hace una cuenta exacta, igual cada vez. No lo tienes que escribir ni ejecutar tú: lo hace el agente.

Escribe un script en scripts/que-repasar.py que lea la tabla de datos/progreso.md y me diga qué temas hace más de 7 días que no repaso, del más antiguo al más reciente. Añade al AGENTS.md, en Reglas, que lo uses cuando te pregunte qué me toca repasar.

Escribe un script en scripts/medias.py que lea datos/notas.csv y calcule la media de cada grupo y de cada actividad. Añade al AGENTS.md, en Reglas, que lo uses cuando te pida medias o un resumen de notas.

Escribe un script en scripts/resumen.py que lea datos/registro.csv y sume los minutos de entreno y los kilómetros de los últimos 7 días, contando hacia atrás desde la fecha más reciente del registro. Añade al AGENTS.md, en Reglas, que lo uses para los resúmenes.

Escribe un script en scripts/animo.py que lea las entradas de datos/entradas/ y cuente cuántos días hubo de cada ánimo en cada mes, a partir de la línea "Ánimo:". Añade al AGENTS.md, en Reglas, que lo uses cuando te pregunte cómo he estado.

Escribe un script en scripts/presupuesto.py que lea datos/presupuesto.csv y diga el total previsto, el total gastado y las partidas que se pasan de lo previsto. Añade al AGENTS.md, en Reglas, que lo uses cuando te pregunte por el dinero.

No necesitas saber programar. Si el agente te pide instalar algo (como Python, el lenguaje de estos scripts) y no quieres, dile que no y sáltate este paso; en un ordenador del trabajo, quizá no te dejen. En Mac puede salir una ventana que ofrece instalar las "herramientas de desarrollo de línea de comandos": también puedes decir que no. El agente sigue funcionando: hará las cuentas él mismo, con cuidado.

Paso 8 de 8

Los resultados: la carpeta exportaciones

Le pides al agente algo terminado, para usar fuera de la conversación.

Lo guardará en exportaciones, y así siempre sabes dónde buscarlo.

Hazme un resumen de una página del tema que más me cuesta, para repasar en el bus.

Prepárame una ficha de fracciones para 4.º B.

Hazme el resumen de esta semana.

Hazme un resumen de este mes: lo mejor, lo peor y lo que se repite.

Hazme la lista de materiales para la tienda de baños, con las medidas de datos/medidas.md.

¿Qué formato pedir?

• Markdown (.md) para leerlo tú o dárselo a otro agente.
• Una página HTML (.html) para algo bonito: se abre en el navegador y se imprime desde ahí.
• CSV (.csv) para abrir en Excel o en Google Sheets. Si Excel lo pone todo en una columna, usa "Datos", "Desde texto o CSV" y elige la coma como separador.
• PDF o Word si tu app los sabe crear. Pregúntale: "¿Puedes crear un PDF?".

Comprueba tu agente

Revisa que tu carpeta tiene todo en su sitio, cuando acabes o cuando algo no funcione.

También puedes revisarlo a mano, o pedírselo al agente: "Revisa que la carpeta cumple esta lista".

• Hay un archivo AGENTS.md en la raíz, con ese nombre exacto.
• La carpeta datos tiene los archivos que nombra el AGENTS.md.
• La carpeta de skills de tu app tiene una carpeta por skill, cada una con su SKILL.md. En Mac, pulsa Cmd + Mayús + . para verla.
• La carpeta exportaciones existe. La carpeta scripts es opcional.
• En una conversación nueva, el agente sabe quién es sin que se lo expliques.

Adáptalo a lo tuyo

Crea un agente para algo que no está en los cinco ejemplos: tu trabajo, una afición, un proyecto.

Los pasos son los mismos; solo cambia el AGENTS.md.

Lo más fácil es que el agente te entreviste. En una carpeta nueva, ábrelo y escribe:

Quiero un agente que me ayude con (tu tarea). Hazme preguntas, una a una, sobre lo que hago y lo que necesito. Cuando tengas suficiente, escribe un AGENTS.md con esta plantilla y crea las carpetas que nombre.

Y pega debajo esta plantilla:

# (El nombre de tu agente)

Eres (quién es: mi ayudante de…, mi tutor de…).
Me hablas en (idioma), (con qué tono).

## Qué haces
- (Las tres o cuatro tareas que más le vas a pedir.)

## Dónde guardas las cosas
- datos/(archivo).md: (qué guarda).
- exportaciones/: (qué me entregas).

## Reglas
- (Lo que siempre debe hacer.)
- (Lo que nunca debe hacer.)

Algunas ideas, para inspirarte:

• Recursos humanos: los procesos de selección abiertos, sus fases y las preguntas de cada entrevista, con los candidatos por código, nunca por nombre.
• Investigación: el registro de muestras de campo en un CSV, y una skill que prepara el informe de cada salida.
• Una afición: tu huerto, tus recetas o tus viajes, con lo que funcionó y lo que no.

Úsalo cada día

Las costumbres que hacen que el agente mejore con el uso.

• Una conversación por tarea. Cuando acabes algo, empieza una nueva. La memoria está en los archivos, no en el chat, así que no pierdes nada, y el contexto queda limpio.
• Corrige en el archivo, no en el chat. Si hace algo mal, pídele que añada una regla al AGENTS.md o que mejore la skill.
• Pregúntale qué apuntar. Al final de una sesión: "¿Hay algo de hoy que debas guardar en datos?".
• Mira sus archivos de vez en cuando. Son tu agente. Cuanto mejor estén, mejor trabaja.
• Crece poco a poco. Cuando repitas una tarea tres veces, conviértela en una skill.

Límites y avisos

Lo que este agente no hace, y lo que conviene saber antes de confiarle cosas.

• Lo que hay en la carpeta viaja al modelo. Para responder, la app manda partes de tus archivos a la empresa del modelo. No guardes ahí contraseñas, ni datos de otras personas que no te hayan dado permiso.
• Si es para el trabajo, pregunta antes. Mira si tu empresa tiene normas sobre IA y una cuenta de empresa (por ejemplo Claude Team o ChatGPT Business). No guardes datos de compañeros con su nombre: usa códigos, como hace el ejemplo de docente.
• Se equivoca. Revisa lo importante: un dato de salud, una medida de obra, una nota de un alumno.
• Las apps tienen límites de uso. Con un plan gratuito o barato, puedes llegar al límite en un día de mucho uso. Espera unas horas o cambia de app: la carpeta sirve en todas. Si pasas a Claude, o vienes de Claude, pide al agente que copie las skills a la carpeta que usa la nueva app.
• Haz copias. Si la carpeta está en Google Drive, OneDrive o Dropbox, tienes copia y la puedes abrir en otro ordenador. Eso también sube tus datos a ese servicio, y en Mac el Escritorio puede estar sincronizado con iCloud sin que lo sepas. Si sabes usar Git, todavía mejor: guarda cada cambio.
• En dos ordenadores, uno cada vez. La carpeta viaja, pero las conversaciones y los ajustes de la app se quedan en cada ordenador. Añade la carpeta en la app de cada uno, trabaja en uno solo cada vez y espera a que termine de sincronizar. Si aparece un archivo "en conflicto", pide al agente que junte los dos.

¿Y desde el móvil? Tu agente vive en tu ordenador, así que el móvil no lo ve. Hay apaños: si dejas el ordenador encendido con la app abierta, Claude y Antigravity (con su "Remote Control") y ChatGPT (con Codex en la app del móvil, en iPhone o Android) te dejan seguir la conversación desde el móvil. Goose, no. Y si la carpeta está en Google Drive, la puedes abrir en otro ordenador. Pero el sitio natural de este agente es el ordenador.

Descarga los ejemplos

Si quieres ver cómo queda la carpeta al final, o empezar desde una ya hecha, descarga tu ejemplo. Cada uno es un archivo .zip. En Mac, haz doble clic para descomprimirlo; en Windows, clic derecho y "Extraer todo"; dentro quedará otra carpeta con el mismo nombre: usa esa, la que tiene el AGENTS.md. Mueve la carpeta donde quieras y ábrela con tu app (paso 3). Cada uno trae unos pocos datos de muestra, una skill, un script y un resultado; borra los datos de muestra y pon los tuyos. En Mac no verás las carpetas que empiezan por un punto (las skills) hasta que pulses Cmd + Mayús + ..

• Estudiantemi-tutor-de-estudio
• Docentemi-ayudante-de-clase
• Saludmi-entrenador
• Diariomi-diario
• Reformareforma-del-bano

Los ejemplos traen las skills en las dos carpetas, .agents/skills/ y .claude/skills/, para que funcionen en cualquier app. En tu carpeta solo necesitas la de tu app.

Glosario

Las palabras clave de la guía, en una frase cada una. En el texto, pasa el ratón por una palabra en negrita, o tócala en el móvil, para ver su definición.

Modelo (LLM)

El cerebro: un programa entrenado con muchísimo texto que entiende y escribe. Por ejemplo Claude, GPT o Gemini. LLM son las siglas en inglés de "modelo de lenguaje grande".

App o harness

El programa de escritorio que conecta el modelo con tu ordenador: le da herramientas y le pasa tus instrucciones. Por ejemplo Claude, ChatGPT en modo Codex, Antigravity o Goose.

Agente

Un modelo que, gracias a la app, puede actuar por sí mismo en varios pasos: leer, decidir, escribir y comprobar.

Carpeta

Un contenedor de tu ordenador que guarda archivos. La del agente es su casa: solo ve lo que hay dentro.

Archivo

Un documento con un nombre. Su final (.md, .csv, .json) dice qué tipo de contenido guarda.

AGENTS.md

Un archivo de texto con las instrucciones del agente, en la raíz de su carpeta. Es un estándar abierto que leen casi todas las apps.

Contexto

Todo lo que el modelo lee antes de responder: las reglas de la app, el AGENTS.md, el nombre y la descripción de las skills, la conversación y tu mensaje. Lo que no está en el contexto, el modelo no lo sabe. Cuanto más largo es, más le cuesta tener en cuenta cada cosa.

Compactar

Lo que hace la app cuando una conversación ya no cabe en el contexto: resume o deja de leer los mensajes antiguos para hacer sitio. Por el camino se pierden detalles.

Skill

Una receta para una tarea que repites: una carpeta con un archivo SKILL.md (nombre, descripción y pasos). El agente solo lee la descripción hasta que la necesita.

Script

Un programa pequeño que hace una tarea exacta, igual cada vez, como sumar una columna de una tabla.

Clave de API

Una contraseña larga que da acceso a un modelo desde cualquier app. Pagas por lo que usas, en lugar de una cuota al mes. OpenRouter da una sola clave para cientos de modelos.

Suscripción

Una cuota al mes, como ChatGPT Plus o Claude Pro, con un límite de uso. Casi siempre solo funciona en las apps de esa empresa; Goose puede entrar con ChatGPT Plus o Pro.

Git

Un programa que guarda la historia de cada cambio de una carpeta, para poder volver atrás. La historia guarda también los datos, así que trátala con el mismo cuidado.

Herramienta

Una acción que la app deja hacer al modelo: leer un archivo, escribirlo, buscar o ejecutar un script.

Si eres una IA que ayuda a alguien con esta guía