Rust Skills - Comprehensive Rust Expert System

A comprehensive Rust programming expert skill system containing 40+ sub-skills covering everything from beginner to expert level. Designed for Claude Code CLI and AI-assisted development.

---

English | 中文

---

🎯 Overview

Rust Skills is a meticulously crafted AI assistant skill system designed specifically for Rust programming. It provides comprehensive guidance from basic syntax to advanced patterns, with each skill deeply customized for specific domains to ensure precise solutions.

✨ Key Features

• 🎓 Layered Design: Core → Advanced → Expert progression
• 🎯 Problem-Oriented: Automatic routing based on problem type
• 💡 Practice-First: Direct-to-use code patterns and best practices
• 📚 Comprehensive Coverage: 40+ specialized skills covering all Rust domains
• 🔄 Continuously Updated: Regular skill additions and improvements (22/40 optimized for Claude Code)
• 🌍 Bilingual: English SKILL.md + Chinese SKILL_ZH.md for all optimized skills

---

📊 Skill Structure

┌─────────────────────────────────────────────────────┐
│                   rust-skill                         │
│              (Main Entry Point)                      │
└─────────────────────────────────────────────────────┘
                          │
     ┌────────────────────┼────────────────────┐
     ↓                    ↓                    ↓
┌─────────┐         ┌─────────┐         ┌─────────┐
│  Core   │         │Advanced │         │ Expert  │
│    7    │         │   13    │         │   20    │
└─────────┘         └─────────┘         └─────────┘

Progress: 22/40 skills optimized for Claude Code (55%)

---

📚 Skill List

🔵 Core Skills (Daily Use)

🟢 Advanced Skills (Deep Understanding)

🟡 Expert Skills (Specialized)

Legend: ✅ Optimized | 📝 To be optimized

---

🔍 Problem-Based Lookup

Compilation Errors

Performance Issues

Async Code

Error Handling

Advanced Type System

Web Development & Infrastructure

Systems Programming

Code Quality & Testing

Learning & Ecosystem

Database & Observability

---

🚀 Installation & Usage

Quick Start

Choose your installation method based on your scenario:

📖 See USAGE_GUIDE.md for detailed comparison and setup guidance

Usage Examples

Describe your Rust problem directly, and the system will automatically route to the appropriate sub-skill:

// Ownership & Lifetimes
"How do I fix E0382 borrow checker error?"
"Why does my struct need 'static lifetime?"

// Performance
"How do I optimize this HashMap performance?"
"What's causing false sharing in my concurrent code?"

// Async Programming
"tokio::spawn requires 'static but I have borrowed data"
"I encountered lifetime issues when implementing Stream trait"
"How do I handle backpressure in my async Stream?"

// Web Development
"How do I choose between Axum and Actix for my REST API?"
"How do I implement JWT authentication with Redis session storage?"
"How do I set up CORS and rate limiting middleware?"

// Type System
"What's the difference between Cell and RefCell?"
"How do I use PhantomData for type-level state machines?"
"How do I fix 'one type is more general than the other' error?"

// Systems Programming
"How do I call C++ code from Rust and handle exceptions?"
"How do I write no_std code for RISC-V embedded development?"

---

🔗 Skill Relationships

rust-skill (main entry)
    │
    ├─► rust-ownership ──► rust-mutability ──► rust-concurrency ──► rust-async
    │         │                     │                     │              │
    │         │                     │                     └──► rust-actor
    │         └─► rust-unsafe ──────┘
    │                   │
    │                   └─► rust-ffi ─────────────────────► rust-ebpf
    │                             │                         │
    │                             └────────────────────────► rust-gpu
    │
    ├─► rust-error ──► rust-error-advanced ──► rust-anti-pattern
    │
    ├─► rust-coding ──► rust-performance
    │
    ├─► rust-web ──► rust-middleware ──► rust-auth ──► rust-xacml
    │                              │
    │                              └─► rust-cache
    │
    ├─► rust-type-driven ──► rust-lifetime-complex
    │
    └─► rust-learner ──► rust-ecosystem / rust-embedded
              │
              └─► rust-pin / rust-macro / rust-const
                        │
                        └─► rust-async-pattern / rust-coroutine

---

