Repolode
morganlinton

morganlinton/BeautifulRust

A set of three Agent Skills and a clippy lints config that teach coding agents to write, review, and port idiomatic Rust.

Stars
1,744
Forks
91
Open issues
2
Last commit
5 days ago

What is it?

Beautiful Rust is a collection of Agent Skills for coding agents such as Claude Code, OpenAI Codex, GitHub Copilot, Cursor, and Gemini CLI. It contains three skills: rust-best-practices, which guides an agent while it writes or changes Rust; rust-review, which produces a prioritized report on existing code and cites the rule behind each finding; and rust-port, which ports C, C++, Python, Go, or JavaScript code to idiomatic Rust while porting the original tests first.

The guidance is distilled from the Google Rust Style Guide, the Rust API Guidelines, Effective Rust, Rust Design Patterns, and Microsoft's Pragmatic Rust Guidelines. A separate lints/ directory provides a drop-in clippy configuration that enforces the machine-checkable rules in CI, such as flagging unwrap() outside tests, unsafe blocks without SAFETY comments, and missing # Errors docs.

The skills install through npx, the Claude Code plugin marketplace, GitHub CLI, Gemini CLI, or by copying folders into an agent's skills directory.

Key features

  • 01Writing skill that steers agents toward idiomatic, robust Rust during coding
  • 02Review skill that cites the rule and shows a fix for each finding
  • 03Porting skill that ports original tests first and writes a PORTING.md with differences
  • 04Drop-in clippy lints configuration for enforcing rules in CI
  • 05Installs on Claude Code, Codex, Copilot, Cursor, and Gemini CLI

Use cases

  • Having a coding agent write new Rust crates with stronger API design and error handling
  • Reviewing a Rust file, crate, or pull request for idiom and safety issues
  • Porting a C, Python, or Go module to Rust while keeping behavior verified by tests
  • Adding enforced Rust style rules to a project's CI pipeline

Quick start

  1. 1

    Install the skills with the any-agent installer (Node 22.20 or later)

    npx skills add morganlinton/BeautifulRust
  2. 2

    Or install as a Claude Code plugin

    claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust
  3. 3

    Copy the clippy lints config next to Cargo.toml, then run clippy with the README's flags

    cargo clippy --all-targets --all-features -- -D warnings

Things to know

  • The skills are for coding agents and only help when an agent that reads the Agent Skills format is used.
  • Running the eval cases makes billed model runs.
  • The clippy lints config is aimed at Rust projects and some lints are meant for libraries only.

In collections

Topics

FAQ

What is BeautifulRust?
A set of three Agent Skills and a clippy lints config that teach coding agents to write, review, and port idiomatic Rust. Beautiful Rust is a collection of Agent Skills for coding agents such as Claude Code, OpenAI Codex, GitHub Copilot, Cursor, and Gemini CLI. It contains three skills: rust-best-practices, which guides an agent while it writes or changes Rust; rust-review, which produces a prioritized report on existing code and cites the rule behind each finding; and rust-port, which ports C, C++, Python, Go, or JavaScript code to idiomatic Rust while porting the original tests first.
Is BeautifulRust free to use? What license does it have?
BeautifulRust is open source under the MIT license. Check the license terms before using it in commercial products.
Is BeautifulRust still maintained?
Actively maintained. The last commit to BeautifulRust was on Nov 2, 2026.
What can I use BeautifulRust for?
Having a coding agent write new Rust crates with stronger API design and error handling Reviewing a Rust file, crate, or pull request for idiom and safety issues Porting a C, Python, or Go module to Rust while keeping behavior verified by tests Adding enforced Rust style rules to a project's CI pipeline
How do I install BeautifulRust?
Install the skills with the any-agent installer (Node 22.20 or later): npx skills add morganlinton/BeautifulRust Or install as a Claude Code plugin: claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust Copy the clippy lints config next to Cargo.toml, then run clippy with the README's flags: cargo clippy --all-targets --all-features -- -D warnings
Where can I get BeautifulRust?
The source code and installation instructions are on GitHub: https://github.com/morganlinton/BeautifulRust

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects