Archivos Markdown para agentes de IA
CLAUDE.md, AGENTS.md, SKILL.md y llms.txt. Los archivos Markdown que leen los agentes de IA para entender un proyecto, aprender una tarea o recorrer una web.
Los agentes de IA no recuerdan nada entre una sesión y la siguiente, así que necesitan que alguien les dé el contexto cada vez. La forma que se ha impuesto para hacerlo es un archivo de texto en Markdown: legible para las personas, fácil de mantener en Git y el formato que mejor entienden los modelos de lenguaje.
Cada archivo cumple una función distinta. Unos describen un proyecto, otros enseñan una tarea concreta y otros resumen una web entera. Si quieres entender por qué Markdown funciona tan bien con los modelos, empieza por Markdown en prompts.
Archivos
Estos son los archivos que cubrimos, con lo que resuelve cada uno.
El archivo de instrucciones de Claude Code. Se carga al empezar cada sesión y le dice al agente cómo trabajar en tu proyecto: comandos, convenciones y lo que no debe tocar. Explicamos dónde se coloca, cómo se cargan los distintos niveles y cómo escribir reglas que se cumplan.
La convención que comparten varias herramientas de programación con IA para no mantener un archivo distinto por cada una. Cumple la misma función que CLAUDE.md, pero de forma portable.
El archivo que define una skill: un procedimiento que el agente solo carga cuando la tarea lo pide. Es la pieza adecuada para todo lo que no necesita estar en el contexto de cada sesión, como publicar una versión o escribir un documento siguiendo una plantilla.
Un índice en Markdown en la raíz de una web, pensado para que los modelos encuentren su contenido importante sin leer el HTML. Útil sobre todo en sitios de documentación técnica; no es una técnica de SEO.
Cuál usar en cada caso
La elección depende de qué necesita saber el agente y cuándo. Esta tabla resume la diferencia:
| Archivo | Dónde vive | Cuándo lo lee el agente | Para qué |
|---|---|---|---|
CLAUDE.md | Raíz del proyecto | Al empezar cada sesión de Claude Code | Reglas y contexto del proyecto |
AGENTS.md | Raíz del proyecto | Al empezar, en las herramientas compatibles | El mismo contexto, compartido entre herramientas |
SKILL.md | Carpeta de la skill | Solo cuando la tarea lo pide | Procedimientos de varios pasos |
llms.txt | Raíz de la web | Cuando un agente consulta el sitio | Índice del contenido de una web |
Los tres primeros se combinan sin problema en un mismo repositorio. Lo habitual es poner en AGENTS.md o CLAUDE.md lo que el agente debe saber siempre y sacar a skills todo lo demás, para no llenar el contexto con instrucciones que solo importan de vez en cuando.
Recursos relacionados
- System prompts con Markdown: cómo escribir instrucciones persistentes para chatbots y agentes
- Prompt engineering: técnicas para sacar más partido a los modelos
- MCP y Markdown: cómo se conectan los agentes con herramientas externas
- Cómo usar MarkItDown con Claude: convertir documentos a Markdown para trabajar con ellos en Claude
- Guía Markdown de Claude: cómo renderiza Claude el Markdown y qué sintaxis admite
👋 Hola! Soy Edu, me encanta crear cosas y he redactado este tutorial. Si te ha resultado útil, el mayor favor que me podrías hacer es el de compatirlo en Twitter.
Sígueme en Twitter para estar al día con mi contenido. 😊
