agentskills-agentframework 0.1.0

Microsoft Agent Framework integration for the Agent Skills format (https://agentskills.io)

agentskills-agentframework

Microsoft Agent Framework integration for the Agent Skills SDK — turn a skill registry into Agent Framework tools.

Generates a set of Microsoft Agent Framework FunctionTool instances from a SkillRegistry, ready to be passed to any Agent Framework agent.

Installation

pip install agentskills-agentframework

Requires Python 3.12+. Installs agentskills-core and agent-framework as dependencies.

Usage

from agentskills_core import SkillRegistry
from agentskills_fs import LocalFileSystemSkillProvider
from agentskills_agentframework import get_tools, get_tools_usage_instructions

# Set up registry
provider = LocalFileSystemSkillProvider(Path("./skills"))
registry = SkillRegistry()
await registry.register("incident-response", provider)

# Build tools + system prompt
tools = get_tools(registry)
catalog = await registry.get_skills_catalog(format="xml")
instructions = get_tools_usage_instructions()
system_prompt = f"{catalog}\n\n{instructions}"

Pass tools to your Agent Framework agent and inject system_prompt into the instructions. The catalog tells the agent what skills exist; the usage instructions tell it how to use the tools.

Generated Tools

Tool	Parameters	Description
get_skill_metadata	skill_id	Get structured metadata (name, description, etc.)
get_skill_body	skill_id	Load the full markdown instructions
get_skill_reference	skill_id, name	Read a reference document
get_skill_script	skill_id, name	Read a script
get_skill_asset	skill_id, name	Read an asset

All tools are async-compatible (FunctionTool with @tool decorator).

API

get_tools(registry: SkillRegistry) -> list[FunctionTool]

Returns a list of Agent Framework function tools bound to the given registry.

get_tools_usage_instructions() -> str

Returns a markdown string explaining the progressive-disclosure workflow — read metadata, then body, then fetch resources on demand. Designed for system-prompt injection alongside the skill catalog.

Example

See examples/agent-framework/ for full working demos.

License

MIT