rust-refactor-helper

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 as shared immutable value

│ ↓

└── Recommendation: Redesign as Arc, not clone()

```

• 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

Method 1: Marketplace (Recommended)

Install from Claude Code Plugin Marketplace in two steps:

```bash

# Step 1: Add the marketplace

/plugin marketplace add ZhangHanDong/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.

Method 2: NPX

Install using npx:

```bash

npx skills add ZhangHanDong/rust-skills

```

> ⚠️ Note: NPX installs skills only. Rust-skills is a plugin architecture that relies on agents, commands, and hooks for full functionality. For the complete experience, use Method 1 (Marketplace) or Method 3 (Full Plugin).

Method 3: Full Plugin

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

```bash

# Clone the repository

git clone https://github.com/ZhangHanDong/rust-skills.git

# Launch with plugin directory

claude --plugin-dir /path/to/rust-skills

```

Method 4: Skills Only

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

```bash

# 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 | Marketplace | NPX | Full Plugin | Skills Only |

|---------|-------------|-----|-------------|-------------|

| All 31 Skills | ✅ | ✅ | ✅ | ✅ |

| Auto meta-cognition trigger | ✅ | ✅ | ✅ | ❌ |

| Hook-based routing | ✅ | ✅ | ✅ | ❌ |

| Background agents | ✅ | ✅ | ✅ | ✅ |

| Easy updates | ✅ | ✅ | ❌ | ❌ |

Permission Configuration

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

```bash

# Copy example config

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

```

Or create manually:

```bash

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 Platfor