{"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 compiling HF models with Olive, using Foundry Local CLI, chat/tools APIs, transcription/tra","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-L48 | 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 | L49-L59 | Using Foundry Local APIs/SDKs for chat, tools, transcription, translation apps, and OpenAI-style or REST integrations in C#, JS, Python, and Rust, including legacy interfaces. |\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| 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 |\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| 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.698","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 497 github stars · SKILL.md body (4,260 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-04-22T00:53:40.035Z","embedding":null,"createdAt":"2026-04-18T22:00:32.472Z","updatedAt":"2026-04-22T00:53:40.035Z","lastSeenAt":"2026-04-22T00:53:40.035Z","tsv":"'/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models':365 '/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks':403 '/en-us/azure/foundry-local/how-to/how-to-transcribe-audio':413 '/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli':376 '/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local':424 '/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions':434 '/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local':444 '/en-us/azure/foundry-local/reference/reference-best-practice':335 '/en-us/azure/foundry-local/reference/reference-cli':386 '/en-us/azure/foundry-local/reference/reference-rest':455 '/en-us/azure/foundry-local/reference/reference-sdk-current':468 '/en-us/azure/foundry-local/reference/reference-sdk-legacy':481 '/en-us/azure/foundry-local/reference/reference-sdk-migration':350 '/microsoftdocs/mcp/blob/main/readme.md)':163 '3':134 'accept':202 'access':168 'agent':83,127,186,200 'ai':13 'aka':11 'api':39,255,410,431,448,478 'apis/sdks':298 'app':243,304,418 'audio':405 'avail':153 'azur':12 'best':18,55,211,321,325 'build':414 'c':313,462 'call':437 'capabl':75 'categori':86,94,110,206,208 'chang':256 'chat':300,429 'chat/tools':38 'cli':37,219,280,332,369,379,476 'cli-depend':475 'code':25,62,290,388 'combin':65 'command':380 'commands/options':281 'common':222 'compat':260 'compil':29,266,354 'complet':430 'configur':22,59,229,262,286,351 'consider':261 'content':70,172 'cover':54 'current':252,344 'decis':20,57,235,336 'depend':477 'descript':210 'develop':16,234 'doc':178 'document':73,171 'e.g':98,114 'error':223 'expert':5,48 'face':268,356 'fallback':190 'fetch':74,170,179,192 'file':104,112,119,124 'follow':225 'foundri':3,9,14,35,42,52,217,247,273,278,296,330,345,359,367,377,393,407,420,426,439,445,458,470 'github.com':162 'github.com/microsoftdocs/mcp/blob/main/readme.md)':161 'guid':160 'guidanc':49,240 'hf':30 'hug':267,355 'implement':435 'import':81,125 'includ':17,254,318 'index':87,207 'infer':399,452 'instal':157,159,283 'integr':24,61,289,311,387,392 'interfac':320 'issu':220 'js':314,463 'knowledg':6 'l120':101 'l32':214 'l32-l36':213 'l35':100 'l35-l120':99 'l36':215 'l37':238 'l37-l41':237 'l41':239 'l42':264 'l42-l48':263 'l48':265 'l49':293 'l49-l59':292 'l59':294 'langchain':416 'latest':142 'learn':185,199 'learn-agent-skil':184,198 'learn.microsoft.com':334,349,364,375,385,402,412,423,433,443,454,467,480 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-compile-hugging-face-models':363 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-integrate-with-inference-sdks':401 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-transcribe-audio':411 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-foundry-local-cli':374 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-langchain-with-foundry-local':422 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-native-chat-completions':432 'learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local':442 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-best-practice':333 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli':384 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest':453 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current':466 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy':479 'learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-migration':348 'legaci':246,319,342,469 'line':96,108,209 'link':113,122 'local':4,10,15,36,43,53,66,218,233,248,274,279,287,297,331,346,360,368,372,378,394,408,421,427,440,446,451,459,471 'locat':90 'make':21,58,236,337 'manag':284,371 'markdown':189,205 'mcp':148,175 'metadata.generated':129 'microsoft':2,8,41,51,177 'microsoft-foundry-loc':1 'microsoftdoc':149,176 'migrat':257,340 'model':31,269,288,357,373,441 'month':135 'nativ':428 'network':167 'old':136 'oliv':33,271,362 'one':253 'openai':307,397 'openai-styl':306,396 'option':382 'pattern':26,63,291,389 'practic':19,56,212,230,322,326 'prefer':173 'provid':47 'pull':140 'python':315,464 'queri':181,195 'quick':68 'quick-refer':67 'rang':97 'read':103,118 'recommend':226 'refer':69,123,383,449,456,473 'relev':91 'reliabl':232 'remot':72 'repositori':146 'requir':166 'resolv':221 'rest':310,447 'return':188,204 'rust':317,465 'sdk':249,347,472 'sdks':400,460 'section':92 'security.md':115,116 'skill':44,46,80,165,187,201 'skill-microsoft-foundry-local' 'source-microsoftdocs' 'specifi':107 'step':258 'string':182,196 'style':308,398 'suggest':137,154 'text/markdown':203 'tool':150,301,436 'topic':323,338,352,390 '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':404 'transcript':302,409 'transcription/tra':40 'translat':303,417 'troubleshoot':216,328 'upgrad':242 'url':324,339,353,391 'use':27,34,78,84,102,117,174,191,276,295,366,406,425 'user':139,156 'version':143 'webpag':193 'workflow':227","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-04-22T00:53:40.035Z"}],"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":497,"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-04-19T02:43:40Z","description":"Curated Agent Skills for Microsoft & Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","skill_md_sha":"5429f81da2c40cfdb2090219cf4f4c21503c44a8","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 compiling HF models with Olive, using Foundry Local CLI, chat/tools APIs, transcription/translation, or SDK migration, 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-04-22T00:53:40.035Z"}}