rust-skills

Rust Skills

中文 | 日本語

AI-powered Rust development assistant with meta-cognition framework

What is Rust Skills?

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.

The Problem

Traditional AI assistance for Rust:

User: "My trading system reports E0382"
AI: "Use .clone()"  ← Surface fix, ignores domain constraints

The Solution

Rust Skills with meta-cognition:

User: "My trading system reports E0382"

AI (with Rust Skills):
├── Layer 1: E0382 = ownership error → Why is this data needed?
│       ↑
├── Layer 3: Trade records are immutable audit data → Should share, not copy
│       ↓
├── Layer 2: Use Arc<TradeRecord> as shared immutable value
│       ↓
└── Recommendation: Redesign as Arc<T>, not clone()

Features

• Meta-Cognition Framework: Three-layer cognitive model (Domain → Design → Mechanics)
• Real-time Information: Fetch latest Rust versions and crate info via background agents
• Dynamic Skills: Auto-generate skills from your Cargo.toml dependencies
• Domain Extensions: FinTech, ML, Cloud-Native, IoT, Embedded, Web, CLI support
• Coding Guidelines: Complete Rust coding conventions and best practices

Installation

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, 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, 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 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: