Skip to content
Back to search

rust-skills

MarketplaceWorks with Claude CodeGitHub

Comprehensive Rust development assistant with meta-question routing, coding guidelines, version queries, and ecosystem support

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/actionbook-rust-skills/badge.svg)](/listings/actionbook-rust-skills)

HTML

<a href="/listings/actionbook-rust-skills"><img src="/api/listings/actionbook-rust-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Rust Skills supports two installation modes:

- **Plugin Mode** (Claude Code): Full features including hooks, agents, and auto meta-cognition - **Skills-only Mode**: Works with any coding agent that supports skills (Claude Code, Vercel AI, etc.)

---

Skills-only Install (Recommended)

The simplest way to get started. Works with **any coding agent** that supports skills, including Claude Code, [Vercel's `add-skills`](https://github.com/nicepkg/add-skills), and others.

Skills now include **inline fallback logic** — when agent files are not available, skills execute directly using built-in tools (actionbook, agent-browser, WebFetch).

Option A: NPX (Easiest)

npx skills add actionbook/rust-skills

Option B: CoWork CLI

Install via [CoWork](https://crates.io/crates/cowork), a Rust-based skills management tool:

# Install CoWork
cargo install cowork

# Method 1: Direct install
cowork install actionbook/rust-skills

# Method 2: Config-based install (recommended for teams)
cowork config init                    # Create .cowork/Skills.toml
# Edit Skills.toml to add rust-skills (see below)
cowork config install                 # Install all configured skills

**Skills.toml configuration:**

[project]
name = "my-rust-project"

[skills.install]
rust-skills = "actionbook/rust-skills"

[security]
trusted_authors = ["ZhangHanDong"]

> CoWork (`co` for short) provides version management, dependency resolution, lock files, and security auditing. See [CoWork documentation](https://crates.io/crates/cowork) for more details.

Option C: Manual Copy

git clone https://github.com/actionbook/rust-skills.git
cp -r rust-skills/skills/* ~/.claude/skills/

> **Note**: Skills-only mode does not include hooks, so meta-cognition won't trigger automatically. You can manually call `/rust-router` or specific skills. Background agents fall back to inline execution automatically.

---

Claude Code Plugin Install (Full Features)

For **Claude Code users** who want the complete experience with hooks, background agents, and auto meta-cognition triggering.

Option A: Marketplace

# Step 1: Add the marketplace
/plugin marketplace add actionbook/rust-skills

# Step 2: Install the plugin
/plugin install rust-skills@rust-skills

> **Note**: Step 1 only adds the marketplace (plugin source). Step 2 actually installs the rust-skills plugin with all features enabled.

Option B: Full Plugin (Local)

# Clone the repository
git clone https://github.com/actionbook/rust-skills.git

# Launch with plugin directory
claude --plugin-dir /path/to/rust-skills

---

Feature Comparison

| Feature | Plugin (Marketplace) | Plugin (Local) | Skills-only (NPX/CoWork/Manual) | |---------|---------------------|----------------|--------------------------------| | All 31 Skills | ✅ | ✅ | ✅ | | Auto meta-cognition trigger | ✅ | ✅ | ❌ (manual invoke) | | Hook-based routing | ✅ | ✅ | ❌ | | Background agents | ✅ | ✅ | ✅ (inline fallback) | | Easy updates | ✅ | ❌ | ✅ (NPX/CoWork) | | Works with other agents | ❌ | ❌ | ✅ |

Permission Configuration

Background agents require permission to run `agent-browser`. Configure in your project:

# Copy example config
cp /path/to/rust-skills/.claude/settings.example.json .claude/settings.local.json

Or create manually:

mkdir -p .claude
cat > .claude/settings.local.json << 'EOF'
{
  "permissions": {
    "allow": [
      "Bash(agent-browser *)"
    ]
  }
}
EOF

See [.claude/settings.example.json](.claude/settings.example.json) for reference.

Other Platforms

- **OpenCode**: See [.opencode/INSTALL.md](.opencode/INSTALL.md) - **Codex**: See [.codex/INSTALL.md](.codex/INSTALL.md)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "rust-skills",
  4. "version": "2.0.8",
  5. "description": "Comprehensive Rust development assistant with meta-question routing, coding guidelines, version queries, and ecosystem support",
  6. "owner": {
  7. "name": "ZhangHanDong",
  8. "email": "corust@example.com"
  9. },
  10. "plugins": [
  11. {
  12. "name": "rust-skills",
  13. "description": "38 skills covering ownership, concurrency, error handling, unsafe code, LSP code intelligence, and domain-specific patterns for Rust development",
  14. "source": "./",
  15. "category": "development"
  16. }
  17. ]
  18. }
README.md · README · 346 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Rust Skills
  2. [中文](./README-zh.md) | [日本語](./README-ja.md)
  3. > AI-powered Rust development assistant with meta-cognition framework
  4. [![Version](https://img.shields.io/badge/version-2.0.9-green.svg)](https://github.com/actionbook/rust-skills/releases)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  6. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-blue)](https://github.com/anthropics/claude-code)
  7. ## What is Rust Skills?
  8. **Rust Skills** is a Claude Code plugin that transforms how AI assists with Rust development. Instead of giving surface-level answers, it traces through cognitive layers to provide **domain-correct architectural solutions**.
  9. ### The Problem
  10. Traditional AI assistance for Rust:
  11. ```
  12. User: "My trading system reports E0382"
  13. AI: "Use .clone()" ← Surface fix, ignores domain constraints
  14. ```
  15. ### The Solution
  16. Rust Skills with meta-cognition:
  17. ```
  18. User: "My trading system reports E0382"
  19. AI (with Rust Skills):
  20. ├── Layer 1: E0382 = ownership error → Why is this data needed?
  21. │ ↑
  22. ├── Layer 3: Trade records are immutable audit data → Should share, not copy
  23. │ ↓
  24. ├── Layer 2: Use Arc<TradeRecord> as shared immutable value
  25. │ ↓
  26. └── Recommendation: Redesign as Arc<T>, not clone()
  27. ```
  28. ## Features
  29. - **Meta-Cognition Framework**: Three-layer cognitive model (Domain → Design → Mechanics)
  30. - **Real-time Information**: Fetch latest Rust versions and crate info via background agents
  31. - **Dynamic Skills**: Auto-generate skills from your Cargo.toml dependencies
  32. - **Domain Extensions**: FinTech, ML, Cloud-Native, IoT, Embedded, Web, CLI support
  33. - **Coding Guidelines**: Complete Rust coding conventions and best practices
  34. ## Installation
  35. Rust Skills supports two installation modes:
  36. - **Plugin Mode** (Claude Code): Full features including hooks, agents, and auto meta-cognition
  37. - **Skills-only Mode**: Works with any coding agent that supports skills (Claude Code, Vercel AI, etc.)
  38. ---
  39. ### Skills-only Install (Recommended)
  40. The simplest way to get started. Works with **any coding agent** that supports skills, including Claude Code, [Vercel's `add-skills`](https://github.com/nicepkg/add-skills), and others.
  41. Skills now include **inline fallback logic** — when agent files are not available, skills execute directly using built-in tools (actionbook, agent-browser, WebFetch).
  42. #### Option A: NPX (Easiest)
  43. ```bash
  44. npx skills add actionbook/rust-skills
  45. ```
  46. #### Option B: CoWork CLI
  47. Install via [CoWork](https://crates.io/crates/cowork), a Rust-based skills management tool:
  48. ```bash
  49. # Install CoWork
  50. cargo install cowork
  51. # Method 1: Direct install
  52. cowork install actionbook/rust-skills
  53. # Method 2: Config-based install (recommended for teams)
  54. cowork config init # Create .cowork/Skills.toml
  55. # Edit Skills.toml to add rust-skills (see below)
  56. cowork config install # Install all configured skills
  57. ```
  58. **Skills.toml configuration:**
  59. ```toml
  60. [project]
  61. name = "my-rust-project"
  62. [skills.install]
  63. rust-skills = "actionbook/rust-skills"
  64. [security]
  65. trusted_authors = ["ZhangHanDong"]
  66. ```
  67. > CoWork (`co` for short) provides version management, dependency resolution, lock files, and security auditing. See [CoWork documentation](https://crates.io/crates/cowork) for more details.
  68. #### Option C: Manual Copy
  69. ```bash
  70. git clone https://github.com/actionbook/rust-skills.git
  71. cp -r rust-skills/skills/* ~/.claude/skills/
  72. ```
  73. > **Note**: Skills-only mode does not include hooks, so meta-cognition won't trigger automatically. You can manually call `/rust-router` or specific skills. Background agents fall back to inline execution automatically.
  74. ---
  75. ### Claude Code Plugin Install (Full Features)
  76. For **Claude Code users** who want the complete experience with hooks, background agents, and auto meta-cognition triggering.
  77. #### Option A: Marketplace
  78. ```bash
  79. # Step 1: Add the marketplace
  80. /plugin marketplace add actionbook/rust-skills
  81. # Step 2: Install the plugin
  82. /plugin install rust-skills@rust-skills
  83. ```
  84. > **Note**: Step 1 only adds the marketplace (plugin source). Step 2 actually installs the rust-skills plugin with all features enabled.
  85. #### Option B: Full Plugin (Local)
  86. ```bash
  87. # Clone the repository
  88. git clone https://github.com/actionbook/rust-skills.git
  89. # Launch with plugin directory
  90. claude --plugin-dir /path/to/rust-skills
  91. ```
  92. ---
  93. ### Feature Comparison
  94. | Feature | Plugin (Marketplace) | Plugin (Local) | Skills-only (NPX/CoWork/Manual) |
  95. |---------|---------------------|----------------|--------------------------------|
  96. | All 31 Skills | ✅ | ✅ | ✅ |
  97. | Auto meta-cognition trigger | ✅ | ✅ | ❌ (manual invoke) |
  98. | Hook-based routing | ✅ | ✅ | ❌ |
  99. | Background agents | ✅ | ✅ | ✅ (inline fallback) |
  100. | Easy updates | ✅ | ❌ | ✅ (NPX/CoWork) |
  101. | Works with other agents | ❌ | ❌ | ✅ |
  102. ### Permission Configuration
  103. Background agents require permission to run `agent-browser`. Configure in your project:
  104. ```bash
  105. # Copy example config
  106. cp /path/to/rust-skills/.claude/settings.example.json .claude/settings.local.json
  107. ```
  108. Or create manually:
  109. ```bash
  110. mkdir -p .claude
  111. cat > .claude/settings.local.json << 'EOF'
  112. {
  113. "permissions": {
  114. "allow": [
  115. "Bash(agent-browser *)"
  116. ]
  117. }
  118. }
  119. EOF
  120. ```
  121. See [.claude/settings.example.json](.claude/settings.example.json) for reference.
  122. ### Other Platforms
  123. - **OpenCode**: See [.opencode/INSTALL.md](.opencode/INSTALL.md)
  124. - **Codex**: See [.codex/INSTALL.md](.codex/INSTALL.md)
  125. ## Dependent Skills
  126. Rust Skills relies on these external tools for full functionality:
  127. | Tool | Description | GitHub |
  128. |------|-------------|--------|
  129. | **actionbook** | MCP server for website action manuals. Used by agents to fetch structured web content (Rust releases, crate info, documentation). | [actionbook/actionbook](https://github.com/actionbook/actionbook) |
  130. | **agent-browser** | Browser automation tool for fetching real-time web data. Fallback when actionbook is unavailable. | [vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser) |
  131. ## Meta-Cognition Framework
  132. ### Core Concept
  133. **Don't answer directly. Trace through cognitive layers first.**
  134. ```
  135. Layer 3: Domain Constraints (WHY)
  136. ├── Domain rules determine design choices
  137. └── Example: Financial systems require immutable, auditable data
  138. Layer 2: Design Choices (WHAT)
  139. ├── Design patterns and architectural decisions
  140. └── Example: Use Arc<T> for shared immutable data
  141. Layer 1: Language Mechanics (HOW)
  142. ├── Rust language features and compiler rules
  143. └── Example: E0382 is a symptom of ownership design issues
  144. ```
  145. ### Routing Rules
  146. | User Signal | Entry Layer | Trace Direction | Primary Skill |
  147. |-------------|-------------|-----------------|---------------|
  148. | E0xxx errors | Layer 1 | Trace UP ↑ | m01-m07 |
  149. | "How to design..." | Layer 2 | Bidirectional | m09-m15 |
  150. | "[Domain] app development" | Layer 3 | Trace DOWN ↓ | domain-* |
  151. | Performance issues | Layer 1→2 | Up then Down | m10-performance |
  152. ## Skills Overview
  153. ### Core Skills
  154. - `rust-router` - Master router for all Rust questions (invoked first)
  155. - `rust-learner` - Fetch latest Rust/crate version info
  156. - `coding-guidelines` - Coding conventions lookup
  157. ### Layer 1: Language Mechanics (m01-m07)
  158. | Skill | Core Question | Triggers |
  159. |-------|---------------|----------|
  160. | m01-ownership | Who should own this data? | E0382, E0597, move, borrow |
  161. | m02-resource | What ownership pattern fits? | Box, Rc, Arc, RefCell |
  162. | m03-mutability | Why does this data need to change? | mut, Cell, E0596, E0499 |
  163. | m04-zero-cost | Compile-time or runtime polymorphism? | generic, trait, E0277 |
  164. | m05-type-driven | How can types prevent invalid states? | newtype, PhantomData |
  165. | m06-error-handling | Expected failure or bug? | Result, Error, panic, ? |
  166. | m07-concurrency | CPU-bound or I/O-bound? | async, Send, Sync, thread |
  167. ### Layer 2: Design Choices (m09-m15)
  168. | Skill | Core Question | Triggers |
  169. |-------|---------------|----------|
  170. | m09-domain | What role does this concept play? | DDD, entity, value object |
  171. | m10-performance | Where's the bottleneck? | benchmark, profiling |
  172. | m11-ecosystem | Which crate fits this task? | crate selection, dependencies |
  173. | m12-lifecycle | When to create, use, cleanup? | RAII, Drop, lazy init |
  174. | m13-domain-error | Who handles this error? | retry, circuit breaker |
  175. | m14-mental-model | How to think about this correctly? | learning Rust, why |
  176. | m15-anti-pattern | Does this pattern hide design issues? | code smell, common mistakes |
  177. ### Layer 3: Domain Constraints (domain-*)
  178. | Skill | Domain | Core Constraints |
  179. |-------|--------|------------------|
  180. | domain-fintech | FinTech | Audit trail, precision, consistency |
  181. | domain-ml | Machine Learning | Memory efficiency, GPU acceleration |
  182. | domain-cloud-native | Cloud Native | 12-Factor, observability, graceful shutdown |
  183. | domain-iot | IoT | Offline-first, power management, security |
  184. | domain-web | Web Services | Stateless, latency SLA, concurrency |
  185. | domain-cli | CLI | UX, config precedence, exit codes |
  186. | domain-embedded | Embedded | No heap, no_std, real-time |
  187. ## Commands
  188. | Command | Description |
  189. |---------|-------------|
  190. | `/rust-features [version]` | Get Rust version features |
  191. | `/crate-info <crate>` | Get crate information |
  192. | `/docs <crate> [item]` | Get API documentation |
  193. | `/sync-crate-skills` | Sync skills from Cargo.toml dependencies |
  194. | `/update-crate-skill <crate>` | Update specific crate skill |
  195. | `/clean-crate-skills` | Clean local crate skills |
  196. ## Dynamic Skills
  197. Generate skills on-demand from your project dependencies:
  198. ```bash
  199. # Enter your Rust project
  200. cd my-rust-project
  201. # Sync all dependencies
  202. /sync-crate-skills
  203. # Skills are created at ~/.claude/skills/{crate}/
  204. ```
  205. ### Features
  206. - **On-demand generation**: Created from Cargo.toml dependencies
  207. - **Local storage**: `~/.claude/skills/`
  208. - **Version tracking**: Each skill records crate version
  209. - **Workspace support**: Parses all workspace members
  210. ## How It Works
  211. ```
  212. User Question
  213. │
  214. ▼
  215. ┌─────────────────────────────────────────┐
  216. │ Hook Layer │
  217. │ 400+ keywords trigger meta-cognition │
  218. └─────────────────────────────────────────┘
  219. │
  220. ▼
  221. ┌─────────────────────────────────────────┐
  222. │ rust-router │
  223. │ Identify entry layer + domain │
  224. │ Decision: dual-skill loading │
  225. └─────────────────────────────────────────┘
  226. │
  227. ├──────────────┬──────────────┐
  228. ▼ ▼ ▼
  229. ┌──────────┐ ┌──────────┐ ┌──────────┐
  230. │ Layer 1 │ │ Layer 2 │ │ Layer 3 │
  231. │ m01-m07 │ │ m09-m15 │ │ domain-* │
  232. └──────────┘ └──────────┘ └──────────┘
  233. │
  234. ▼
  235. Domain-correct architectural solution
  236. ```
  237. ## Documentation
  238. - [Architecture (中文)](./docs/architecture-zh.md)
  239. - [Functional Overview (中文)](./docs/functional-overview-zh.md)
  240. - [Hook Mechanism (中文)](./docs/hook-mechanism-zh.md)
  241. - [Prompt Engineering (中文)](./docs/prompt-engineering-zh.md)
  242. - [Meta-Cognition Example: E0382](./docs/meta-cognition-example-e0382.md)
  243. ## Contributing
  244. Contributions are welcome! Please read our contributing guidelines before submitting PRs.
  245. ## Acknowledgments
  246. - [@pinghe](https://github.com/pinghe) - `context: fork` support suggestion ([#4](https://github.com/actionbook/rust-skills/issues/4))
  247. - [@DoiiarX](https://github.com/DoiiarX) - OpenCode installation fix ([#6](https://github.com/actionbook/rust-skills/issues/6))
  248. ## License
  249. MIT License - see [LICENSE](LICENSE) for details.
  250. ## Links
  251. - **GitHub**: https://github.com/actionbook/rust-skills
  252. - **Issues**: https://github.com/actionbook/rust-skills/issues

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.