heartbit_core/skill/mod.rs
1//! Agent Skills: filesystem-based, progressively-disclosed capabilities.
2//!
3//! A *skill* is a directory containing a `SKILL.md` (YAML frontmatter + markdown
4//! body) plus optional bundled scripts and reference files, matching the Claude
5//! Agent Skills format. This module adds the two pieces the existing
6//! [`SkillTool`](crate::tool) lacked for SOTA parity:
7//!
8//! 1. [`SkillManifest`] — a strict `SKILL.md` frontmatter parser + validator.
9//! 2. [`SkillRegistry`] — discovery across skill directories with a Level-1
10//! catalog (`name: description`) for injection into the system prompt, so the
11//! model knows which skills exist and when to use them (progressive
12//! disclosure level 1). The body (level 2) and bundled files (level 3) load
13//! on demand via the skill tool and the `read` builtin.
14
15pub mod discovery;
16pub mod manifest;
17pub mod registry;
18
19pub use discovery::{catalog_for, catalog_from_dirs, search_dirs};
20pub use manifest::SkillManifest;
21pub use registry::SkillRegistry;