FastSkill

Package manager and operational toolkit for Agent AI Skills.

Why FastSkill

FastSkill helps you manage AI skills with a clean, repeatable workflow:

• Install skills from local folders, git repositories, or registries
• Keep installs reproducible with skill-project.toml and skills.lock
• Discover skills with remote and local search
• Validate and evaluate skill quality before sharing
• Diagnose your environment with fastskill doctor

Quick start

fastskill -V
fastskill init
fastskill add ./skills/my-skill -e --group dev
fastskill install
fastskill list

Optional local search flow:

fastskill reindex
fastskill search "text processing" --local

skill-project.toml (project manifest)

skill-project.toml is the project manifest for skill dependencies. It keeps installs reproducible across teammates and CI together with skills.lock.

Minimal example:

[dependencies]
demo-skill = { source = "local", path = "./skills/demo-skill", editable = true, groups = ["dev"] }

Typical workflow:

fastskill add ./skills/demo-skill -e --group dev
fastskill install
fastskill list

Usage examples

Add from local folder (editable)

fastskill add ./skills/pptx-helper -e --group dev
fastskill install

Add from git

fastskill add https://github.com/org/skill.git --branch main
fastskill install

Add from registry

fastskill add scope/pptx@1.0.0
fastskill install --lock

Core commands

Command	What it does
fastskill add <source>	Add a skill dependency from local, git, zip, or registry
fastskill install	Apply dependencies from skill-project.toml
fastskill list	List installed skills
fastskill read <id>	Print a skill's full SKILL.md (add --meta for metadata, --tree for its dependency tree)
fastskill search "<query>"	Search remote catalog (default)
fastskill search "<query>" --local	Search installed skills
fastskill eval validate	Validate eval configuration and checks
fastskill doctor	Diagnose configuration and environment (e.g. whether semantic search is available)

Documentation

• Welcome
• Quick Start
• Installation
• CLI Reference
• Registry Guide

Crates

This repository is a Rust workspace with three primary crates:

• crates/fastskill-cli: CLI binary and command routing.
• crates/fastskill-core: reusable service/library layer.
• crates/fastskill-evals: standalone evaluation engine primitives.

Each crate has its own docs:

• crates/fastskill-cli/README.md
• crates/fastskill-cli/CONTRIBUTING.md
• crates/fastskill-core/README.md
• crates/fastskill-core/CONTRIBUTING.md
• crates/fastskill-evals/README.md
• crates/fastskill-evals/CONTRIBUTING.md

License

Apache-2.0