Skip to main content

Module skills

Module skills 

Source

Re-exports§

pub use bundle::BundleSummary;
pub use document::DocumentParseError;
pub use document::SkillDocument;
pub use frontmatter::SkillFrontmatter;
pub use reference::SkillRef;
pub use reference::SkillRefError;
pub use scaffold::ScaffoldError;
pub use scaffold::ScaffoldOptions;
pub use service::RemoveMode;
pub use service::ServiceError;
pub use service::SkillSummary;
pub use service::SkillsService;

Modules§

audit
bundle
Runtime-side bundle facade. The directory rules (default path, inside- shared/ containment, uniqueness) live in zeroclaw_config::skill_bundles so Config::validate and the SkillsService share one implementation. This module is a thin re-exporter plus the BundleSummary shape returned to surface callers.
constants
Canonical filenames + scaffold subdirs for the Agent Skills spec.
creator
document
Parse and serialize canonical SKILL.md files.
frontmatter
Canonical SKILL.md frontmatter.
improver
reference
Skill identity + the disambiguation rule that every surface goes through.
scaffold
Scaffold a new skill on disk: write SKILL.md + create optional scripts/, references/, assets/ subdirs per the canonical layout.
service
Public service surface every consumer (CLI, gateway, future TUI) uses to read and mutate skills + skill bundles. There is no second implementation — drift is closed by construction.
skill_http
skill_tool
testing

Structs§

Skill
A skill is a user-defined or community-built capability. Skills live in ~/.zeroclaw/workspace/skills/<name>/SKILL.md and can include tool definitions, prompts, and automation scripts.
SkillTool
A tool defined by a skill (shell command, HTTP call, etc.)

Enums§

BundleError
SkillTier
Trust tier of a skill listed in the zeroclaw-skills registry.

Functions§

build_install_tier_banner
Build the install-time tier banner. Official skills get a single informational line; everything else (including Featured and the missing-tag fallback) gets the Community warn block.
init_skills_dir
Initialize the skills directory with a README
install_clawhub_skill_source
install_git_skill_source
install_local_skill_source
install_registry_skill_source
is_clawhub_source
is_git_source
is_registry_source
load_skills
Load all skills from the workspace skills directory
load_skills_for_agent
Per-agent skill discovery. Walks [agents.<agent_alias>].skill_bundles, resolves each bundle’s directory via the shared zeroclaw_config::skill_bundles::resolve_directory helper, and unions the skills under each bundle with whatever load_skills_with_config would return for the install (workspace skills, open-skills, plugin skills). Empty skill_bundles falls back to the install-wide set — keeps freshly-migrated agents working until the operator assigns a bundle.
load_skills_from_directory
load_skills_with_config
Load skills using runtime config values (preferred at runtime).
load_skills_with_open_skills_settings
Load skills using explicit open-skills settings.
lookup_registry_skill_tier
Look up a skill in <registry_dir>/registry.json and return its trust tier and version. Returns (SkillTier::Unknown, None) if the index file is missing, malformed, or does not list the skill.
print_install_tier_banner
Print the install-time tier banner to stdout.
skills_dir
Get the skills directory path
skills_to_prompt
Build the “Available Skills” system prompt section with full skill instructions.
skills_to_prompt_with_mode
Build the “Available Skills” system prompt section with configurable verbosity.
skills_to_tools
Convert skill tools into callable Tool trait objects.
skills_to_tools_with_context