Crate synwire_agent_skills 

Agent skills runtime for Synwire.

This crate implements the agentskills.io specification for discoverable, composable agent skills, extended with Synwire-specific runtime hints.

Overview

A skill is a directory containing:

• SKILL.md — manifest (YAML frontmatter) + instructions body
• scripts/ — optional runtime scripts
• references/ — optional reference material
• assets/ — optional static assets

Skills are discovered from two locations:

• Global: $DATA/<product>/skills/
• Project-local: .<product>/skills/

Quick start

use std::path::Path;
use synwire_agent_skills::{loader::SkillLoader, registry::SkillRegistry};

let loader = SkillLoader::new();
let entries = loader.scan(Path::new("/path/to/skills")).await?;

let mut registry = SkillRegistry::new();
for entry in entries {
    registry.register(entry);
}

for (name, desc) in registry.list_names_and_descriptions() {
    println!("{name}: {desc}");
}

Modules

error

Error types for the agent skills crate.

loader

Directory scanner that discovers SKILL.md files and produces SkillEntry values.

manifest

SKILL.md frontmatter parser following the agentskills.io specification.

registry

In-memory skill registry with progressive disclosure support.

runtime

Runtime execution layer for agent skills.