Official agent skill

Local AI Agents

by microsoft in microsoft/ai-agents-for-beginners

Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models.

OfficialMITAuto-check passedAI & LLM Engineering

Install Local AI Agents

skills CLI
$ npx skills add microsoft/ai-agents-for-beginners --skill local-ai-agents -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install microsoft/ai-agents-for-beginners local-ai-agents --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git skills-src && mkdir -p .claude/skills && cp -r skills-src/translations/pcm/.agents/skills/local-ai-agents .claude/skills/local-ai-agents && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
local-ai-agents
GitHub stars
77k
Token cost
~1.4k tokens
SKILL.md length
612 words
Files
1
Skills in repo
123
Repo updated
First seen
Licence
MIT

At a glance

Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models.

  • : run agent locally
  • SKILL.md covers Triggers, Core mental model, Why these specific pieces and Setup essentials, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • On-device agent

What it does

Local AI Agents is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization. Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models. E cover Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG wit Chroma, local MCP servers, hybrid cloud/local routing, and di privacy/cost/offline trade-offs. E based on Lesson 17 of AI Agents for Beginners. USE FOR: run agent locally, offline agent, on-device agent, Foundry Local, Qwen function calling, local tool calling, local…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Structured output and tool calling, MCP servers and GPU and accelerator computing. It works with Model Context Protocol, Qwen, OpenAI and Chroma. The repository describes itself as: 18 Lessons to Get Started Building AI Agents. The licence is MIT.

When your agent uses it

  • : run agent locally
  • On-device agent
  • Qwen function calling
  • Local tool calling

Example prompts

  • “/local-ai-agents”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 25b7985. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local AI Agents loads about 1.4k tokens when it runs. Until then it costs about 232 tokens; SKILL.md has 612 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~232
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from microsoft/ai-agents-for-beginners at commit 25b7985, republished under its MIT licence (© microsoft). 612 words, ~1,379 tokens.