🛠️ Development Workflow

Code Analysis Checklist

1. ✅ Identify ownership and borrowing patterns
2. ✅ Check for lifetime issues
3. ✅ Evaluate error handling strategies
4. ✅ Assess concurrency safety (Send/Sync)
5. ✅ Review API ergonomics

Problem Solving Approach

1. Start with safe, idiomatic solutions
2. Only use unsafe when absolutely necessary
3. Prefer type system over runtime checks
4. Use ecosystem crates appropriately
5. Consider performance implications

Best Practices

• ✅ Always use Result and Option for error handling
• ✅ Implement std::error::Error for custom errors
• ✅ Write comprehensive tests (unit + integration + doc)
• ✅ Document public APIs with rustdoc comments
• ✅ Use cargo clippy and cargo fmt regularly
• ✅ Follow Rust API guidelines

---

⚡ Quick Commands

# Type checking
cargo check

# Release build with optimizations
cargo build --release

# Run tests
cargo test --lib --doc

# Code linting
cargo clippy -- -W clippy::all

# Code formatting
cargo fmt --check

# Generate documentation
cargo doc --open

# Benchmarking (with criterion)
cargo bench

# Security audit
cargo audit

---

📁 Project Structure

rust-skills/
├── README.md                   # This file
├── README_zh.md                # Chinese README
├── LICENSE                     # MIT License
├── USAGE_GUIDE.md              # Installation guide
├── USAGE_GLOBAL.md             # Global install guide
├── USAGE_SUBMODULE.md          # Git submodule guide
├── CLAUDE_CODE_GUIDE.md        # Claude Code setup (EN)
├── CLAUDE_CODE_GUIDE_zh.md     # Claude Code setup (ZH)
├── SKILL_AUDIT_REPORT.md       # Skill optimization progress
├── .claude/                    # Claude Code config
│   └── settings.local.json
├── .codex/                     # Codex configuration
│   └── skills/                 # Codex skill symlinks
├── scripts/                    # Development scripts
│   ├── check-frontmatter.sh    # Validate skill frontmatter
│   └── check-structure.sh      # Validate skill structure
└── skills/                     # All skills (40+)
    ├── rust-skill/             # Main entry point
    ├── rust-ownership/         # ✅ Optimized
    ├── rust-mutability/        # ✅ Optimized
    ├── rust-concurrency/       # ✅ Optimized
    ├── rust-async/             # ✅ Optimized
    ├── rust-async-pattern/     # ✅ Optimized
    ├── rust-actor/             # ✅ Optimized
    ├── rust-error/             # ✅ Optimized
    ├── rust-coding/            # ✅ Optimized
    ├── rust-unsafe/            # ✅ Optimized
    ├── rust-anti-pattern/      # ✅ Optimized
    ├── rust-performance/       # ✅ Optimized
    ├── rust-web/               # ✅ Optimized
    ├── rust-learner/           # ✅ Optimized
    ├── rust-ecosystem/         # ✅ Optimized
    ├── rust-ffi/               # ✅ Optimized
    ├── rust-pin/               # ✅ Optimized
    ├── rust-macro/             # ✅ Optimized
    ├── rust-const/             # ✅ Optimized
    ├── rust-type-driven/       # ✅ Optimized
    ├── rust-lifetime-complex/  # ✅ Optimized
    ├── rust-cache/             # ✅ Optimized
    ├── rust-auth/              # ✅ Optimized
    ├── rust-middleware/        # ✅ Optimized
    └── ... (17 more to optimize)

---

🤝 Contributing

Contributions for new skills or improvements are welcome! Please ensure:

1. Follow the established skill structure (see optimized skills as examples)
2. Include both English SKILL.md and Chinese SKILL_ZH.md
3. Add proper frontmatter with triggers under metadata
4. Include: Core Question, Solution Patterns, Workflow, Review Checklist, Verification Commands, Common Pitfalls

---

📄 License

MIT License - Copyright © 2026 李偏偏 ([email protected])

---

🌟 Acknowledgments

This skill system is designed for use with:

• Claude Code CLI - Official Claude AI development tool
• AI-assisted development environments (Cursor, VS Code + Claude, etc.)

---

Made with ❤️ for the Rust community