Crate skill 

skill

A library for managing AI agent skills across the open skills ecosystem.

This crate provides the core functionality for discovering, installing, listing, and removing agent skills. It is designed to be embedded in agent frameworks so they gain full skills ecosystem support out of the box.

Quick Start

use skill::manager::SkillManager;

let manager = SkillManager::builder().build();

// Discover skills in a repository
let skills = manager
    .discover_skills(std::path::Path::new("./my-repo"), &Default::default())
    .await?;

// List installed skills
let installed = manager.list_installed(&Default::default()).await?;

Module Map

• manager — SkillManager façade; the main entry point for agent frameworks.
• types — plain data types (Skill, AgentId, InstallScope, …).
• error — library-wide SkillError / Result.
• agents — built-in agent registry + custom registration hooks.
• skills — on-disk skill discovery and SKILL.md parsing.
• installer — install / remove / scan choreography.
• source — source-string parsing (owner/repo, URLs, local paths).
• providers — remote skill hosts (well-known, GitHub, GitLab).
• lock / local_lock — global and project lock-file I/O.
• blob, git, github — network transports (feature-gated).
• sanitize — input sanitization helpers.
• telemetry — anonymous usage reporting (feature-gated).

Feature Flags

• network (default) — Enables HTTP-based operations (fetching remote skills, well-known providers, GitHub API).
• telemetry — Enables anonymous usage telemetry. Disabled by default for library consumers; enabled by the CLI.

Re-exports

pub use error::Result;

pub use error::SkillError;

pub use manager::SkillManager;

Modules

agents

Agent registry and detection.

blob

Blob-based fast install for GitHub sources.

error

Error types for the skill library.

git

Git operations for cloning skill repositories.

github

GitHub API utilities.

installer

Skill installation, removal, and listing.

local_lock

Project-scoped skill lock file management.

lock

Global skill lock file management.

manager

SkillManager — the primary API surface for agent frameworks.

providers

Skill source providers.

sanitize

Untrusted-string → safe-string transformations.

skills

Skill discovery and SKILL.md parsing.

source

Source string parsing.

telemetry

Optional anonymous telemetry.

types

Core data types for the skill ecosystem.