microsoft-foundry
Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with IQ retrieval, Azure OpenAI models, MCP tools, VNet/private access, or Teams apps, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Local (use microsoft-foundry-local), Microsoft Foundry Tools (use microsoft-foundry-
npx skills add MicrosoftDocs/Agent-Skills --skill microsoft-foundry --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
Provides expert guidance for Microsoft Foundry development, covering troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It directs the agent to use a Category Index to locate relevant sections and to fetch documentation via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage when needed.
How it works
- Instructs the agent to consult the Category Index to locate relevant sections.
- For categories with line ranges (e.g., L35-L120), instructs to use read_file with the specified lines.
- For categories with file links (e.g., security.md), instructs to use read_file on the linked reference file.
- If metadata generated time is old, suggest pulling latest version. If mcp_microsoftdocs tools are unavailable, suggest installing via the provided installation guide.
- Requires network access and uses either mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve Markdown documentation content.
When to use it
Use when working on Foundry tasks involving IQ retrieval, Azure OpenAI models, MCP tools, VNet/private access, Teams apps, or other Foundry-related development tasks. Not for Foundry Classic/Local/Tools variants.
What it can touch
- Tools: mcp_microsoftdocs:microsoft_docs_fetch
- Fallback: fetch_webpage
- Reading content via read_file referenced by category links
Caveats
- Requires network access and may rely on remote documentation availability.
- If generated_at is more than 3 months old, user should pull latest version.
- Licensing: CC-BY-4.0 for the skill content.
# Microsoft Foundry Skill This skill provides expert guidance for Microsoft Foundry. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_we
- How to Use This Skill
- Category Index
- Troubleshooting
- Best Practices
- Decision Making
- Architecture & Design Patterns
- Limits & Quotas
- Security
- Configuration
- Integrations & Coding Patterns
- Deployment
What does the microsoft-foundry skill do?
Expert knowledge for Microsoft Foundry (aka Azure AI Foundry) development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Foundry agents with IQ retrieval, Azure OpenAI models, MCP tools, VNet/private access, or Teams apps, and other Microsoft Foundry related development tasks. Not for Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Local (use microsoft-foundry-local), Microsoft Foundry Tools (use microsoft-foundry-
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill microsoft-foundry --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From MicrosoftDocs/Agent-Skills, a repository with 682 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.