Cursor Rules, AGENTS.md y Claude Skills
Tres patrones para configurar editores con AI. No están en competencia — son alternativas con tradeoffs distintos según tu stack y tu flujo. Aquí te muestro cómo se diferencian, qué dicen las docs oficiales y cuándo elegir uno u otro.
Los tres patrones de un vistazo
Cada uno fue diseñado para un editor distinto. Ninguno está deprecado según las docs oficiales — coexisten.
Cursor Rules
Reglas estructuradas en .cursor/rules/ con frontmatter, descripciones y patterns. El sistema más completo y composable de Cursor.
- Archivos .mdc en .cursor/rules/
- Activación por description, file globs o manual
- Comparte prompts, scripts y workflows entre el equipo
AGENTS.md
Un solo archivo markdown en la raíz del proyecto. Cursor lo lee como instrucciones globales del agente. Pensado para casos simples.
- Un único AGENTS.md en root
- Markdown plano, sin frontmatter requerido
- Convención open-source compartida con otros agents
Claude Skills
Carpetas con SKILL.md autoinvocables. Claude decide cuándo usarlas según el description, o las invocas con /skill-name.
- Directorio por skill con SKILL.md
- Activación por description semántica o /skill-name
- Soporta scripts, ejecución en subagent, dynamic context
- Distribuibles vía skills.sh (registry open-source)
Aspecto por aspecto
Las diferencias clave entre los tres patrones, según lo que dice la documentación oficial de cada plataforma.
| Aspecto | Cursor Rules | AGENTS.md | Claude Skills |
|---|---|---|---|
| Estructura | .cursor/rules/*.mdc | AGENTS.md (un archivo) | .claude/skills/<name>/SKILL.md + archivos opcionales |
| Activación | Description, globs o manual | Siempre activo (global) | Description semántica o /skill-name |
| Composición | Múltiples rules combinables | Archivo único, sin composición | Skills referencian archivos auxiliares en su carpeta |
| Scope | Proyecto o User Rules (global) | Proyecto | Personal (~/.claude/), proyecto, plugin o enterprise |
| Editor | Cursor | Cursor (también otros agents lo respetan) | Claude Code |
| Estándar abierto | No | AGENTS.md convention | agentskills.io |
| Soporte de scripts | Sí (workflows con scripts) | No (solo instrucciones) | Sí (scripts ejecutables, dynamic context con !`cmd`) |
La misma idea en los tres patrones
Una regla equivalente expresada en cada sistema. Vas a notar que el mental model cambia más que la cantidad de código.
Cursor Rules
.cursor/rules/next.mdc---
description: Next.js component conventions
globs:
- "app/**/*.tsx"
alwaysApply: false
---
When working with Next.js components:
- Use Server Components by default
- Add 'use client' only when needed
- Co-locate types with componentsAGENTS.md
./AGENTS.md# Project Agent Instructions
## Next.js conventions
- Use Server Components by default
- Add 'use client' only when needed
- Co-locate types with components
## Database
- Migrations live in /db/migrations
- Use Drizzle ORM for queriesClaude Skills
.claude/skills/next-best/SKILL.md---
description: Next.js component conventions. Use when building React components in App Router.
---
## When to use
Building Next.js components, optimizing rendering strategy.
## Conventions
- Server Components by default
- 'use client' only when needed
- Co-locate types with componentsGuía de decisión
Tres preguntas concretas para ubicarte. No hay respuesta absoluta — el editor que uses define el espacio.
Usas Cursor y quieres algo simple
Un archivo markdown en la raíz. Cero overhead, todos los agents que respetan la convención lo leen. Ideal para reglas globales del proyecto.
Usas Cursor con reglas que dependen del tipo de archivo o flujo
Si necesitas activación condicional, scripts, o múltiples reglas combinables, Rules te da más control. La documentación de Cursor recomienda Rules para workflows complejos del equipo.
Usas Claude Code
Es el sistema nativo de Claude Code. Descripciones semánticas, soporte para scripts y subagents, y siguen el estándar abierto agentskills.io.
skills.sh — el registry abierto
Skills sigue el estándar agentskills.io. Vercel Labs mantiene skills.sh como directorio público y npx skills como CLI para instalar skills en 55+ agentes.
Una instalación, múltiples agentes
La CLI npx skills conoce las rutas de instalación de cada agente compatible y coloca los archivos donde corresponde. Para agentes que soportan nativamente la spec (Claude Code es el caso más claro), los skills se cargan automáticamente. Para otros agentes la integración puede variar.
# Instalar un skill desde GitHub
npx skills add anthropics/skills --skill skill-creator
# Listar skills instalados
npx skills list
# Buscar en el registry
npx skills find react
# Actualizar skills instalados
npx skills updateLa lista completa vive en el repositorio vercel-labs/skills. Cada agente declara su ruta de instalación (proyecto y global) en la configuración de la CLI.
Lo que se dice por ahí y lo que dicen las docs
Reviso afirmaciones comunes con las fuentes oficiales como ground truth.
Cursor Rules está deprecado
Falso. La doc oficial de Cursor lo presenta como el sistema principal en 2026 y describe AGENTS.md como una alternativa más simple, no como reemplazo. Ninguno está deprecado.
Claude Skills reemplaza a Cursor Rules
Falso. Son sistemas de plataformas distintas (Anthropic vs Cursor). Resuelven problemas similares pero no se reemplazan entre sí. Si usas ambos editores, configuras cada uno por separado.
Skills siguen un estándar abierto
Verdadero y con tracción real. Skills implementa el spec de agentskills.io. Vercel Labs publica la CLI npx skills que soporta 55+ agentes (Claude Code, Cursor, Codex, Cline, Continue, GitHub Copilot, Windsurf y más). El registry skills.sh ya tracking 400K+ skills publicados.
MCP permite contexto dinámico
Verdadero. Model Context Protocol es un estándar abierto (modelcontextprotocol.io) que permite cargar contexto desde servidores externos. Ortogonal a Rules/Skills — los tres patrones pueden combinarse con MCP.
Fuentes primarias
Documentación oficial de las plataformas. Para todo lo que aparece en este artículo, esta es la fuente de verdad.
Cursor Rules (docs oficiales)
Especificación oficial del sistema de Rules de Cursor.
AGENTS.md (Cursor)
Convención simplificada para instrucciones globales del agente.
Claude Code Skills (docs oficiales)
Documentación oficial de Anthropic sobre Skills.
Agent Skills (open standard)
Especificación abierta que Claude Skills sigue.
skills.sh (Vercel Labs registry)
Directorio público de Agent Skills + leaderboard de adopción. Open-source.
vercel-labs/skills (CLI)
La CLI `npx skills` que instala skills en 55+ agentes con symlinks o copy.
Model Context Protocol (MCP)
Spec del protocolo para contexto dinámico desde servidores externos.
Mi artículo anterior sobre Cursor Rules
Contexto histórico de cómo escribí mis primeras reglas.
Construyamos sistemas que escalen
Si quieres ayuda para diseñar el setup de AI editors de tu equipo o auditar el que ya tienes, escríbeme y vemos cómo.