Download SKILL.mdSave it as .claude/skills/local-ai-agents/SKILL.md (or your agent's skills folder).
name
local-ai-agents
description
Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models. E cover Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG wit Chroma, local MCP servers, hybrid cloud/local routing, and di privacy/cost/offline trade-offs. E based on Lesson 17 of AI Agents for Beginners. USE FOR: run agent locally, offline agent, on-device agent, Foundry Local, Qwen function calling, local tool calling, local RAG, Chroma vector database, local MCP server, privacy-preserving agent, hybrid local and cloud agent, small language model agent, engineering assistant for my machine. DO NOT USE FOR: deploying agents to di cloud at scale (use deploying-scalable-agents / Lesson 16), building your first agent concept (Lesson 01), Foundry (cloud) hosted agents, GPU cluster / server-side inference provisioning.
license
MIT

How to Create Local AI Agents wit Foundry Local and Qwen

Skill wey go help for Lesson 17 – Creating Local AI Agents. Use am to help person wey dey learn build agent wey sabi reason, dey call tools, and dey search documentation all na inside dem machine — no cloud inference. Make every recommendation stand gidigba for lesson content and the runnable notebook.

Triggers

Activate this skill when person wey dey learn want:

  • Run agent fully inside device for privacy, cost, or offline reasons.
  • Serve model locally with Foundry Local and connect via the OpenAI-compatible endpoint.
  • Use Qwen function-calling model to make local tool calls correct.
  • Add local RAG (Chroma) or local MCP server.
  • Design hybrid local/cloud routing way.

Core mental model

Small Language Model (SLM) dey trade wide knowledge for privacy, cost, and offline work. The best way: make the SLM dey organize and make tools carry the heavy work. The model no need to know the codebase — e need to know wen to call read_file and search_docs. Dis one dey play to SLM strength (small decisions like tool choice) and avoid hin weakness (big knowledge, long multi-hop reasoning).

Why these specific pieces

  • Foundry Local get OpenAI-compatible HTTP endpoint, so cloud agent code fit transfer by just changing base_url (and using local fake API key). E also dey choose best build (CPU/GPU/NPU) for machine.
  • Qwen models get epp to call functions and always dey give correct tool calls — na dis one make local chat model become local agent.
  • Chroma dey run inside process and dey store vectors for disk, so all RAG work (embed → store → retrieve → reason) remains local.
  • MCP na transport, no be cloud service: MCP server fit run local with stdio.

Setup essentials

bash
foundry model run qwen2.5-7b-instruct
foundry service status
python
from foundry_local import FoundryLocalManager
from openai import OpenAI

manager = FoundryLocalManager("qwen2.5-7b-instruct")
client = OpenAI(base_url=manager.endpoint, api_key=manager.api_key)  # lokal plassholder

About 8 GB RAM na minimum wey make sense; GPU/NPU fit help but dem no mandatory.

Key patterns wey you fit repeat

Show the learner the notebook 17-local-agent-foundry-local.ipynb:

  • Sandboxed tools: every file tool dey resolve paths and no allow anything wey dey outside one project root — even if na local, tool dey run wit user permissions.
  • Tool-calling loop: register tools with OpenAI tools schema, run requested tools locally, give the results back, keep am up till final answer.
  • Local RAG: put docs inside Chroma collection; search_docs go return top-k chunks.
  • Local MCP: connect to local server thru stdio; scope am to project directory and check outputs well.
Show full SKILL.md (228 more words)Show less

Hybrid routing (local as one of the models)

SituationWhere e dey run
Sensitive data / offlineLocal SLM
Simple, bounded taskLocal SLM (cheap, fast)
Hard multi-hop reasoning on non-sensitive dataCloud model
Cloud outageLocal SLM (graceful degradation)

Dis one dey mirror di model-routing idea from Lesson 16, with workstation as one of di routes. Make you like designs wey fit fall back to local so agent go degrade in quality, no be just fail completely.

Guardrails for the assistant

  • Keep every file/tool work confined to sandboxed project directory.
  • No send code or data go cloud when the learner talk say na privacy/offline e wan — keep everything local.
  • Set correct expectations for SLM quality; rely on tools and RAG, no be the model memorized knowledge.
  • Note say Lesson 17 no get Foundry Responses endpoint, so cloud smoke-test ka no go work — make sure by running notebook local.

<!-- CO-OP TRANSLATOR DISCLAIMER START -->

Disclaimer: Dis document don translate wit AI translation service Co-op Translator. Even tho we dey try make am correct, abeg make you know say automated translation fit get errors or mistakes. Di original document for dia own language na im be di correct source. For important info, make person wey sabi human translation do am. We no go responsible for any misunderstanding or wrong understanding wey fit happen because of dis translation.

<!-- CO-OP TRANSLATOR DISCLAIMER END -->

© microsoft, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in translations/pcm/.agents/skills/local-ai-agents of microsoft/ai-agents-for-beginners.

Open the folder on GitHubat commit 25b7985

Compare with similar skills

Local AI Agents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local AI Agents compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local AI Agents this skillmicrosoft/ai-agents-for-beginners77k—~1.4kAutomated safety check: PassMIT
Neurolink Guidejuspay/neurolink144—~1.4kAutomated safety check: PassMIT
Tool Designagentailor/fullstack-langgraph-nextjs-agent132—~3.2kAutomated safety check: PassMIT
Qianwenai Wikichujianyun/skills740—~717Automated safety check: PassCustom licence
Agent Tool Builderomer-metin/skills-for-antigravity162—~705Automated safety check: PassApache-2.0
Spring AI Integrationrrezartprebreza/spring-boot-skills298—~2.1kAutomated safety check: PassMIT

Similar skills

  • Neurolink Guide

    juspay/neurolink

    Guide for using the NeuroLink SDK and CLI. An agent skill from juspay/neurolink.

    144 GitHub stars~1.4k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Tool Design

    agentailor/fullstack-langgraph-nextjs-agent

    Design and verify tools that AI agents can actually use — for any framework or language (MCP servers, LangChain/LangGraph, function-calling, raw JSON schema; TypeScript, Python, or otherwise).

    132 GitHub stars~3.2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Qianwenai Wiki

    chujianyun/skills

    千问AI平台(Qianwen AI Platform / DashScope)官方文档离线知识库,用于检索并回答模型选择、API Key、OpenAI 兼容接口、DashScope SDK、文本与多模态生成、图像/视频/语音、Realtime API、Embedding、Reranking、Function Calling、MCP、批量调用、计费、Token Plan、API/SDK/CLI…

    740 GitHub stars~717 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Agent Tool Builder

    omer-metin/skills-for-antigravity

    Tools are how AI agents interact with the world. An agent skill from omer-metin/skills-for-antigravity.

    162 GitHub stars~705 tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check passed
  • Spring AI Integration

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when integrating LLMs, chat clients, embeddings, RAG pipelines, or AI agents into Spring Boot.

    298 GitHub stars~2.1k tokensUpdated 18 days ago
    AI & LLM EngineeringAuto-check passed
  • Spring AI Integration

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when integrating LLMs, chat clients, embeddings, RAG pipelines, or AI agents into Spring Boot.

    298 GitHub stars~2.5k tokensUpdated 18 days ago
    AI & LLM EngineeringAuto-check passed

More from microsoft/ai-agents-for-beginners

All 123 skills in this repo
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    A skill your agent uses when the user asks to create, scaffold, or edit Jupyter notebooks (.ipynb) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script…

    77k GitHub starsUsed in 8 repos~1k tokens
    Auto-check passed
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Migrate Python apps from Azure OpenAI Chat Completions to the Responses API.

    77k GitHub stars~6k tokensUpdated 20 days ago
    Auto-check: notes
  • Azure Openai To Responses

    microsoft/ai-agents-for-beginners

    Official

    Shift Python apps dem from Azure OpenAI Chat Completions go Responses API.

    77k GitHub stars~6k tokensUpdated 20 days ago
    Auto-check: notes
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    Kasuta, kui kasutaja palub luua, üles ehitada või redigeerida Jupyteri märkmikke (.ipynb) katsetuste, uurimiste või juhendite jaoks; eelista kaasasolevaid malle ja käivita abiskript newnotebook.py…

    77k GitHub stars~1.2k tokensUpdated 20 days ago
    Auto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    Käytetään, kun käyttäjä pyytää luomaan, alustamaan tai muokkaamaan Jupyter-muistikirjoja (.ipynb) kokeita, tutkimuksia tai opetusohjelmia varten; käytä mieluummin mukana olevia mallipohjia ja…

    77k GitHub stars~1.3k tokensUpdated 20 days ago
    Auto-check passed
  • Jupyter Notebook

    microsoft/ai-agents-for-beginners

    Official

    À utiliser lorsque l'utilisateur demande de créer, structurer ou modifier des notebooks Jupyter (.ipynb) pour des expériences, explorations ou tutoriels ; privilégiez les modèles fournis et exécutez…

    77k GitHub stars~1.4k tokensUpdated 20 days ago
    Auto-check passed

Questions about Local AI Agents

What does Local AI Agents do?

Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models. Local AI Agents is an agent skill from microsoft/ai-agents-for-beginners, published by the product's own GitHub organization. Build local-first AI agents wey dey run fully for developer workstation wit Microsoft Foundry Local and Qwen function-calling models.

When should I use Local AI Agents?

Local AI Agents fits situations like: : run agent locally; on-device agent; qwen function calling; local tool calling.

How do I install Local AI Agents in Claude Code?

Run `npx skills add microsoft/ai-agents-for-beginners --skill local-ai-agents -a claude-code`. Or copy the skill folder (translations/pcm/.agents/skills/local-ai-agents in microsoft/ai-agents-for-beginners) into .claude/skills/local-ai-agents in your project. Claude Code loads it when a task matches its description.

How do I install Local AI Agents in Codex?

Run `npx skills add microsoft/ai-agents-for-beginners --skill local-ai-agents -a codex`. Or copy the skill folder (translations/pcm/.agents/skills/local-ai-agents in microsoft/ai-agents-for-beginners) into .agents/skills/local-ai-agents in your project. Codex loads it when a task matches its description.

Can I use Local AI Agents in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add microsoft/ai-agents-for-beginners --skill local-ai-agents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-ai-agents, .gemini/skills/local-ai-agents, .github/skills/local-ai-agents and .opencode/skills/local-ai-agents in your project.

What does Local AI Agents need to run?

SKILL.md names no scripts, command-line tools or credentials: Local AI Agents is instructions for the agent only. Our summary lists: Python 3.

Does Local AI Agents access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Local AI Agents safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local AI Agents use?

Local AI Agents is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Local AI Agents use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local AI Agents?

Skills that share tags, products or a category with Local AI Agents: Neurolink Guide (juspay/neurolink, 144 stars), Tool Design (agentailor/fullstack-langgraph-nextjs-agent, 132 stars), Qianwenai Wiki (chujianyun/skills, 740 stars) and Agent Tool Builder (omer-metin/skills-for-antigravity, 162 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local AI Agents?

microsoft (a GitHub organization, an official publisher) maintains it in microsoft/ai-agents-for-beginners, which has 76,686 GitHub stars. The repository holds 123 skills in this directory. The repository was last updated on September 19, 2026.

Source: microsoft/ai-agents-for-beginners on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.