pi-rust-skills

Rust programming skills and a lightweight Rust project context tool for Pi Coding Agent.

This package is meant to be published to npm and installed by Pi users with:

pi install npm:pi-rust-skills

For a scoped package, rename the package to something like @gripebomb/pi-rust-skills and install it with:

pi install npm:@gripebomb/pi-rust-skills

What it includes

Extension tool

• rust_project_context — read-only helper that inspects a Rust/Cargo project and returns:
  • Rust/Cargo/rustup/rustfmt/clippy version information.
  • Cargo.toml preview.
  • cargo metadata --no-deps output.
  • Optional cargo tree -e features output.

Skills

| Skill | Purpose | |---|---| | /skill:rust-project-bootstrap | Create or restructure Rust crates/workspaces. | | /skill:rust-code-review | Review Rust code for correctness, idioms, safety, and maintainability. | | /skill:rust-debugging | Diagnose compiler errors, panics, failing tests, and Cargo issues. | | /skill:rust-testing | Add unit, integration, doc, async, property, and regression tests. | | /skill:rust-async-tokio | Build/review Tokio and async Rust systems. | | /skill:rust-cli | Build Rust command-line applications. | | /skill:rust-web-api | Build Rust HTTP APIs and web services. | | /skill:rust-database | Build Rust database layers, migrations, and query tests. | | /skill:rust-wasm | Build Rust WebAssembly projects. | | /skill:rust-ffi | Implement and review Rust FFI boundaries. | | /skill:rust-embedded-no-std | Build embedded and no_std Rust projects. | | /skill:rust-proc-macro | Build and test Rust procedural macros. | | /skill:rust-build-cross | Configure build scripts, native dependencies, and cross-compilation. | | /skill:rust-performance | Profile and optimize Rust code. | | /skill:rust-security-audit | Audit Rust projects for security issues. | | /skill:rust-crate-publishing | Prepare crates for crates.io publishing. | | /skill:rust-refactor-migration | Safely refactor and modernize Rust codebases. | | /skill:rust-toolchain-ci | Configure Rust toolchains, lint policy, and CI. |

Skill selection guide

• Start with /skill:rust-project-bootstrap for new crates, workspaces, or major project reshaping.
• Use /skill:rust-debugging when a command fails, code panics, or behavior is wrong.
• Use /skill:rust-code-review for risk-focused review before merging or publishing.
• Use /skill:rust-testing when the main task is coverage, regression tests, or test strategy.
• Use a domain skill when the code has a clear surface: /skill:rust-cli, /skill:rust-web-api, /skill:rust-database, /skill:rust-async-tokio, /skill:rust-wasm, /skill:rust-ffi, /skill:rust-embedded-no-std, /skill:rust-proc-macro, or /skill:rust-build-cross.
• Use /skill:rust-performance, /skill:rust-security-audit, /skill:rust-crate-publishing, /skill:rust-refactor-migration, or /skill:rust-toolchain-ci for cross-cutting project work.

Skills that combine well

• CLI or web API work often pairs with /skill:rust-testing, /skill:rust-toolchain-ci, and /skill:rust-crate-publishing.
• Async services often pair /skill:rust-async-tokio with /skill:rust-web-api, /skill:rust-database, and /skill:rust-performance.
• FFI, embedded, proc macro, and cross-build tasks often pair with /skill:rust-security-audit and /skill:rust-testing.
• Release preparation often pairs /skill:rust-crate-publishing with /skill:rust-code-review, /skill:rust-security-audit, and /skill:rust-toolchain-ci.

Local development

git clone https://github.com/gripebomb/pi-rust-skills.git
cd pi-rust-skills
npm test
npm run list

Try it locally in Pi:

pi install ./pi-rust-skills
# or from inside the parent directory:
pi -e ./pi-rust-skills

Then invoke a skill:

/skill:rust-code-review Review this Rust project and suggest fixes.

Package structure

pi-rust-skills/
├── extensions/
│   └── rust-skills.ts
├── skills/
│   ├── rust-project-bootstrap/SKILL.md
│   ├── rust-code-review/SKILL.md
│   └── ...
├── references/
├── scripts/
├── examples/
├── package.json
└── README.md

Pi discovers resources through the pi manifest in package.json:

{
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./extensions"],
    "skills": ["./skills"]
  }
}

License

MIT