Struct SkillRegistry 

pub struct SkillRegistry { /* private fields */ }

Central skill lifecycle manager.

Tracks both code-based skills (registered via Skill trait) and file-based skills (discovered from SKILL.md files). Provides:

• Catalog generation for system-prompt injection (Tier 1)
• Activation tracking with deduplication (Tier 2)
• Resource access from activated skill directories (Tier 3)

Implementations

impl SkillRegistry

pub fn new() -> SkillRegistry

pub fn register_descriptor(&mut self, descriptor: SkillDescriptor)

Register a discovered file-based skill descriptor.

pub fn register_descriptor_with_legacy( &mut self, descriptor: SkillDescriptor, legacy_instructions: Option<String>, )

Register a discovered file-based skill descriptor and its legacy instructions.

pub fn set_sandbox_manager(&mut self, manager: Arc<SandboxManager>)

Attach a sandbox manager used for inline command execution during activation.

pub fn get_descriptor(&self, name: &str) -> Option<&SkillDescriptor>

Get a descriptor by name.

pub fn list_descriptors(&self) -> Vec<&SkillDescriptor>

List all discovered file-based skill descriptors.

pub fn descriptor_count(&self) -> usize

Number of discovered file-based skills.

pub fn catalog_prompt(&self) -> Option<String>

Generate the skill catalog text for system-prompt injection.

Returns None if no file-based skills are available (caller should omit the catalog section entirely per spec).

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

List all available skill names (for activate_skill tool enum constraint).

pub fn mark_activated(&mut self, name: &str) -> bool

Mark a skill as activated. Returns false if already activated (dedup).

pub fn is_activated(&self, name: &str) -> bool

Check whether a skill has been activated in this session.

pub fn activated_count(&self) -> usize

Number of activated skills.

pub async fn activate(&mut self, name: &str) -> Result<SkillContent, ReactError>

Activate a skill: read its full content from disk, execute inline commands, and substitute variables.

Returns the structured SkillContent or an error. Automatically marks the skill as activated.

pub async fn activate_with_args( &mut self, name: &str, args: &[String], source: SkillSource, ) -> Result<SkillContent, ReactError>

Activate a skill with user-provided arguments and source context.

This is the full activation path that:

1. Reads the SKILL.md body
2. Falls back to legacy frontmatter instructions if body is empty
3. Substitutes variables (${SKILL_DIR}, ${SESSION_ID}, ${ARGUMENTS}, etc.)
4. Executes inline commands (!`cmd` and ```! cmd ```), using the configured sandbox path when available, or the direct fallback with minimal env + best-effort timeout termination otherwise
5. Enumerates bundled resources

pub fn record_code_skill(&mut self, info: SkillInfo)

Record a code-based skill that was installed via add_skill.

pub fn has_code_skill(&self, name: &str) -> bool

Check if a code-based skill is installed.

pub fn get_code_skill(&self, name: &str) -> Option<&SkillInfo>

Get a code-based skill’s info.

pub fn list_code_skills(&self) -> Vec<&SkillInfo>

List all installed code-based skills.

pub fn is_installed(&self, name: &str) -> bool

Check if a skill (code-based or file-based) is installed/discovered.

pub fn count(&self) -> usize

Total number of skills (code + file-based).

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

List all installed skills as SkillInfo (unified view).

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

Get a skill’s info by name (code-based only, for backward compat).

Trait Implementations

impl Default for SkillRegistry

fn default() -> SkillRegistry

Returns the “default value” for a type.