rust-code-style

rust-code-style skill

Apply Wassette's Rust conventions when writing or refactoring .rs files.

Best practices

• Single responsibility: each function and struct has one clear purpose.
• DRY: extract shared logic into reusable functions or modules.
• Descriptive naming: name functions, variables, and types for readability.
• Unit tests: cover every public function and its edge cases.
• Keep it simple: prefer straightforward solutions over clever complexity.
• Dependencies: manage them carefully in Cargo.toml; avoid unnecessary ones that bloat the project.
• Error handling: use anyhow to add context and stack traces.
• Traits and generics: use traits for shared behavior and generics for reusable, type-safe, extensible APIs.
• Thread safety: use stdlib primitives like Arc and Mutex for shared state.
• Performance: choose appropriate data types, e.g. &str over String when possible.

Formatting and linting

Always run before committing:

cargo +nightly fmt          # Format (nightly toolchain required)
cargo clippy --workspace    # Lint; resolve every warning
cargo machete               # Check for unused dependencies

Write code that passes cargo clippy without warnings.

Copyright headers

Every .rs file must start with the Microsoft copyright header. See the copyright-headers skill for the exact format and the automated script.