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

Method 1: Full Plugin (Recommended)

This method enables all features including hooks for automatic meta-cognition triggering.

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

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

Method 2: Skills Only

This method only installs skills without hooks. You need to manually invoke skills.

# Clone and copy skills
git clone https://github.com/ZhangHanDong/rust-skills.git
cp -r rust-skills/skills/* ~/.claude/skills/

⚠️ Note: Without hooks, meta-cognition won't trigger automatically. You must manually call /rust-router or specific skills.

Feature Comparison

Feature	Full Plugin	Skills Only
All Skills	✅	✅
Auto meta-cognition trigger	✅	❌
Hook-based routing	✅	❌
Background 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 for reference.

Other Platforms

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

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

User Signal	Entry Layer	Trace Direction	Primary Skill
E0xxx errors	Layer 1	Trace UP ↑	m01-m07
"How to design..."	Layer 2	Bidirectional	m09-m15
"[Domain] app development"	Layer 3	Trace DOWN ↓	domain-*
Performance issues	Layer 1→2	Up then Down	m10-performance

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)

Skill	Core Question	Triggers
m01-ownership	Who should own this data?	E0382, E0597, move, borrow
m02-resource	What ownership pattern fits?	Box, Rc, Arc, RefCell
m03-mutability	Why does this data need to change?	mut, Cell, E0596, E0499
m04-zero-cost	Compile-time or runtime polymorphism?	generic, trait, E0277
m05-type-driven	How can types prevent invalid states?	newtype, PhantomData
m06-error-handling	Expected failure or bug?	Result, Error, panic, ?
m07-concurrency	CPU-bound or I/O-bound?	async, Send, Sync, thread