wiki-agents-md
AGENTS.md Generator
Generate high-quality AGENTS.md files for repository folders. Each file provides coding agents with project-specific context — build commands, testing instructions, code style, structure, and operational boundaries.
What is AGENTS.md
AGENTS.md complements README.md. README is for humans; AGENTS.md is for coding agents.
- Predictable location — Agents look for
AGENTS.mdin the current directory, then walk up the tree - Nested files — Subfolders can have their own
AGENTS.mdthat takes precedence over the root one - Separate from README — Keeps READMEs concise; agent-specific details (exact commands, boundaries, conventions) go here
- NOT the same as
.github/agents/*.agent.md— Those are agent persona definitions (who the agent is).AGENTS.mdis project context (what the agent should know about this code)
Critical Guard: Only Generate If Missing
This is the single most important rule.
NEVER overwrite an existing AGENTS.md.
More from microsoft/skills
frontend-design-review
>
47skill-creator
Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.
43cloud-solution-architect
>-
33mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).
31continual-learning
Guide for implementing continual learning in AI coding agents — hooks, memory scoping, reflection patterns. Use when setting up learning infrastructure for agents.
26microsoft-docs
Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention "docs." If the question is about understanding a concept rather than writing code, this is the right skill.
23