agentskills-agentframework 0.2.1

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.

Note: agent-framework is currently a pre-release dependency (>=1.0.0b1). The constraint will be updated once a stable release is published.

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.

Error Handling

Scenario	Exception
Skill not found in registry	SkillNotFoundError
Resource not found in skill	ResourceNotFoundError
Provider errors (HTTP, filesystem)	AgentSkillsError

All exceptions inherit from AgentSkillsError (from agentskills-core).

Note: Binary content (scripts, assets, references) is decoded as UTF-8 with errors="replace". Non-decodable bytes are replaced with the Unicode replacement character (�).

License

MIT