talos_skill/lib.rs
1//! SKILL.md parser and loader for Talos agent skills.
2//!
3//! This crate discovers and parses `SKILL.md` files from configured search paths.
4//! Each skill consists of YAML frontmatter (between `---` delimiters) followed by
5//! a Markdown body containing instructions.
6//!
7//! # Discovery Paths
8//!
9//! Skills are discovered from three locations (in priority order):
10//! 1. `.talos/skills/` — project-local skills
11//! 2. `~/.talos/skills/` — user-global skills
12//! 3. Parent directories up to git root — inherited skills
13//!
14//! # SKILL.md Format
15//!
16//! ```markdown
17//! ---
18//! name: my-skill
19//! description: A skill that does something useful
20//! triggers:
21//! - keyword1
22//! - keyword2
23//! ---
24//!
25//! # Instructions
26//!
27//! Detailed markdown instructions go here...
28//! ```
29
30mod error;
31mod loader;
32mod manager;
33mod parser;
34mod token;
35mod types;
36
37pub use error::{Result, SkillError};
38pub use loader::SkillLoader;
39pub use manager::SkillManager;
40pub use token::estimate_tokens;
41pub use types::{Skill, SkillDisclosure, SkillFrontmatter, SkillIndex};
42
43#[cfg(test)]
44#[allow(warnings)]
45mod tests;