Skill

azure-ai-foundry-local

Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including troubleshooting, best practices, decision making, configuration, and integrations & coding patterns. Use when using Foundry Local CLI, chat/transcription APIs, tools, OpenAI/LangChain clients, or upgrading legacy SDKs, and other Microsoft Foundry Local related development tasks. Not for Microsoft Foundry (use microsoft-foundry), Microsoft Foundry Classic (use microsoft-foundry-classic), Microsoft Foundry Tools (use microsoft-foundry-tools), Azure Local (use azure-local).

npx claudepluginhub atc-net/atc-agentic-toolkit --plugin azure

Tool Access

This skill uses the workspace's default tool permissions.

Preview

This skill provides expert guidance for Azure AI Foundry Local. Covers troubleshooting, best practices, decision making, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.

SKILL.md

Similar Skills

azure-ai-projects-py

37.1k

Build AI agents and applications on Microsoft Foundry using the azure-ai-projects Python SDK. Supports OpenAI-compatible clients, agent CRUD, tools like code interpreter, evaluations, and datasets.

antigravity-awesome-skills

microsoft-foundry

203

Deploys, evaluates, and manages Microsoft Foundry AI agents: Docker builds to ACR, hosted agent creation, batch evals, prompt optimization, tracing, troubleshooting.

20 files

azure

azure-openai-2025

Provides guidance on Azure OpenAI Service 2025 models like GPT-5 series, GPT-4.1, o3/o4-mini reasoning, Sora video generation, image/audio models, and Azure CLI deployment.

azure-master

Stats

Parent Repo Stars1

Parent Repo Forks1

Last CommitApr 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Azure AI Foundry Local Skill

How to Use This Skill

IMPORTANT for Agent: This file may be large. Use the Category Index below to locate relevant sections, then use read_file with specific line ranges (e.g., L136-L144) to read the sections needed for the user's question This skill requires network access to fetch documentation content. Use mcp_microsoftdocs:microsoft_docs_fetch to retrieve full articles.

Fallback: Use the built-in WebFetch tool if the Microsoft Learn MCP server is not available.

Category Index

Category	Lines	Description
Troubleshooting	L27-L30	Troubleshooting Foundry Local on Windows Server 2025, including setup issues, compatibility, permissions, service startup failures, and common runtime or networking problems.
Best Practices	L32-L35	Guidance on reliable Foundry Local deployments, performance and configuration best practices, and troubleshooting common setup, runtime, and environment issues.
Decision Making	L37-L40	Guidance for upgrading apps from the legacy Foundry Local SDK to the current one, including API changes, migration steps, and compatibility considerations.
Configuration	L42-L45	Using the Foundry Local CLI: installing, configuring settings, authenticating, managing projects/environments, and running local workflows via command-line commands.
Integrations & Coding Patterns	L47-L60	Patterns and code for calling Foundry Local models/APIs (chat, transcription, tools), integrating with SDKs/REST, OpenAI-compatible clients, LangChain, Open WebUI, and compiling HF models.

Troubleshooting

Topic	URL
FAQ for running Foundry Local on Windows Server 2025	https://learn.microsoft.com/en-us/azure/foundry-local/reference/windows-server-frequently-asked-questions

Best Practices

Topic	URL
Best practices and troubleshooting for Foundry Local deployments	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-best-practice

Decision Making

Topic	URL
Migrate from legacy to current Foundry Local SDK	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-migration

Configuration

Topic	URL
Configure and use the Foundry Local CLI commands	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli

Integrations & Coding Patterns

Topic	URL
Create a chat app using Open WebUI and Foundry Local	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-chat-application-with-open-web-ui
Compile Hugging Face models for Foundry Local with Olive	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models
Integrate Foundry Local with OpenAI-compatible inference SDKs	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks
Transcribe audio using Foundry Local transcription API	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-transcribe-audio
Build a LangChain translation app with Foundry Local	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local
Use Foundry Local native chat completions API	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions
Implement tool calling in Foundry Local applications	https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local
Use the Foundry Local Model Catalog API	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-catalog-api
Call Foundry Local REST API via CLI-hosted server	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest
Use the current Foundry Local SDK for local AI	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current
Reference for legacy Foundry Local SDK with CLI dependency	https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy