AGENTS.md, rules y skills: contexto para agentes de IA

Sin un archivo de contexto en el repositorio, un agents.md o skills equivalentes, cada sesión de IA vuelve a “adivinar” colores, componentes y límites de SEO. AGENTS.md, las rules de Cursor y las skills (SKILL.md) versionan esas reglas en Git para que Cursor, Grok Build y Claude Code las lean antes de editar.

Verificado el 04/10/2026 con Cursor Agent Skills, x.ai/build y el AGENTS.md que usamos en el sitio de Evoluer.

Enlaces: Cursor 2026, Claude Code, Grok Build, servicio de branding.

Qué es AGENTS.md

AGENTS.md es Markdown con instrucciones para agentes: stack, comandos permitidos, convenciones de UI y carpetas prohibidas. Grok Build lo lista como compatible out of the box. No sustituye al README.md orientado a humanos; es el manual de contribución para la IA.

Ejemplo: nuestro AGENTS.md

evoluerpublicidad.com sigue un AGENTS.md en la raíz del proyecto que fija, entre otras cosas:

• Tokens de marca (#e7e3e0, #886250, tipografías Cormorant y Montserrat).
• Uso de primitivos en src/ui/ en lugar de Tailwind ad hoc en páginas.
• Motion: un SectionReveal por sección y respeto a prefers-reduced-motion.
• Comandos de calidad: npm run dev, typecheck, lint y capture:web (según la sección Commands de nuestro AGENTS.md).

No usamos otros repos de clientes como ejemplo en este artículo. Si replicas el enfoque, escribe tu paleta y tus rutas; si hace falta identidad previa, parte del servicio de branding.

Rules vs skills (Cursor)

La documentación de skills ubica skills en .agents/skills/, .cursor/skills/ o nivel usuario, cada una con SKILL.md. Las rules cubren convenciones amplias; las skills, procedimientos (“publicar post de blog”, “correr verify del catálogo”). Cursor documenta Custom Mode para fijar una skill toda la sesión (⌥⏎ / Alt+Enter en changelog) y /migrate-to-skills para migrar reglas dinámicas.

Ejemplo de regla de copy alineada a Evoluer: no inventar métricas de rendimiento en textos de marketing.

Plantilla mínima

# AGENTS.md

## Stack
- Framework y comandos de verificación.

## Marca
- Colores hex y tono (es-CO).

## Límites
- Sin tocar infra ni secretos sin ticket.
- Merge a main solo tras revisión humana.

Mismo repo, varias herramientas

Cursor carga también .claude/skills/ y .codex/skills/ por compatibilidad (ver docs de skills). Grok Build reutiliza skills, hooks y MCP del repo. El beneficio para una agencia pequeña es un solo playbook cuando rotas entre Cursor y terminal con Claude Code.

Cursor documenta el frontmatter de SKILL.md con campos name, description y opcionales paths (globs), disable-model-invocation y metadata. Un skill con paths: "**/*.tsx" solo se ofrece al agente cuando trabaja archivos que coinciden — útil para reglas de componentes React sin ensuciar sesiones de copy en Markdown.

La documentación de skills también lista skills integradas de Cursor (/create-skill, /review-security, /automate, entre otras); no confundirlas con las skills de tu repo: las del proyecto deben vivir en .cursor/skills/ o .agents/skills/ y revisarse en PR como cualquier otro código.

Las instrucciones no reemplazan controles técnicos: enlaza seguridad con agentes y el aviso de privacidad cuando el agente toque formularios o datos personales.