/ Directorio / Playground / agent-rules-skill
← Todos los servidores ↗ GitHub
● Comunidad netresearch ⚡ Instantáneo

agent-rules-skill

por netresearch · netresearch/agent-rules-skill

Generates AGENTS.md files following the agents.md convention — tells any coding agent (Claude Code, Cursor, Codex) how your repo works.

A small, focused Claude Code skill by Netresearch. It inspects a repository and drafts an AGENTS.md file following the agents.md convention — a growing standard for telling AI agents project conventions, build commands, testing approach, and contribution rules in one place.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

agent-rules-skill.replay ▶ listo
0/0

Instalación

Repositorio del autor · Documentación oficial de Skills de Claude

Casos de uso

Usos del mundo real: agent-rules-skill

Generate an AGENTS.md for a repo that doesn't have one

👤 Teams introducing AI coding agents to an existing codebase ⏱ ~15 min beginner

Cuándo usarlo: Your team just started using Claude Code / Cursor and nobody's written the orientation doc.

Flujo
  1. Run it on your repo
    Use agent-rules-skill. Analyze this repo and draft an AGENTS.md following the convention.✓ Copiado
    → Draft with build/test commands, lint config, style notes, gotchas
  2. Refine
    Add a section on where not to edit (generated files, vendor/).✓ Copiado
    → Section added with explicit paths
  3. Commit
    Commit as docs/AGENTS.md.✓ Copiado
    → File committed at repo root or in docs/

Resultado: A living AGENTS.md that makes future agent sessions start with context.

Errores comunes
  • AGENTS.md balloons into an everything-doc — Keep it focused on what an agent needs. Link to README for humans.
Combinar con: filesystem · git

Generate per-package AGENTS.md files in a monorepo

👤 Monorepo maintainers ⏱ ~30 min intermediate

Cuándo usarlo: Different packages have different conventions; a single root AGENTS.md isn't enough.

Flujo
  1. Scan packages
    Use agent-rules-skill. For each package in packages/, generate a tailored AGENTS.md capturing its specifics.✓ Copiado
    → One AGENTS.md per package
  2. Root summary
    Generate a root AGENTS.md that links to per-package files and lists shared rules.✓ Copiado
    → Root file with pointers

Resultado: Agents pick up the right context based on which package they're working in.

Combinar con: filesystem

Keep AGENTS.md in sync with an evolving repo

👤 Repos where AGENTS.md goes stale fast ⏱ ~10 min beginner

Cuándo usarlo: You added new build commands or changed conventions and AGENTS.md lies about them.

Flujo
  1. Diff
    Use agent-rules-skill. Compare current AGENTS.md to what the repo actually has now. What's stale?✓ Copiado
    → List of drift items
  2. Update
    Update only the stale parts; leave human-written sections alone.✓ Copiado
    → Minimal diff preserving human commentary

Resultado: AGENTS.md stays trustworthy.

Combinar con: git

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

agent-rules-skill + filesystem

Apply generated files directly

Write the draft to AGENTS.md at repo root.✓ Copiado
agent-rules-skill + git

Commit as a focused change

Commit the new AGENTS.md with a message describing what it covers.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
scan_repo repo path First step on any repo 0
draft_agents_md scan output Drafting new file 0
diff_check existing AGENTS.md + current repo Staleness check 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
None
Tokens por llamada
Modest — repo scan + short output
Monetario
Free
Consejo
Run on focused directories in huge monorepos; whole-repo scans are token-heavy.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: None
Salida de datos: Repo contents go through Claude API during scan

Resolución de problemas

Errores comunes y soluciones

Generated commands don't match CI

Verify against actual CI config; skill infers from common files but not always correct

File is too long

Prompt for conciseness; agents.md is meant to be short

Alternativas

agent-rules-skill vs otros

AlternativaCuándo usarlaContrapartida
Manually writing AGENTS.mdSmall repo with clear conventionsWorks but drifts; need discipline to keep fresh
Cursor-specific .cursorrulesYou only use CursorNon-portable; AGENTS.md works across agents

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills