rust · oakoss — Claude Code skill: what it does, how to install
This skill guides Rust work across ownership, async services, CLIs, terminal UIs, and testing. Use it when an agent needs Rust-specific patterns.
MIT 128 installs ★ 29 updated 2026-08-17
npx skills add oakoss/agent-skills --skill rust -a claude-codeWhat rust does
The skill covers ownership, borrowing, lifetimes, traits, generics, and error handling with Result, Option, thiserror, and anyhow. It also addresses Tokio async code, serde serialization, Cargo workspaces, and testing patterns.
Its references include examples for axum, ratatui, and clap, plus benchmarking with criterion. Release-related guidance covers dependency checks with cargo-deny, binary distribution through cargo-dist, and changelog updates using release-plz. Code exploration, architecture review, and code review can be handed to the listed agents.
In library code, the guidance favors returning Result over calling unwrap(), leaving error decisions to the caller. Async tests should use #[tokio::test] rather than #[test].
What it helps with
- design ownership and borrowing for a Rust function
- propagate errors with
Result,thiserror, oranyhow - build an async service with Tokio and
axum - create a CLI with
clapor a TUI withratatui - audit dependencies and prepare binary releases
Example prompts for the agent
- Review ownership and lifetime usage in this Rust module, then suggest fixes.
- Build an async HTTP service with Tokio and
axum, including error handling. - Set up
criterionbenchmarks and dependency checks withcargo-denyfor this project.
How to install rust
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill rust -a claude-code2Manually: put the files in place
~/.claude/skills/rust/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/rust/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill rust -a codex2Manually: put the files in place
.agents/skills/rust/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill rust -a cursor2Manually: put the files in place
.cursor/skills/rust/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/rust2Manually: put the files in place
.github/skills/rust/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill rust -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/rustManually: put the files in place
.devin/skills/rust/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill rust -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about rust
How do I install rust in Claude Code?
Run npx skills add oakoss/agent-skills --skill rust -a claude-code, then check ~/.claude/skills/rust/SKILL.md.
What does the rust skill do?
It gives the agent Rust patterns for ownership, lifetimes, errors, Tokio, axum, CLI tools, testing, and Cargo-based release workflows.
Which attribute should async Rust tests use?
Use #[tokio::test] instead of #[test] for async tests. The skill also covers testing patterns and criterion benchmarks.
Source text
SKILL.md · MIT
---
name: rust
description: |
Rust language patterns and ecosystem covering ownership, borrowing, lifetimes, error handling (Result/Option, thiserror, anyhow), async with Tokio, traits, generics, serde serialization, Cargo workspaces, and testing. Includes axum web framework, ratatui terminal UI, clap CLI parsing, criterion benchmarking, cargo-deny supply chain security, cargo-dist binary distribution, and release-plz changelog automation.
Use when writing Rust code, designing ownership models, building async services with Tokio/axum, creating terminal UIs with ratatui, setting up CLI applications with clap, configuring CI/CD pipelines for Rust, benchmarking with criterion, auditing dependencies with cargo-deny, or distributing binaries with cargo-dist.
license: MIT
metadata:
author: oakoss
version: '1.0'
source: 'https://doc.rust-lang.org/book/'
user-invocable: false
---
# Rust
## Overview
Rust is a systems programming language focused on safety, concurrency, and performance. The ownership system guarantees memory safety without garbage collection, and the type system enforces thread safety at compile time.
**When to use:** Systems programming, web services (axum), CLI tools (clap), terminal UIs (ratatui), WebAssembly, performance-critical applications, anything requiring memory safety without runtime overhead.
**When NOT to use:** Rapid prototyping where compile times matter more than safety, simple scripting tasks, projects where the team has no Rust experience and deadlines are tight.
## Quick Reference
| Pattern | API / Tool | Key Points |
| ------------------- | ----------------------------------- | ------------------------------------ |
| Ownership transfer | `let b = a;` | `a` is moved, no longer usable |
| Borrowing | `&T` / `&mut T` | One mutable OR many immutable refs |
| Lifetime annotation | `fn f<'a>(x: &'a str) -> &'a str` | Ties output lifetime to input |
| Error propagation | `?` operator | Converts and propagates errors |
| Custom errors | `thiserror::Error` derive | Structured error types with Display |
| Ad-hoc errors | `anyhow::Result<T>` | Context chaining for applications |
| Async runtime | `#[tokio::main]` | Entry point for async programs |
| Spawn task | `tokio::spawn(async { })` | Concurrent async task execution |
| HTTP router | `axum::Router::new().route(...)` | Composable routing with extractors |
| Extractors | `Json<T>`, `Path<T>`, `State<T>` | Type-safe request parsing |
| Serialization | `#[derive(Serialize, Deserialize)]` | serde with format-agnostic derives |
| CLI parsing | `#[derive(Parser)]` | clap derive API for arg parsing |
| TUI rendering | `terminal.draw(\|f\| { })` | Immediate-mode ratatui rendering |
| Benchmarking | `criterion::Criterion` | Statistical benchmarking framework |
| Dep auditing | `cargo deny check` | License, vulnerability, source audit |
| Binary release | `cargo dist init` | Cross-platform binary distribution |
| Changelog | `release-plz update` | Auto semver bump and changelog |
## Common Mistakes
| Mistake | Correct Pattern |
| --------------------------------------- | --------------------------------------------- |
| Returning reference to local variable | Return owned type or use lifetime parameter |
| Using `unwrap()` in library code | Return `Result` and let caller decide |
| `clone()` to satisfy borrow checker | Restructure code to avoid the borrow conflict |
| Blocking in async context | Use `tokio::task::spawn_blocking` |
| Shared mutable state without sync | Use `Arc<Mutex<T>>` or channels |
| `String` where `&str` suffices | Accept `&str` in function parameters |
| Ignoring `must_use` warnings | Handle or explicitly discard with `let _ =` |
| Large enum variants | Box the large variant to reduce overall size |
| `async fn` in traits without bounds | Add `Send` bound or use `async-trait` crate |
| Missing `#[tokio::test]` on async tests | Use `#[tokio::test]` instead of `#[test]` |
## Delegation
- **Code exploration**: Use `Explore` agent
- **Architecture review**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent
> If the `docker` skill is available, delegate multi-stage container build patterns to it.
> If the `github-actions` skill is available, delegate CI pipeline configuration to it.
> If the `openapi` skill is available, delegate API specification and code generation to it.
## References
- [Ownership, borrowing, lifetimes, and type system patterns](references/ownership-and-types.md)
- [Error handling with Result, Option, thiserror, and anyhow](references/error-handling.md)
- [Async programming with Tokio runtime and concurrency](references/async-tokio.md)
- [Web APIs and backends with axum, tower, and sqlx](references/axum-web.md)
- [Terminal user interfaces with ratatui and crossterm](references/ratatui-tui.md)
- [CLI applications with clap, config, and signal handling](references/cli-applications.md)
- [Testing patterns and criterion benchmarking](references/testing-and-benchmarks.md)
- [Release pipeline with cargo-deny, cargo-dist, and release-plz](references/release-pipeline.md)
© oakoss · MIT · oakoss/agent-skills
Similar skills
All skills for Programming languages →rust by other authors comes first.