Struct SkillsService 

pub struct SkillsService<'a> { /* private fields */ }

Single source of truth for skill + skill-bundle operations.

Holds an immutable reference to Config and the install-root path. Reads are filesystem operations against the resolved bundle directories; writes go through the matching helpers in super::scaffold, super::bundle, and super::document so a single rule lives in a single place.

Implementations

impl<'a> SkillsService<'a>

pub fn new(config: &'a Config, install_root: impl Into<PathBuf>) -> Self

pub fn install_root(&self) -> &Path

pub fn resolve_ref( &self, name: &str, bundle: Option<&str>, ) -> Result<SkillRef, ServiceError>

Resolve a (name, bundle?) pair into a unique SkillRef per the disambiguation rule defined in super::reference::resolve.

pub fn list_bundles(&self) -> Result<Vec<BundleSummary>, ServiceError>

One BundleSummary per configured bundle, in HashMap order.

pub fn list_skills( &self, bundle_filter: Option<&str>, ) -> Result<Vec<SkillSummary>, ServiceError>

All skills in bundle_filter (or all bundles when None). Skips any child directory that’s missing a canonical or deprecated manifest.

pub fn read_skill( &self, target: &SkillRef, ) -> Result<SkillDocument, ServiceError>

Read the SKILL.md for a resolved skill.

pub fn write_skill( &self, target: &SkillRef, doc: &SkillDocument, ) -> Result<(), ServiceError>

Overwrite the SKILL.md for a resolved skill.

pub fn scaffold_skill( &self, target: &SkillRef, frontmatter: SkillFrontmatter, opts: ScaffoldOptions, ) -> Result<PathBuf, ServiceError>

Materialize a brand-new skill on disk per the canonical layout.

pub fn remove_skill( &self, target: &SkillRef, mode: RemoveMode, ) -> Result<(), ServiceError>

Archive or purge a skill directory.