A collection of 179 curated rules designed to enhance AI coding agents' ability to generate high-quality Rust code. This project provides a structured knowledge base for agents, enabling them to offer more idiomatic, efficient, and robust suggestions, ultimately improving developer productivity and code quality for Rust projects.

How It Works

This project offers a comprehensive set of 179 rules, categorized into 14 distinct areas relevant to Rust development, such as Ownership & Borrowing, Error Handling, Async, and Optimization. These rules are formatted for consumption by AI coding agents that support "skills" or similar rule-loading mechanisms. Upon installation, agents can leverage these rules to review code, identify potential issues, and suggest improvements based on established Rust best practices and patterns.

Quick Start & Requirements

The primary installation method is via the npx command: npx add-skill leonardomso/rust-skills This command automatically detects compatible AI agents and installs the skill. Manual installation instructions are provided for specific agents like Claude Code, Cursor, Windsurf, Copilot, Aider, and others, often involving git clone or curl commands to download the SKILL.md file or repository. The main requirement is an AI coding agent that supports external rule sets or skills.

Highlighted Details

• Contains 179 rules across 14 categories, including Ownership, Error Handling, Memory, API Design, Async, Optimization, Naming, Type Safety, Testing, Docs, Performance, Project Structure, Linting, and Anti-patterns.
• Each rule includes rationale ("Why it matters"), code examples (bad and good), and relevant official documentation links.
• Rules are derived from authoritative sources like the Rust API Guidelines, Rust Performance Book, Rust Design Patterns, and real-world codebases (e.g., ripgrep, tokio, serde).
• Supports integration with a wide array of AI coding agents, including Claude Code, Cursor, Windsurf, Copilot, Codex, Aider, Zed, Amp, and Cline.

Maintenance & Community

Contributions in the form of Pull Requests are welcomed to expand or refine the existing rules. The project is hosted on GitHub, serving as the primary hub for development and community interaction.

Licensing & Compatibility

The project is released under the MIT License, which is highly permissive and allows for commercial use, modification, and distribution without significant restrictions. This license ensures broad compatibility for integration into various development workflows and tools.

Limitations & Caveats

This is a static collection of rules intended to augment AI coding agents; it does not provide runtime analysis or automated code fixing itself. The effectiveness of these rules is dependent on the AI agent's implementation and its ability to interpret and apply them contextually.