Loading repository data…
Loading repository data…
SHA888 / repository
A Cargo subcommand for deploying and activating layered AI agent skills in Rust projects
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A Cargo subcommand for deploying and activating layered AI agent skills in Rust projects.
cargo install cargo-skill
The same command upgrades to the latest version on crates.io:
cargo install cargo-skill
Cargo silently skips when you're already on the latest version; it only installs
if a newer one exists. Use --force to reinstall the same version (e.g., to
refresh the deployed asset bundle):
cargo install cargo-skill --force
Note: cargo update cargo-skill is not the right command — cargo update
operates on a project's Cargo.lock and does not touch installed binaries.
After upgrading, re-run cargo skill init in each project to deploy the new
skill assets (use --force to overwrite previously deployed files).
cargo-skill has two jobs:
Install-time — detects your repo structure and agent tooling, then deploys the right skill files to the right paths.
Execution-time — writes a scoped context file (.skill/context.md) that controls
which skill layer the agent uses for the current session.
cargo skill init Detect repo + agents, deploy skill files
cargo skill init --dry-run Preview what would be deployed
cargo skill init --force Overwrite existing skill files
cargo skill lookup [prefix] Activate Layer 1 only (rule index, optional prefix filter)
cargo skill think Activate Layer 1 + 2 (lookup + reasoning)
cargo skill write Activate all layers (lookup + reasoning + execution)
cargo skill clear Remove .skill/context.md
cargo skill status Show repo, agents, context, and gitignore status
cargo skill review Review-focused context (err + test + lint + reasoning)
cargo skill refactor Refactor-focused context (type + api + name + reasoning)
cargo skill debug Debug-focused context (err + mem + compiler quick-ref)
cargo skill own # Same as: cargo skill lookup own
cargo skill async # Same as: cargo skill lookup async
cargo skill err # Same as: cargo skill lookup err
All 14 prefixes work: own, err, mem, api, async, opt, type, perf, test, doc, name, proj, lint, anti
See Layer 1 reference for all available prefixes.
init).claude/, .cursor/, .windsurf/, AGENTS.md)layer1.md, layer2.md, layer3.md) and agent personas
to the correct paths for each detected agent.claude/commands/*.md).skill/ and context files to .gitignorelookup / think / write)Writes .skill/context.md with the appropriate layer subset:
| Command | Layer 1 (Lookup) | Layer 2 (Reasoning) | Layer 3 (Execution) |
|---|---|---|---|
lookup [prefix] | ✓ (filtered) | ||
think | ✓ | ✓ | |
write | ✓ | ✓ | ✓ |
review | ✓ (err,test,lint) | ✓ | |
refactor | ✓ (type,api,name) | ✓ | |
debug | ✓ (err,mem) | ✓ (quick-ref only) |
The agent reads .skill/context.md as session context. This file is ephemeral —
gitignored, overwritten on each invocation, deleted by clear.
| Agent | Install path | Content |
|---|---|---|
| Claude Code | .claude/skills/rust.md | Rust skill layers |
.claude/skills/python.md | Python skill layers (if detected) | |
.claude/commands/*.md (slash) | Skill workflow slash commands | |
.claude/skills/agents/rust-*.md | Agent personas | |
| Cursor | .cursor/rules/rust.md | Rust skill layers |
.cursor/rules/python.md | Python skill layers (if detected) | |
| Windsurf | .windsurf/rules/rust.md | Rust skill layers |
.windsurf/rules/python.md | Python skill layers (if detected) | |
| AGENTS.md | AGENTS.md (appended) | Fallback for other agents |
Three-layer skill with 14-category rule index:
own-, err-,
mem-, api-, async-, opt-, type-, perf-, test-, doc-, name-,
proj-, lint-, anti-)Sources: leonardomso/rust-skills (MIT), actionbook/rust-skills (MIT),
udapy/rust-agentic-skills (MIT).
Three-layer skill with PEP-aligned guidelines:
Sources: PEP standards, mypy docs, uv docs, ruff docs, attrs/pydantic patterns.
For projects with both Cargo.toml and pyproject.toml:
cargo skill lookup rust:<prefix> routes to Rust assetscargo skill lookup py:<prefix> routes to Python assetscargo skill rust:err, cargo skill py:testDeployed to .claude/skills/agents/ on cargo skill init:
api-, proj-, type- prefix rulesanti- + lint- prefix rulesSee CHANGELOG.md for the full release history. Recent highlights:
review, refactor, debug), Claude Code slash commands, and agent personas (rust-architect, rust-reviewer)--quiet flag, deployment metadata)status command and comprehensive project overview--dry-run and --force flags for initcargo install cargo-skill
After installation, ensure ~/.cargo/bin is in your PATH (Cargo usually does this automatically). Then optionally add a shell alias for convenience:
Bash/Zsh:
echo 'alias skill="cargo skill"' >> ~/.bashrc # or ~/.zshrc
source ~/.bashrc # or ~/.zshrc
Fish:
alias skill "cargo skill"
funcsave skill
Now you can use skill as a shorthand:
skill status
skill review
skill own
Licensed under either of:
at your option.