Skip to main content

brainwires_skills/
lib.rs

1#![deny(missing_docs)]
2//! # brainwires-skills
3//!
4//! Agent skills system — SKILL.md parsing, registry, routing, and execution.
5//!
6//! Skills are markdown-based packages that extend agent capabilities using
7//! progressive disclosure:
8//! - At startup: only metadata (name, description) is loaded for fast matching
9//! - On activation: full SKILL.md content is loaded on-demand
10//!
11//! ## SKILL.md Format
12//!
13//! ```markdown
14//! ---
15//! name: review-pr
16//! description: Reviews pull requests for code quality and security issues.
17//! allowed-tools:
18//!   - Read
19//!   - Grep
20//! model: claude-sonnet-4
21//! metadata:
22//!   category: code-review
23//!   execution: subagent
24//! ---
25//!
26//! # PR Review Instructions
27//! ...
28//! ```
29
30pub mod executor;
31pub mod metadata;
32pub mod parser;
33pub mod registry;
34pub mod router;
35
36pub use executor::{ScriptPrepared, SkillExecutor, SubagentPrepared};
37pub use metadata::{
38    MatchSource, Skill, SkillExecutionMode, SkillMatch, SkillMetadata, SkillResult, SkillSource,
39};
40pub use parser::{parse_skill_file, parse_skill_metadata, render_template};
41pub use registry::SkillRegistry;
42pub use router::SkillRouter;