SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/microsoft-foundry-local

MicrosoftDocs

microsoft-foundry-local

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/embeddings APIs, tool calling, 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).

v1.0Latest
New~1.3kUpdated Jun 26, 2026

Microsoft Foundry Local Skill

This 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.

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

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_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category Lines Description
Best Practices L32-L36 CLI usage tips, common error diagnostics, troubleshooting install/auth/deploy issues, and recommended workflows for using the Foundry Local CLI effectively.
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.
Configuration L42-L48 Compiling Hugging Face models with Olive for Foundry Local and using the Foundry Local CLI to install, manage, and configure local models and their command options.
Integrations & Coding Patterns L49-L61 Using Foundry Local APIs/SDKs for chat, embeddings, transcription, OpenAI-compatible clients, LangChain apps, tool calling, and REST/SDK reference (C#, JS, Python, Rust, legacy).

Best Practices

Topic URL
Best practices and troubleshooting for Foundry Local CLI 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
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
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
Foundry Local CLI command and options reference https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-cli

Integrations & Coding Patterns

Topic URL
Generate text embeddings with Foundry Local SDK https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-generate-embeddings
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
Live microphone transcription with Foundry Local https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-live-transcribe-audio
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 with Foundry Local models https://learn.microsoft.com/en-us/azure/foundry-local/how-to/how-to-use-tool-calling-with-foundry-local
Foundry Local REST API reference for local inference https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-rest
Reference for Foundry Local SDKs in C#, JS, Python, Rust https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-current
Legacy Foundry Local SDK reference and CLI-dependent APIs https://learn.microsoft.com/en-us/azure/foundry-local/reference/reference-sdk-legacy
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

72/100

Grade

B

Good

Safety

78

Quality

68

Clarity

82

Completeness

58

Summary

A reference skill providing expert guidance for Microsoft Foundry Local development, covering CLI usage, model compilation with Olive, SDK migration, and API integrations. The skill uses a structured category index that references remote Microsoft Learn documentation via MCP tools or web fetch, acting as a curated entry point to distributed technical content.

Detected Capabilities

remote documentation fetch (mcp_microsoftdocs or HTTP)network access requiredfile reading (read_file)metadata versioning check

Trigger Keywords

Phrases that MCP clients use to match this skill to user intent.

foundry local setupfoundry local cliolive model compilationfoundry local sdk migrationfoundry local api integrationfoundry embeddingsfoundry tool calling

Risk Signals

INFO

Remote documentation fetching via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage

SKILL.md lines 18–25
INFO

Network access requirement with fallback to external HTTP fetch

SKILL.md lines 17, 21–24
INFO

Metadata staleness check (3-month threshold) suggests optional version refresh

SKILL.md lines 13–14
WARNING

No local content provided; skill is purely a navigation index for remote docs

SKILL.md lines 27–60

Referenced Domains

External domains referenced in skill content, detected by static analysis.

github.comlearn.microsoft.com

Use Cases

  • Troubleshoot Foundry Local CLI installation and configuration issues
  • Migrate legacy SDK code to the current Foundry Local SDK
  • Compile Hugging Face models using Olive for local deployment
  • Implement chat completions, embeddings, and transcription with Foundry Local APIs
  • Integrate Foundry Local with OpenAI-compatible clients or LangChain applications
  • Implement tool calling and function invocation with Foundry Local models

Quality Notes

  • Skill correctly differentiates scope from related products (microsoft-foundry, microsoft-foundry-classic, microsoft-foundry-tools, azure-local)
  • Category index is well-structured with line ranges and descriptive summaries
  • Clear dual-mode instructions for agents: preferred (mcp_microsoftdocs) and fallback (fetch_webpage)
  • Metadata includes generator and timestamp, enabling version freshness checks
  • No actual reference files included (e.g., no local security.md, configuration.md); relies entirely on remote fetch
  • Documentation links are specific and well-organized by category (Best Practices, Decision Making, Configuration, Integrations)
  • Potential fragility: if Microsoft Learn URL structure changes or MCP tool becomes unavailable, skill loses value without offline fallback content
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026

Reviews

Add this skill to your library to leave a review.

No reviews yet

Be the first to share your experience.

Use MicrosoftDocs/microsoft-foundry-local in your dev environment

Start a Developer trial

Command Palette

Search for a command to run...