Skip to main content

Module skill

Module skill 

Source
Expand description

MuR skill ecosystem — see docs/superpowers/specs/2026-05-24-mur-skill-ecosystem-design.md.

Re-exports§

pub use capability::Capability;
pub use capability::CapabilityViolation;
pub use capability::allowed_for;
pub use capability::check_capabilities;
pub use constraint::Constraint;
pub use constraint::ConstraintError;
pub use credit::CreditEntry;
pub use credit::CreditEvidence;
pub use credit::CreditKind;
pub use evolution::EvolutionEvent;
pub use gene::GeneDiff;
pub use gene::McpGene;
pub use gene::SkillGene;
pub use gene::StepGene;
pub use gene::TriggerGene;
pub use hash::DriftStatus;
pub use hash::content_hash_for_trust;
pub use hash::content_sha256;
pub use hash::ct_eq_hex;
pub use hash::drift_status;
pub use hash::sha256_hex;
pub use inventory::McpInventory;
pub use lifecycle::calculate_decay;
pub use lifecycle::half_life_days;
pub use lifecycle::next_state;
pub use lifecycle::on_promotion;
pub use lifecycle::transition_allowed;
pub use loader::LoadedSkill;
pub use loader::SkillScope;
pub use loader::load_all;
pub use lockfile::LockfileError;
pub use lockfile::SkillLock;
pub use mcp::McpRequirement;
pub use mcp::ParseCapabilityError;
pub use mcp::SkillCapability;
pub use mcp::validate_requirements;
pub use parser::ParseError;
pub use parser::parse_canonical;
pub use parser::parse_legacy_markdown;
pub use parser::parse_markdown;
pub use parser::serialize_canonical;
pub use parser::serialize_markdown;
pub use parser::yaml_to_markdown;
pub use resolve::Resolution;
pub use resolve::resolve_step;
pub use sign::SKILL_PAYLOAD_TYPE;
pub use sign::SignError;
pub use sign::sign_manifest;
pub use sign::verify_manifest;
pub use stats::LifecycleState;
pub use stats::SkillStats;
pub use store::StoreError;
pub use store::agent_skill_dir;
pub use store::global_skill_dir;
pub use store::read_from_dir;
pub use store::write_to_dir;
pub use validate::ValidationError;
pub use validate::validate;
pub use version::SKILL_MANIFEST_SCHEMA_VERSION;
pub use version::is_supported;
pub use manifest::*;
pub use types::*;

Modules§

aggregator
Stats aggregator: receives StatsEvent from the runtime’s fan-out adapter and flushes counter deltas into per-skill stats.json sidecars.
capability
constraint
credit
Credit ledger data types (M7c).
evolution
Skill evolution log — records every generation of a skill.
gene
Skill gene model (M7b).
hash
inventory
lifecycle
Pure-function lifecycle + decay layer. Functions take inputs, return outputs, never touch disk. M5b’s sweep calls these to decide transitions and persist; M5a’s doctor calls them for read-only display.
loader
Single-pass skill loader: lists global + per-agent skills, resolves trust level, checks drift, returns one flat Vec.
local
Local skill store helpers — list installed, resolve, remove, search, trust.
lockfile
manifest
Skill manifest — full serde representation of canonical skill.yaml.
mcp
MCP capability declaration vocabulary (M6a).
parser
Dual-format parser. Canonical YAML is the source of truth; markdown frontmatter is the human-authoring surface that round-trips via canonical_from_markdown() / markdown_from_canonical().
peers
Peer agent enumeration (M7a).
registry
Git-based skill registry data model for index.yaml.
resolve
scan
Skill content security scanner — wires the four sub-scanners into a single scan_skill_content() entry point used by mur skill validate and by the install pipeline.
sign
stats
Per-skill runtime statistics. Not signed, not part of the publisher manifest. Lives at <MUR_HOME>/skills/<name>/stats.json and is rebuildable from the JSONL trace log via mur skill reindex-stats.
store
types
Skill type enums.
validate
Schema validation enforced after parsing.
version
Schema version anchor for skill manifests.