ai-agents-for-beginners: Skill for Claude Code

.agents/skills/local-ai-agents/SKILL.md

local-ai-agents is a skill for Claude Code, Codex from microsoft/ai-agents-for-beginners. It costs 200 tokens per session (1,160 once invoked), scanned A, original, MIT.

A guide for building AI agents that run on a developer's own computer using Microsoft Foundry Local and Qwen models. It covers local models, local tools, document search, and local MCP servers.

In plain words
What is it for?
Use it to connect a local model to tools, search local documentation with Chroma, run local MCP servers, or combine local and cloud models.
Why use it?
Running the agent locally can support privacy, offline use, and lower dependence on cloud inference.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is microsoft/ai-agents-for-beginners's own configuration. It tells Claude Code and Codex how to work on ai-agents-for-beginners itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything ai-agents-for-beginners configures →

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is Companion skill for [Lesson 17 – Creating Local AI Agents](../../../17-creating-local-ai-agents/README.md)..

About the project

AI Agents for Beginners is a course that teaches the fundamentals of building AI agents through a sequence of lessons. People learning generative AI and agent development use it to study topics and frameworks including AutoGen and Semantic Kernel. The catalogue entries provide skills, instructions, and an agent related to the course.

microsoft/ai-agents-for-beginners · 74,246 stars · on GitHub · aka.ms

Reuse

Borrowing it

Nothing to install: this file belongs to microsoft/ai-agents-for-beginners. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/microsoft/ai-agents-for-beginners/main/.agents/skills/local-ai-agents/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for local-ai-agents

README.md
[![agentmods](https://agentmods.dev/badge/skills/microsoft/ai-agents-for-beginners/local-ai-agents/github.svg)](https://agentmods.dev/skills/microsoft/ai-agents-for-beginners/local-ai-agents)
Your own site
<a href="https://agentmods.dev/skills/microsoft/ai-agents-for-beginners/local-ai-agents"><img src="https://agentmods.dev/badge/skills/microsoft/ai-agents-for-beginners/local-ai-agents/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for local-ai-agents

Your own site · 80×15
<a href="https://agentmods.dev/skills/microsoft/ai-agents-for-beginners/local-ai-agents"><img src="https://agentmods.dev/badge/skills/microsoft/ai-agents-for-beginners/local-ai-agents.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 200 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,160 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk fail 6 Sept 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00200 $0.01160
Opus 5 $0.00100 $0.00580
Sonnet 5 $0.00040 $0.00232
Haiku 4.5 $0.00020 $0.00116

Measured 10d ago against content hash b06b343808df, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

local-ai-agents scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/local-ai-agents/SKILL.md · 97 lines

How it starts

The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Creating Local AI Agents with Foundry Local and Qwen

Companion skill for Lesson 17 – Creating Local AI Agents. Use it to help a learner build an agent that reasons, calls tools, and searches documentation entirely on their own machine — no cloud inference. Ground every recommendation in the lesson content and the runnable notebook.

Triggers

Activate this skill when a learner wants to:

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

Core mental model

An SLM trades breadth for privacy, cost, and offline operation. The winning strategy: let the SLM orchestrate and let tools do the heavy lifting. The model does not need to know the codebase — it needs to know when to call read_file and search_docs. That plays to an SLM's strength (bounded decisions like tool selection) and away from its weakness (broad knowledge, long multi-hop reasoning).

Why these specific pieces

  • Foundry Local exposes an OpenAI-compatible HTTP endpoint, so cloud agent code transfers by changing only base_url (and using a local placeholder API key). It also auto-selects the best build (CPU/GPU/NPU) for the machine.
  • Qwen models are trained for function calling and emit well-formed tool calls consistently — this is what turns a local chat model into a local agent.
  • Chroma runs in-process and stores vectors on disk, so the whole RAG pipeline (embed → store → retrieve → reason) stays local.
  • MCP is a transport, not a cloud service: an MCP server can run locally over stdio.

Setup essentials

foundry model run qwen2.5-7b-instruct
foundry service status
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)  # local placeholder

Read the full file on GitHub · 97 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 97 lines · 200 tokens per session scan A b06b343808df

Subscribe to this mod's changes

local-ai-agents is a skill published in the GitHub repository microsoft/ai-agents-for-beginners (74,246 stars, last pushed 13d ago), licensed MIT. It adds 200 tokens to every session and 1,160 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

neuron-test-engineer

Write tests for Neuron AI agents, RAG systems, workflows, and tools using the built-in testing utilities. Use this skill when the user mentions testing agents, writing unit tests, mocking AI providers, testing tool execution, verifying RAG retrieval, testing workflow behavior, or creating test cases for Neuron AI…

neuron-core/neuron-ai · 94 tokens

neuron-evaluation-engineer

Create and run AI evaluations with datasets, assertions, and output drivers in Neuron AI. Use this skill whenever the user mentions evaluation, testing AI systems, creating evaluators, dataset-driven testing, assertion-based validation, or wants to measure AI system performance. Also trigger for tasks involving…

neuron-core/neuron-ai · 77 tokens

neuron-structured-output

Design and implement structured output classes for Neuron AI agents using SchemaProperty attributes and validation rules. Use this skill when the user mentions structured output, JSON schema extraction, data validation, output classes, DTOs for AI responses, extracting structured data from LLM, or configuring property…

neuron-core/neuron-ai · 104 tokens

neuron-rag-specialist

Implement RAG (Retrieval-Augmented Generation) with Neuron AI including vector stores, embeddings providers, document loaders, and retrieval strategies. Use this skill whenever the user mentions RAG, retrieval, vector search, document retrieval, semantic search, knowledge bases, chat with documents, or wants to build…

neuron-core/neuron-ai · 95 tokens

rag-evaluation

Comprehensive RAG evaluation with retrieval metrics, generation quality, and end-to-end testing. Use this skill when measuring and improving RAG system performance. Activate when: RAG evaluation, RAGAS, retrieval metrics, generation quality, RAG testing, MRR, recall, faithfulness.

latestaiagents/agent-skills · 63 tokens

llm-fallback-chains

Use this skill when implementing fallback strategies for LLM applications. Activate when the user needs graceful degradation for AI services, multi-provider failover, handling LLM outages, or building resilient AI systems.

latestaiagents/agent-skills · 52 tokens