1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
//! Agent Skills support for extended agent capabilities.
//!
//! This module implements the [Agent Skills](https://agentskills.io) open format,
//! allowing agents to discover and use skills for extended capabilities.
//!
//! # Overview
//!
//! Skills are folders containing a `SKILL.md` file with YAML frontmatter and
//! Markdown instructions:
//!
//! ```text
//! my-skill/
//! ├── SKILL.md # Required: metadata + instructions
//! ├── scripts/ # Optional: executable code
//! ├── references/ # Optional: documentation
//! └── assets/ # Optional: templates, resources
//! ```
//!
//! # Usage
//!
//! ```rust,ignore
//! use agent_air_runtime::skills::{SkillDiscovery, SkillRegistry};
//!
//! // Create discovery with default paths
//! let discovery = SkillDiscovery::new();
//!
//! // Discover skills
//! let registry = SkillRegistry::new();
//! for result in discovery.discover() {
//! match result {
//! Ok(skill) => {
//! println!("Found skill: {}", skill.metadata.name);
//! registry.register(skill);
//! }
//! Err(e) => eprintln!("Error: {}", e),
//! }
//! }
//!
//! // Generate XML for system prompt
//! let xml = registry.to_prompt_xml();
//! ```
pub use SkillDiscovery;
pub use parse_skill_md;
pub use SkillRegistry;
pub use ;