{"id":"0cccd78e-1889-4308-8134-25e523e65224","shortId":"2vXkuC","kind":"skill","title":"microsoft-foundry-local","tagline":"Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including best practices, decision making, configuration, and integrations & coding patterns. Use when calling Foundry Local chat/tools APIs, compiling HF models with Olive, using the CLI, or mi","description":"# Microsoft Foundry Local Skill\n\nThis skill provides expert guidance for Microsoft Foundry Local. Covers best practices, decision making, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.\n\n## How to Use This Skill\n\n> **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\n\n> **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)\n\nThis skill requires **network access** to fetch documentation content:\n- **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown.\n- **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown.\n\n## Category Index\n\n| Category | Lines | Description |\n|----------|-------|-------------|\n| Best Practices | L32-L36 | Troubleshooting Foundry Local CLI issues, resolving common errors, and following recommended workflows and configuration practices for reliable local development. |\n| Decision Making | L37-L41 | Guidance for upgrading apps from the legacy Foundry Local SDK to the current one, including API changes, migration steps, and compatibility considerations. |\n| Configuration | L42-L47 | Compiling Hugging Face models with Olive for Foundry Local, and using the Foundry Local CLI commands/options to install, manage, and configure local models. |\n| Integrations & Coding Patterns | L48-L59 | APIs, SDKs, and patterns for calling Foundry Local models: REST/OpenAI-style chat, tools, transcription, LangChain apps, and compiling Hugging Face models for local inference. |\n\n### Best Practices\n| Topic | URL |\n|-------|-----|\n| Best practices and troubleshooting for Foundry Local CLI | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-best-practice |\n\n### Decision Making\n| Topic | URL |\n|-------|-----|\n| Migrate from legacy to current Foundry Local SDK | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-migration |\n\n### Configuration\n| Topic | URL |\n|-------|-----|\n| Use Foundry Local CLI to manage local models | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli |\n| Foundry Local CLI command and options reference | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli |\n\n### Integrations & Coding Patterns\n| Topic | URL |\n|-------|-----|\n| Compile Hugging Face models for Foundry Local | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models |\n| Integrate Foundry Local with OpenAI-style inference SDKs | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks |\n| Transcribe audio using Foundry Local transcription API | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-transcribe-audio |\n| 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 |\n| Use Foundry Local native chat completions API | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions |\n| Implement tool calling with Foundry Local models | https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local |\n| Foundry Local REST API reference for local inference | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest |\n| Reference for Foundry Local SDKs in C#, JS, Python, Rust | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current |\n| Legacy Foundry Local SDK reference and CLI-dependent APIs | https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy |","tags":["microsoft","foundry","local","agent","skills","microsoftdocs","agent-skills","agentic-skills","agentskill","ai-agents","ai-coding","azure"],"capabilities":["skill","source-microsoftdocs","skill-microsoft-foundry-local","topic-agent","topic-agent-skills","topic-agentic-skills","topic-agentskill","topic-ai-agents","topic-ai-coding","topic-azure","topic-azure-functions","topic-azure-kubernetes-service","topic-azure-openai","topic-azure-sql-database","topic-azure-storage"],"categories":["Agent-Skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/MicrosoftDocs/Agent-Skills/microsoft-foundry-local","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add MicrosoftDocs/Agent-Skills","source_repo":"https://github.com/MicrosoftDocs/Agent-Skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 549 github stars · SKILL.md body (4,249 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:54:01.618Z","embedding":null,"createdAt":"2026-04-18T22:00:32.472Z","updatedAt":"2026-05-18T18:54:01.618Z","lastSeenAt":"2026-05-18T18:54:01.618Z","tsv":"'/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models':389 '/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks':401 '/en-us/azure/foundry-local/how-to/how-to-transcribe-audio':411 '/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli':364 '/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local':422 '/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions':432 '/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local':442 '/en-us/azure/foundry-local/reference/reference-best-practice':335 '/en-us/azure/foundry-local/reference/reference-cli':374 '/en-us/azure/foundry-local/reference/reference-rest':453 '/en-us/azure/foundry-local/reference/reference-sdk-current':466 '/en-us/azure/foundry-local/reference/reference-sdk-legacy':479 '/en-us/azure/foundry-local/reference/reference-sdk-migration':350 '/microsoftdocs/mcp/blob/main/readme.md)':166 '3':137 'accept':205 'access':171 'agent':86,130,189,203 'ai':13 'aka':11 'api':33,258,298,408,429,446,476 'app':246,312,416 'audio':403 'avail':156 'azur':12 'best':18,58,214,321,325 'build':412 'c':460 'call':29,303,435 'capabl':78 'categori':89,97,113,209,211 'chang':259 'chat':308,427 'chat/tools':32 'cli':41,222,283,332,357,367,474 'cli-depend':473 'code':25,65,293,376 'combin':68 'command':368 'commands/options':284 'common':225 'compat':263 'compil':34,269,314,380 'complet':428 'configur':22,62,232,265,289,351 'consider':264 'content':73,175 'cover':57 'current':255,344 'decis':20,60,238,336 'depend':475 'descript':213 'develop':16,237 'doc':181 'document':76,174 'e.g':101,117 'error':226 'expert':5,51 'face':271,316,382 'fallback':193 'fetch':77,173,182,195 'file':107,115,122,127 'follow':228 'foundri':3,9,14,30,45,55,220,250,276,281,304,330,345,355,365,385,391,405,418,424,437,443,456,468 'github.com':165 'github.com/microsoftdocs/mcp/blob/main/readme.md)':164 'guid':163 'guidanc':52,243 'hf':35 'hug':270,315,381 'implement':433 'import':84,128 'includ':17,257 'index':90,210 'infer':320,397,450 'instal':160,162,286 'integr':24,64,292,375,390 'issu':223 'js':461 'knowledg':6 'l120':104 'l32':217 'l32-l36':216 'l35':103 'l35-l120':102 'l36':218 'l37':241 'l37-l41':240 'l41':242 'l42':267 'l42-l47':266 'l47':268 'l48':296 'l48-l59':295 'l59':297 'langchain':311,414 'latest':145 'learn':188,202 'learn-agent-skil':187,201 'learn.microsoft.com':334,349,363,373,388,400,410,421,431,441,452,465,478 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models':387 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks':399 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-transcribe-audio':409 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli':362 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local':420 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions':430 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local':440 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-best-practice':333 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli':372 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest':451 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current':464 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy':477 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-migration':348 'legaci':249,342,467 'line':99,111,212 'link':116,125 'local':4,10,15,31,46,56,69,221,236,251,277,282,290,305,319,331,346,356,360,366,386,392,406,419,425,438,444,449,457,469 'locat':93 'make':21,61,239,337 'manag':287,359 'markdown':192,208 'mcp':151,178 'metadata.generated':132 'mi':43 'microsoft':2,8,44,54,180 'microsoft-foundry-loc':1 'microsoftdoc':152,179 'migrat':260,340 'model':36,272,291,306,317,361,383,439 'month':138 'nativ':426 'network':170 'old':139 'oliv':38,274 'one':256 'openai':395 'openai-styl':394 'option':370 'pattern':26,66,294,301,377 'practic':19,59,215,233,322,326 'prefer':176 'provid':50 'pull':143 'python':462 'queri':184,198 'quick':71 'quick-refer':70 'rang':100 'read':106,121 'recommend':229 'refer':72,126,371,447,454,471 'relev':94 'reliabl':235 'remot':75 'repositori':149 'requir':169 'resolv':224 'rest':445 'rest/openai-style':307 'return':191,207 'rust':463 'sdk':252,347,470 'sdks':299,398,458 'section':95 'security.md':118,119 'skill':47,49,83,168,190,204 'skill-microsoft-foundry-local' 'source-microsoftdocs' 'specifi':110 'step':261 'string':185,199 'style':396 'suggest':140,157 'text/markdown':206 'tool':153,309,434 'topic':323,338,352,378 'topic-agent' 'topic-agent-skills' 'topic-agentic-skills' 'topic-agentskill' 'topic-ai-agents' 'topic-ai-coding' 'topic-azure' 'topic-azure-functions' 'topic-azure-kubernetes-service' 'topic-azure-openai' 'topic-azure-sql-database' 'topic-azure-storage' 'transcrib':402 'transcript':310,407 'translat':415 'troubleshoot':219,328 'upgrad':245 'url':324,339,353,379 'use':27,39,81,87,105,120,177,194,279,354,404,423 'user':142,159 'version':146 'webpag':196 'workflow':230","prices":[{"id":"b6026233-8a84-4647-b84f-f1b72c75c876","listingId":"0cccd78e-1889-4308-8134-25e523e65224","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"MicrosoftDocs","category":"Agent-Skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:00:32.472Z"}],"sources":[{"listingId":"0cccd78e-1889-4308-8134-25e523e65224","source":"github","sourceId":"MicrosoftDocs/Agent-Skills/microsoft-foundry-local","sourceUrl":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/microsoft-foundry-local","isPrimary":false,"firstSeenAt":"2026-04-18T22:00:32.472Z","lastSeenAt":"2026-05-18T18:54:01.618Z"}],"details":{"listingId":"0cccd78e-1889-4308-8134-25e523e65224","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"MicrosoftDocs","slug":"microsoft-foundry-local","github":{"repo":"MicrosoftDocs/Agent-Skills","stars":549,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"license":"cc-by-4.0","html_url":"https://github.com/MicrosoftDocs/Agent-Skills","pushed_at":"2026-05-17T02:50:05Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"844b1ef62f123cbe21e134d80eee92dc754b66e0","skill_md_path":"skills/microsoft-foundry-local/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/microsoft-foundry-local"},"layout":"multi","source":"github","category":"Agent-Skills","frontmatter":{"name":"microsoft-foundry-local","description":"Expert knowledge for Microsoft Foundry Local (aka Azure AI Foundry Local) development including best practices, decision making, configuration, and integrations & coding patterns. Use when calling Foundry Local chat/tools APIs, compiling HF models with Olive, using the CLI, or migrating SDK versions, 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).","compatibility":"Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation."},"skills_sh_url":"https://skills.sh/MicrosoftDocs/Agent-Skills/microsoft-foundry-local"},"updatedAt":"2026-05-18T18:54:01.618Z"}}