---
slug: "pi-rust-skills"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/gripebomb/pi-rust-skills@main/README.md"
repo: "https://github.com/gripebomb/pi-rust-skills"
source_file: "README.md"
branch: "main"
---
# pi-rust-skills

Rust programming skills and a lightweight Rust project context tool for [Pi Coding Agent](https://pi.dev/).

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

```bash
pi install npm:pi-rust-skills
```

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

```bash
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

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

Try it locally in Pi:

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

Then invoke a skill:

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

## Package structure

```text
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`:

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

## License

MIT