idiomatic-rust

name	idiomatic-rust
description	Write idiomatic, high-quality Rust code following community best practices. Use when writing, reviewing, or refactoring Rust code (.rs files, Cargo.toml), converting code to Rust, designing error types with Result/Option, implementing traits, or when discussing ownership, borrowing, lifetimes, or Rust API design patterns.

Idiomatic Rust

This skill provides guidance for writing idiomatic Rust code that follows community conventions, leverages the type system effectively, and produces maintainable, performant software.

Core Principles

1. Leverage the Type System

Rust's type system is your greatest ally. Use it to:

• Make invalid states unrepresentable - Design types so illegal combinations cannot compile
• Encode invariants at compile time - Use newtypes, enums, and const generics
• Prefer From/TryFrom over as casts - Explicit, safe conversions

// BAD: Primitive obsession
fn process_user(user_id: u64, account_id: u64) { ... }

// GOOD: Newtype pattern prevents mixing up IDs
struct UserId(u64);
struct AccountId(u64);
fn process_user(user_id: UserId, account_id: AccountId) { ... }

2. Embrace Ownership and Borrowing

• Accept borrowed data when possible - Use over , over in function parameters