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/agent-skills
agent-framework-azure-ai-py
Build Azure AI Foundry agents using the Microsoft Agent Framework Python SDK (agent-framework-azure-ai). Use when creating persistent agents with AzureAIAgentsProvider, using hosted tools (code interpreter, file search, web search), integrating MCP servers, managing conversation threads, or implementing streaming responses. Covers function tools, structured outputs, and multi-tool agents.
2skill-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.
2mcp-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).
2azure-speech-to-text-rest-py
|
1azure-containerregistry-py
|
1azure-appconfiguration-py
|
1