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).

npx skills add actionbook/rust-skills

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.

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.

# 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.

# 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

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 for reference.

Other Platforms

• •OpenCode: See .opencode/INSTALL.md
• •Codex: See .codex/INSTALL.md

Dependent Skills

Rust Skills relies on these external tools for full functionality:

Meta-Cognition Framework

Core Concept

Don't answer directly. Trace through cognitive layers first.

Layer 3: Domain Constraints (WHY)
├── Domain rules determine design choices
└── Example: Financial systems require immutable, auditable data

Layer 2: Design Choices (WHAT)
├── Design patterns and architectural decisions
└── Example: Use Arc<T> for shared immutable data

Layer 1: Language Mechanics (HOW)
├── Rust language features and compiler rules
└── Example: E0382 is a symptom of ownership design issues

Routing Rules

Skills Overview

Core Skills

• •rust-router - Master router for all Rust questions (invoked first)
• •rust-learner - Fetch latest Rust/crate version info
• •coding-guidelines - Coding conventions lookup

Layer 1: Language Mechanics (m01-m07)

Layer 2: Design Choices (m09-m15)

Layer 3: Domain Constraints (domain-*)

Commands

Dynamic Skills

Generate skills on-demand from your project dependencies:

# Enter your Rust project
cd my-rust-project

# Sync all dependencies
/sync-crate-skills

# Skills are created at ~/.claude/skills/{crate}/

Features

• •On-demand generation: Created from Cargo.toml dependencies
• •Local storage: ~/.claude/skills/
• •Version tracking: Each skill records crate version
• •Workspace support: Parses all workspace members

How It Works

User Question
     │
     ▼
┌─────────────────────────────────────────┐
│           Hook Layer                     │
│  400+ keywords trigger meta-cognition    │
└─────────────────────────────────────────┘
     │
     ▼
┌─────────────────────────────────────────┐
│           rust-router                    │
│  Identify entry layer + domain           │
│  Decision: dual-skill loading            │
└─────────────────────────────────────────┘
     │
     ├──────────────┬──────────────┐
     ▼              ▼              ▼
┌──────────┐  ┌──────────┐  ┌──────────┐
│ Layer 1  │  │ Layer 2  │  │ Layer 3  │
│ m01-m07  │  │ m09-m15  │  │ domain-* │
└──────────┘  └──────────┘  └──────────┘
     │
     ▼
Domain-correct architectural solution

Documentation

• •Architecture (中文)
• •Functional Overview (中文)
• •Hook Mechanism (中文)
• •Prompt Engineering (中文)
• •Meta-Cognition Example: E0382

Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.

Acknowledgments

• •@pinghe - context: fork support suggestion (#4)
• •@DoiiarX - OpenCode installation fix (#6)

License

MIT License - see LICENSE for details.

Links

• •GitHub: https://github.com/actionbook/rust-skills
• •Issues: https://github.com/actionbook/rust-skills/issues