mcp-web-agent-docs

To keep agent documentation consistent during monorepo updates, maintain a high-level overview in AGENTS.md and store skill-specific docs in ./agents/skills/. This structure ensures navigation and documentation remain accurate when repository code changes.

The best way to structure agent documentation is to provide a high-level overview in AGENTS.md while placing individual skill files like SKILL.md in the ./agents/skills/ directory. This separation maintains uniform terminology and clear content structure.

To update AGENTS.md when adding a new package, follow the provided update guidance procedure to include the new package information and verify that all relevant documentation links are correct. This ensures the high-level overview stays synchronized with the codebase.

You need to audit agent skills documentation when repository structure changes occur, ensuring that AGENTS.md and individual skill files remain accurate. Consistency checks enforce uniform terminology and verify that documentation follows project guidelines.

Yes, you can manage multiple agent skill files by maintaining individual SKILL.md files in the ./agents/skills/ directory. This approach allows you to perform documentation auditing and consistency enforcement across all individual skill files simultaneously.

Separating high-level agent docs from skill-specific documentation prevents content duplication and maintains uniform structure. AGENTS.md serves as a navigation entry point, while ./agents/skills/ files contain detailed updates, ensuring consistency checks are easier to manage.