Struct SkillRegistry 

pub struct SkillRegistry { /* private fields */ }

Skill registry for managing available skills

Provides skill registration, loading from directories, and lookup by name. Optionally validates skills before registration.

Implementations

impl SkillRegistry

pub fn new() -> Self

Create a new empty skill registry

pub fn with_builtins() -> Self

Create a registry with built-in skills

pub fn fork(&self) -> Self

Fork this registry into an independent copy.

The fork shares no state with the original — skills added to the fork do not affect the source registry. The validator is preserved so that session and delegated-agent registries keep the same safety policy.

pub fn set_validator(&self, validator: Arc<dyn SkillValidator>)

Set the skill validator (safety gate)

pub fn register(&self, skill: Arc<Skill>) -> Result<(), SkillValidationError>

Register a skill with validation

If a validator is set, the skill must pass validation before registration. Returns an error if validation fails.

pub fn register_unchecked(&self, skill: Arc<Skill>)

Register a skill without validation (for built-in skills)

pub fn get(&self, name: &str) -> Option<Arc<Skill>>

Get a skill by name

pub fn list(&self) -> Vec<String>

List all registered skill names

pub fn all(&self) -> Vec<Arc<Skill>>

Get all registered skills

pub fn load_from_dir(&self, dir: impl AsRef<Path>) -> Result<usize>

Load skills from a directory

Recursively scans the directory for skill files and attempts to parse them.

Supported layouts:

• path/to/skill.md
• path/to/skill/SKILL.md

Candidate files are processed in deterministic sorted order. Files that fail to parse are skipped with debug logging; validation failures are logged as warnings.

pub fn load_from_file(&self, path: impl AsRef<Path>) -> Result<Arc<Skill>>

Load a single skill from a file

pub fn remove(&self, name: &str) -> Option<Arc<Skill>>

Remove a skill by name

pub fn clear(&self)

Clear all skills

pub fn len(&self) -> usize

Get the number of registered skills

pub fn is_empty(&self) -> bool

Check if the registry is empty

pub fn by_kind(&self, kind: SkillKind) -> Vec<Arc<Skill>>

Get all skills of a specific kind

pub fn by_tag(&self, tag: &str) -> Vec<Arc<Skill>>

Get all skills with a specific tag

pub fn personas(&self) -> Vec<Arc<Skill>>

Get all persona-kind skills

Personas are session-level system prompts bound at session creation. They are NOT injected into the global system prompt via to_system_prompt().

pub fn search(&self, query: &str, limit: usize) -> Vec<Arc<Skill>>

Search discoverable instruction/tool skills by name, tag, description, or content.

pub fn to_system_prompt(&self) -> String

Generate system prompt content from all instruction skills

Concatenates the content of all instruction-type skills for injection into the system prompt. Persona-kind skills are excluded — they are bound per-session, not globally. Generate the system prompt fragment for this registry.

Only emits a skill directory (name + description) — NOT the full skill content. Full content is injected on-demand via match_skills when a user request matches.

pub fn match_skills(&self, user_input: &str) -> String

Return the full content of skills relevant to the given user input.

Matches by checking if any skill name or tag appears in the input (case-insensitive). Returns an empty string if no skills match — caller should not inject anything.

Trait Implementations

impl Default for SkillRegistry

fn default() -> Self

Returns the “default value” for a type.