Skip to main content

rullama_skills/
lib.rs

1#![deny(missing_docs)]
2//! # rullama-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 manifest;
32pub mod metadata;
33pub mod package;
34pub mod parser;
35pub mod registry;
36#[cfg(feature = "skills-registry")]
37pub mod registry_client;
38pub mod router;
39pub mod tool_adapter;
40#[cfg(feature = "skills-signing")]
41pub mod verification;
42
43pub use executor::{ScriptPrepared, SkillExecutor, SubagentPrepared};
44pub use manifest::{SkillDependency, SkillManifest};
45pub use metadata::{
46    MatchSource, Skill, SkillExecutionMode, SkillMatch, SkillMetadata, SkillResources, SkillResult,
47    SkillSource,
48};
49pub use package::SkillPackage;
50pub use parser::{parse_skill_file, parse_skill_metadata, render_template};
51pub use registry::SkillRegistry;
52#[cfg(feature = "skills-registry")]
53pub use registry_client::RegistryClient;
54pub use router::SkillRouter;
55pub use tool_adapter::SkillToolExecutor;
56#[cfg(feature = "skills-signing")]
57pub use verification::SkillVerifier;