Struct FsSkill 

pub struct FsSkill { /* private fields */ }

A filesystem-backed skill.

Each FsSkill owns its root directory and SKILL.md path. Resource loading and script execution are performed relative to root_dir.

Use FsSkill::discover to scan a directory for skills, or FsSkill::discover_roots for multiple directories.

Implementations

impl FsSkill

pub fn discover(root: impl Into<PathBuf>) -> Result<DiscoveryResult, SkillError>

Discover all valid skills under a single root directory.

pub fn discover_roots( roots: Vec<PathBuf>, ) -> Result<DiscoveryResult, SkillError>

Discover skills under multiple root directories.

Returns an error if duplicate skill IDs are found across roots.

pub fn into_arc_skills(skills: Vec<FsSkill>) -> Vec<Arc<dyn Skill>>

Collect discovered skills into a vec of trait objects.

Trait Implementations

impl Clone for FsSkill

fn clone(&self) -> FsSkill

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FsSkill

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Skill for FsSkill

fn meta(&self) -> &SkillMeta

Metadata for this skill (id, name, description, allowed_tools).

fn read_instructions<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<String, SkillError>> + Send + 'async_trait>>

where 'life0: 'async_trait, FsSkill: 'async_trait,

Read the raw SKILL.md content.

fn load_resource<'life0, 'life1, 'async_trait>( &'life0 self, kind: SkillResourceKind, path: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<SkillResource, SkillError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, FsSkill: 'async_trait,

Load a resource (reference or asset) by relative path.

fn run_script<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, script: &'life1 str, args: &'life2 [String], ) -> Pin<Box<dyn Future<Output = Result<ScriptResult, SkillError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, FsSkill: 'async_trait,

Run a script by relative path with arguments.