Struct SkillManager 

pub struct SkillManager { /* private fields */ }

Manages skills compatible with OpenClaw

Implementations

impl SkillManager

pub fn new(skills_dir: PathBuf) -> Self

pub fn with_dirs(dirs: Vec<PathBuf>) -> Self

Create with multiple skill directories (for precedence)

pub fn set_registry(&mut self, url: &str, token: Option<String>)

Configure the ClawHub registry URL and optional auth token.

pub fn primary_skills_dir(&self) -> Option<&Path>

Get the primary skills directory (last in the list — user’s writable dir). Skills are loaded from first to last, with later dirs overriding earlier ones. Installation goes to the last dir (user-writable, highest priority).

pub fn load_skills(&mut self) -> Result<()>

Load skills from all configured directories Later directories have higher precedence (override earlier ones by name)

pub fn check_gates(&self, skill: &Skill) -> GateCheckResult

Check if a skill passes its gating requirements

pub fn get_skills(&self) -> &[Skill]

Get all loaded skills

pub fn get_eligible_skills(&self) -> Vec<&Skill>

Get only enabled skills that pass gating

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

Get a specific skill by name

pub fn set_skill_enabled(&mut self, name: &str, enabled: bool) -> Result<()>

Enable or disable a skill

pub fn generate_prompt_context(&self) -> String

Generate prompt context for all eligible skills

pub fn get_skill_instructions(&self, name: &str) -> Option<String>

Get full instructions for a skill (for when agent reads SKILL.md)

pub fn create_skill( &mut self, name: &str, description: &str, instructions: &str, metadata_json: Option<&str>, ) -> Result<PathBuf>

Create a new skill on disk from name, description, and instructions.

Writes <primary_skills_dir>/<name>/SKILL.md with YAML frontmatter and the supplied markdown body, then reloads the skill list so the new skill is immediately available.

pub fn link_secret(&mut self, skill_name: &str, secret_name: &str) -> Result<()>

Link a vault credential to a skill so the skill can access it via the SkillOnly policy.

pub fn unlink_secret( &mut self, skill_name: &str, secret_name: &str, ) -> Result<()>

Unlink a vault credential from a skill.

pub fn get_linked_secrets(&self, skill_name: &str) -> Vec<String>

Return the linked secrets for a skill (empty vec if not found).

pub fn remove_skill(&mut self, name: &str) -> Result<()>

Remove a skill by name. If it was installed from a registry, its directory is deleted from disk.

pub fn skill_info(&self, name: &str) -> Option<String>

Return a human-readable summary of a skill.

pub fn search_registry(&self, query: &str) -> Result<Vec<RegistryEntry>>

Search the ClawHub registry for skills matching a query.

If the registry is unreachable, falls back to matching against locally-loaded skills so the user still gets useful results.

pub fn install_from_registry( &mut self, name: &str, version: Option<&str>, ) -> Result<Skill>

Install a skill from the ClawHub registry into the primary skills directory. Returns the installed Skill.

pub fn publish_to_registry(&self, skill_name: &str) -> Result<String>

Publish a local skill to the ClawHub registry.

pub fn registry_url(&self) -> &str

Return the registry URL for display or browser opening.

pub fn registry_token(&self) -> Option<&str>

Return the registry auth token (if set).

pub fn auth_login(&self, username: &str, password: &str) -> Result<AuthResponse>

Authenticate with ClawHub using a username and password. Returns the API token on success, which should be saved to config.

pub fn auth_token(&self, token: &str) -> Result<AuthResponse>

Authenticate with ClawHub using a pre-existing API token. Validates the token and returns the profile info.

pub fn auth_status(&self) -> Result<String>

Check authentication status (whether a token is configured and valid).

pub fn trending( &self, category: Option<&str>, limit: Option<usize>, ) -> Result<Vec<TrendingEntry>>

Fetch trending / popular skills from the ClawHub registry.

pub fn categories(&self) -> Result<Vec<Category>>

Fetch available categories from the ClawHub registry.

pub fn profile(&self) -> Result<ClawHubProfile>

Fetch the authenticated user’s profile from ClawHub.

pub fn starred(&self) -> Result<Vec<StarredEntry>>

Fetch the authenticated user’s starred skills from ClawHub.

pub fn star(&self, skill_name: &str) -> Result<String>

Star a skill on ClawHub.

pub fn unstar(&self, skill_name: &str) -> Result<String>

Unstar a skill on ClawHub.

pub fn registry_info(&self, skill_name: &str) -> Result<RegistrySkillDetail>

Get detailed info about a registry skill (not a locally installed one).