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)
fastskill package	Package skills for distribution

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