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 trabaja con los archivos de tu ordenador. No puede leer tus apuntes, ni cambiar tu tabla de entrenos, ni crear un documento en tu carpeta. Algunas apps se conectan a servicios como Google Drive, pero lo que tienes en tu ordenador se queda fuera.

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 por su cuenta las instrucciones que tú le dejas escritas. 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: demasiado contexto juega en tu contra.

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. Puede que no te avise, y por el camino se pierden detalles.

Y aunque todo quepa, un contexto enorme funciona peor. Piénsalo así: si te lees una página y te pregunto algo sobre ella, aciertas casi seguro. Si te lees 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 tabla para Excel, una página para imprimir o un documento para enviar. Se guardan en tu carpeta: son tuyos, los abres con tus programas de siempre y los compartes como quieras.
• Trabajar con muchos archivos. En un chat adjuntas unos pocos. En una carpeta puedes tener cientos o miles: 300 documentos escaneados, por ejemplo, sean apuntes, exámenes, tickets de la compra o presupuestos. El agente los abre uno a uno y te deja una tabla o un resumen con lo que le pidas. Tardará y gastará uso, pero no hay un límite de archivos que subir.
• Usar programas de tu ordenador, si le das permiso. Incluso puede escribir los suyos: programas pequeños, llamados scripts, que ordenan fotos, convierten documentos o hacen cuentas. Solucionan el problema de que los modelos escriben la respuesta que les parece más probable: por eso a veces fallan en una cuenta larga o hacen una tarea cada vez de una forma. Un script la hace siempre igual y sin errores.
• Aprender habilidades. Le puedes escribir skills: instrucciones para una tarea concreta, que el agente sigue cuando hace falta o cuando se lo pides. Las verás en el paso 6.
• Trabajar en paralelo. Puedes abrir varios chats a la vez con la misma carpeta, cada uno con su tarea. Solo hay que vigilar que no se pisen el trabajo.

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. Normalmente funciona en internet, no en tu ordenador.
• La app, donde trabajáis juntos. Un programa en tu ordenador. Es donde tú hablas con el agente y ves lo que hace, y es lo que le da sus herramientas: leer, crear y cambiar los archivos de su carpeta.
• La carpeta, la casa y la memoria. Dentro van sus instrucciones, lo que debe recordar y lo que te entrega. Es tuya: la controlas por completo, la copias y la compartes como quieras.

Elige tu ejemplo

A partir de aquí, vas a crear un agente de verdad, paso a paso. Para que cada paso sea concreto, elige ahora un ejemplo: la guía te enseñará a crear ese agente. Escoge el que más se parezca a lo tuyo, o el que te apetezca.

Los pasos son los mismos para todos; solo cambia lo que el agente sabe hacer. Con lo que aprendas podrás crear después cualquier otro: uno para tus finanzas, para tu huerto, para preparar unas oposiciones o para tu negocio.

• 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. Así que ten presente que la empresa del modelo puede llegar a ver lo que el agente lea de la carpeta.

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 propio agente más adelante.

Así debería quedar tu carpeta ahora. Irá creciendo: al final de cada paso verás cómo queda, con lo nuevo marcado. Cuando termines la guía, la carpeta tendrá estas partes. Cada parte 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:

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.

Cada app tiene un modo de permisos: decide qué hace el agente solo y qué te pregunta antes. Empieza con el que trae tu app de serie. Algunos modos 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.

Consejo: si te cansa que te pida permiso tan a menudo, casi todas las apps tienen modos que preguntan menos. Búscalo junto al cuadro de mensaje y cámbialo cuando ya te fíes de tu agente.

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:

Fíjate en AGENTS.md: entra en el contexto de todas las conversaciones, así que lo que escribas ahí el agente lo tiene presente siempre. Por eso es tan potente. Las skills, que verás en el paso 6, entran solo con su nombre y una frase.

Tu AGENTS.md

Lo más fácil es que el agente cree el AGENTS.md por ti. Este es el mensaje para tu ejemplo, con el archivo entero dentro. Ábrelo y léelo: dice quién es el agente, qué hace, dónde guarda cada cosa y unas reglas. Cópialo, pégalo en el chat y, antes de enviarlo, cambia los datos que son tuyos (tu curso, tus grupos, tu objetivo). Deja la estructura.

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

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

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

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

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

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

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

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

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

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

Verás algo así:

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.

Consejo: si no sabes cómo hacer algo, o no entiendes por qué el agente hace algo de cierta manera, pregúntaselo a él. Sabe explicar cómo trabaja: «¿Por qué has guardado eso en datos/ y no en otro sitio?» es una pregunta perfectamente válida. Y no te quedes ahí: pregúntale también qué más puede hacer por ti. «¿Qué cambiarías de tu AGENTS.md para ayudarme mejor?» o «Mira lo que hay en datos/: ¿qué podrías hacer con ello para ahorrarme tiempo?» suelen dar ideas que no se te habrían ocurrido.

Paso 6 de 8

Enséñale habilidades: 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"): unas instrucciones guardadas para una tarea concreta.

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 skill 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.

Este es el mensaje que crea la skill de tu ejemplo, con su SKILL.md dentro. Cópialo y mándaselo al agente:

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

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

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

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

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

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

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

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

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

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

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.

Un modelo escribe muy bien, pero calcula como una persona muy lista que hace las cuentas de cabeza: casi siempre bien, a veces mal. Y si le pides lo mismo diez veces, puede hacerlo de diez formas un poco distintas. Un script es un programa pequeño que hace una tarea exacta, igual cada vez, tantas veces como haga falta. No lo tienes que escribir ni ejecutar tú: lo hace el agente.

Sirve para todo lo que es mecánico y se repite:

• Hacer cuentas: sumar gastos, sacar medias, contar días.
• Ordenar y renombrar archivos: poner la fecha a 200 fotos, o moverlas a una carpeta por mes.
• Convertir y juntar: pasar documentos a PDF, o juntar muchas tablas en una.
• Revisar: buscar fechas que vencen, o filas que faltan en una tabla.

Una vez escrito, el script se queda en tu carpeta: el agente lo vuelve a usar cada vez, en segundos, y siempre da el mismo resultado.

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?".

Extra · opcional

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.

Extra · opcional

Crea tu propio agente

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.

Extra · opcional

Mejora tu agente con el uso

Con unas pocas costumbres, cada semana te ayuda mejor.

• 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.

Extra · opcional

Cosas a tener en cuenta

Avisos para usarlo con tranquilidad: qué datos guardar, cuándo revisar y cómo no perder nada.

• 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.

Extra · opcional

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.

Extra · opcional

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

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

Script

Un programa pequeño que hace una tarea exacta, igual cada vez, como sumar una tabla o renombrar 200 fotos.

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.