Individual skill
rust-best-practices
Write idiomatic, robust, maintainable Rust. Use this skill whenever you write, review, refactor, debug, or explain Rust code: new crates, modules, functions, structs, traits, error types, async code, unsafe or FFI code, Cargo.toml, tests, or rustdoc. Trigger on any mention of Rust, cargo, crates, .rs files, the borrow checker, lifetimes, traits, clippy, or rustfmt, even when the user does not ask for "best practices" or "idiomatic" code. Synthesized from the Google Rust Style Guide, the Rust API Guidelines, Effective Rust, Rust Design Patterns, and Microsoft's Pragmatic Rust Guidelines.
skills/rust-best-practices/SKILL.md
Source commit edd3e86087eda07983251056508fe3b8856d85d7
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Local scripts
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,769
- Repository last updated
- Nov 8, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- claude-code Repository topic
- claude-plugin Repository topic
- claude-skills Repository topic
- coding-agent Repository topic
- rust Repository topic
- style-guide Repository topic
- agent-skills Repository topic
- clippy Repository topic
- code-review Repository topic
- cursor Repository topic
- engineering Derived category
- design Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 29,732 bytesSKILL.mdcore · 29,732 bytesevals/bevy-arena-regen/case.yamlasset · 783 bytesevals/bevy-arena-regen/files/Cargo.lockasset · 33,240 bytesevals/bevy-arena-regen/files/Cargo.tomlasset · 354 bytesevals/bevy-arena-regen/files/src/lib.rsasset · 6,357 bytesevals/bevy-arena-regen/files/tests/arena.rsasset · 3,395 bytesevals/bevy-arena-regen/graders/01-builds-and-tests-pass.mddoc · 167 bytesevals/bevy-arena-regen/graders/02-regen-tested-headless.mddoc · 272 bytesevals/bevy-arena-regen/graders/03-system-params-by-value.mddoc · 212 bytesevals/bevy-arena-regen/graders/04-keeps-bevy-prelude.mddoc · 159 bytesevals/bevy-arena-regen/graders/05-plain-data-components.mddoc · 208 bytesevals/bevy-arena-regen/graders/06-ordered-after-damage.mddoc · 334 bytesevals/bevy-arena-regen/graders/07-no-panicking-queries.mddoc · 186 bytesevals/bevy-arena-regen/graders/08-clippy-clean.mddoc · 125 bytesevals/bevy-arena-regen/graders/09-health-never-exceeds-max.mddoc · 134 bytesevals/bevy-arena-regen/graders/10-existing-code-not-rewritten.mddoc · 275 bytesevals/bevy-arena-regen/place-files.shruns · 62 bytesevals/bevy-arena-regen/prompt.mddoc · 480 bytesevals/log-summary-cli/case.yamlasset · 581 bytesevals/log-summary-cli/graders/01-never-panics-on-bad-input.mddoc · 212 bytesevals/log-summary-cli/graders/02-errors-name-the-file.mddoc · 104 bytesevals/log-summary-cli/graders/03-malformed-lines-counted.mddoc · 186 bytesevals/log-summary-cli/graders/04-paths-as-path-types.mddoc · 168 bytesevals/log-summary-cli/graders/05-sorted-and-skipped-count.mddoc · 150 bytesevals/log-summary-cli/graders/06-dependency-ranges.mddoc · 134 bytesevals/log-summary-cli/graders/07-map-based-counting.mddoc · 103 bytesevals/log-summary-cli/graders/08-aggregation-unit-tested.mddoc · 147 bytesevals/log-summary-cli/prompt.mddoc · 730 bytesevals/refactor-inventory-module/case.yamlasset · 677 bytesevals/refactor-inventory-module/files/inventory.rsruns · 3,263 bytesevals/refactor-inventory-module/graders/01-deny-warnings-removed.mddoc · 90 bytesevals/refactor-inventory-module/graders/02-no-rc-refcell-in-api.mddoc · 141 bytesevals/refactor-inventory-module/graders/03-borrowed-param-types.mddoc · 157 bytesevals/refactor-inventory-module/graders/04-error-implements-error.mddoc · 108 bytesevals/refactor-inventory-module/graders/05-no-unwrap-on-fallible-paths.mddoc · 209 bytesevals/refactor-inventory-module/graders/06-getter-renamed.mddoc · 132 bytesevals/refactor-inventory-module/graders/07-bool-param-replaced.mddoc · 117 bytesevals/refactor-inventory-module/graders/08-deterministic-report.mddoc · 114 bytesevals/refactor-inventory-module/graders/09-format-over-concat.mddoc · 119 bytesevals/refactor-inventory-module/graders/10-no-check-then-unwrap.mddoc · 128 bytesevals/refactor-inventory-module/graders/11-changes-listed-with-reasons.mddoc · 94 bytesevals/refactor-inventory-module/graders/12-signature-changes-called-out.mddoc · 201 bytesevals/refactor-inventory-module/place-files.shruns · 62 bytesevals/refactor-inventory-module/prompt.mddoc · 507 bytesevals/semver-library-api/case.yamlasset · 575 bytesevals/semver-library-api/graders/01-implements-fromstr.mddoc · 141 bytesevals/semver-library-api/graders/02-implements-display.mddoc · 94 bytesevals/semver-library-api/graders/03-dedicated-error-type.mddoc · 164 bytesevals/semver-library-api/graders/04-common-traits-derived.mddoc · 127 bytesevals/semver-library-api/graders/05-fields-private.mddoc · 125 bytesevals/semver-library-api/graders/06-rustdoc-with-errors-section.mddoc · 132 bytesevals/semver-library-api/graders/07-doc-examples-use-question-mark.mddoc · 86 bytesevals/semver-library-api/graders/08-precedence-rules-tested.mddoc · 152 bytesevals/semver-library-api/graders/09-no-unwrap-in-library-code.mddoc · 136 bytesevals/semver-library-api/graders/10-eq-hash-agree-with-ord.mddoc · 258 bytesevals/semver-library-api/prompt.mddoc · 667 bytesreferences/bevy.mddoc · 7,193 bytesreferences/effective-rust.mddoc · 14,190 bytesreferences/google-rust-style-guide.mddoc · 10,970 bytesreferences/microsoft-rust-guidelines.mddoc · 16,612 bytesreferences/rust-api-guidelines.mddoc · 11,432 bytesreferences/rust-design-patterns.mddoc · 8,429 bytes
Read excerpt
# Rust best practices
Distilled from five Rust style and design guides, with a digest of each in `references/`.
Where they disagree, this file says which to follow and why.
## 1. Mindset
- **Write Rust-shaped code.** Don't port C++, Java, C#, or Python constructs one-to-one.
Model errors with `Result`, resources with ownership and `Drop`, polymorphism with
traits and enums, and nullability with `Option`. Inheritance-flavored tricks (`Deref` to
a "base" struct, `Manager`/`Factory` types, `throw_if_null` helpers) are smells.
- **Make invalid states unrepresentable.** Push invariants into types: enums instead of
bool flags and "must be X if Y" comments, newtypes for units and IDs, fallible
constructors that validate once. Then the compiler enforces what a comment only requests.