Files
agent-framework/dotnet/samples/02-agents/AgentSkills/Agent_Step04_MixedSkills
3fc1d00026 .NET: skill as class (#5027)
* add class-based skills

* address formating issues

* Remove generated filtered-unit.slnx and add to .gitignore

The filtered solution file is generated dynamically by
eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
risks it becoming stale and out-of-sync with the real solution.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove generated filtered-unit.slnx and add to .gitignore

The filtered solution file is generated dynamically by
eng/scripts/New-FilteredSolution.ps1 during CI. Checking it in
risks it becoming stale and out-of-sync with the real solution.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* consolidate DI samples into one

* fix file encoding

* suppress compatibility warning

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-04-03 11:27:36 +00:00
..
2026-04-03 11:27:36 +00:00
2026-04-03 11:27:36 +00:00

Mixed Agent Skills Sample (Advanced)

This sample demonstrates an advanced scenario: combining multiple skill types in a single agent using AgentSkillsProviderBuilder.

Tip: For simpler, single-source scenarios, use the AgentSkillsProvider constructors directly — see Step01 (file-based), Step02 (code-defined), or Step03 (class-based).

What it demonstrates

  • Combining file-based, code-defined, and class-based skills in one provider
  • Using UseFileSkill and UseSkill on the builder to register different skill types
  • Aggregating skills from all sources into a single provider with automatic deduplication

When to use AgentSkillsProviderBuilder

The builder is intended for advanced scenarios where the simple AgentSkillsProvider constructors are insufficient:

Scenario Builder method
Mixed skill types — combine file-based, code-defined, and class-based skills UseFileSkill + UseSkill / UseSkills
Multiple file script runners — use different script runners for different file skill directories UseFileSkill / UseFileSkills with per-source scriptRunner
Skill filtering — include/exclude skills using a predicate UseFilter(predicate)

Skills Included

unit-converter (file-based)

Discovered from skills/unit-converter/SKILL.md on disk. Converts miles↔km, pounds↔kg.

volume-converter (code-defined)

Defined as AgentInlineSkill in Program.cs. Converts gallons↔liters.

temperature-converter (class-based)

Defined as TemperatureConverterSkill class in Program.cs. Converts °F↔°C↔K.

Running the Sample

Prerequisites

  • .NET 10.0 SDK
  • Azure OpenAI endpoint with a deployed model

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 with mixed skills (file + code + class)
------------------------------------------------------------
Agent: Here are your conversions:

1. **26.2 miles → 42.16 km** (a marathon distance)
2. **5 gallons → 18.93 liters**
3. **98.6°F → 37.0°C**