mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00

Files

T

SergeyMenshykh 0fcbe7e105 .NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

* initial commit

* address comments

* address comments

* address comments

* address  comments

* rename executor to runner to align naming with python implementation

* rename runner execute method to run method

* remove poc leftovers and fix compilation issues

* make script runner optional

* remove unnecessary pragmas

* make resources and scripts props virtual

* address comments

* update comment for name validation regex

* address comments

0fcbe7e105 · 2026-03-26 22:27:17 +00:00

History

skills/unit-converter

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

Agent_Step01_FileBasedSkills.csproj

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

Program.cs

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

README.md

.NET: [Breaking] Restructure agent skills to use multi-source architecture (#4871 )

2026-03-26 22:27:17 +00:00

README.md

File-Based Agent Skills Sample

This sample demonstrates how to use file-based Agent Skills with a ChatClientAgent.

What it demonstrates

Discovering skills from SKILL.md files on disk via AgentFileSkillsSource
The progressive disclosure pattern: advertise → load → read resources → run scripts
Using the AgentSkillsProvider constructor with a skill directory path and script executor
Running file-based scripts (Python) via a subprocess-based executor

Skills Included

unit-converter

Converts between common units (miles↔km, pounds↔kg) using a multiplication factor.

references/conversion-table.md — Conversion factor table
scripts/convert.py — Python script that performs the conversion

Running the Sample

Prerequisites

.NET 10.0 SDK
Azure OpenAI endpoint with a deployed model
Python 3 installed and available as python3 on your PATH

Setup

export AZURE_OPENAI_ENDPOINT="https://your-endpoint.openai.azure.com/"
export AZURE_OPENAI_DEPLOYMENT_NAME="gpt-4o-mini"

Run

dotnet run

Expected Output

Converting units with file-based skills
------------------------------------------------------------
Agent: Here are your conversions:

1. **26.2 miles → 42.16 km** (a marathon distance)
2. **75 kg → 165.35 lbs**