craftbag 0.1.0

Discover and load Agent Skills (SKILL.md) for CLI and MCP hosts
Documentation

craftbag

Discover, list, load, and explain Agent Skills (SKILL.md) for CLI and MCP hosts.

CI Security License

OpenSSF Best Practices OpenSSF Scorecard FOSSA Status

What it does

craftbag walks project and home skill trees (.agents, plus optional vendor trees for Claude, Cursor, Grok, and Bline). It then:

  • catalogs skills (list)
  • prints one skill body (load)
  • explains why a skill would activate (why)
  • checks a package (validate)

The same operations exist over MCP stdio (skills_list, skills_load, skills_why, skills_validate). Hosts can filter, rank, and load skills without taking a dependency on any one agent product.

Install

The library and bins are not on crates.io yet. Use git:

cargo install --locked --git https://github.com/craftbag/craftbag --bin craftbag
cargo install --locked --git https://github.com/craftbag/craftbag --bin craftbag-mcp

Library path or git dependency:

craftbag = { git = "https://github.com/craftbag/craftbag" }

MSRV is 1.85.

Getting started

git clone https://github.com/craftbag/craftbag
cd craftbag
cargo build -p craftbag --locked
./target/debug/craftbag list
./target/debug/craftbag list --catalog
./target/debug/craftbag why NAME

From a crate that already has skills under .agents or a vendor tree, add --vendor claude (or cursor, grok, bline) to include those roots.

Demo

craftbag list

MCP

craftbag-mcp speaks JSON-RPC on stdio. Point your host at the binary and use skills_list, skills_load, skills_why, and skills_validate.

Contributing

See CONTRIBUTING.md. Security reports go to SECURITY.md. Roadmap and governance are in ROADMAP.md and GOVERNANCE.md.

License

Apache-2.0 or MIT. You may choose either. See LICENSE and LICENSE-APACHE.