ClaudeMap

Beautiful Rust

Three Agent Skills and a clippy config that teach coding agents to write, review and port idiomatic Rust — every rule cites its source, every example compiles on stable Rust, every lint is proven to fire (MIT)

Skills & Commandsrustcode reviewagent skillsclippyporting

beautiful-rust is a skill set that teaches coding agents to write idiomatic Rust (created 2026-10; 1,769 stars as of writing, 2026-11-09): three standard Agent Skills — rust-best-practices (about 500 lines, 13 sections, covering ownership and borrowing, types and API design, errors and panics, concurrency and async, unsafe and FFI, tests and performance), rust-review (graded review reports for a file, crate or diff, each finding pinned to file:line with the rule it breaks and its source — an API Guidelines code such as C-GETTER, an Effective Rust item, a Microsoft guideline or a clippy lint — plus the smallest fix), and rust-port (ports C, C++, Python, Go or JavaScript to idiomatic Rust, tests first so you can prove behavior matches, designing a Rust API instead of transliterating, with a PORTING.md listing every deliberate difference) — plus a drop-in clippy config under lints/ that enforces the machine-checkable rules in CI (unwrap outside tests, unsafe without a SAFETY comment, #[allow] without a reason, bool parameters, lossy as casts, missing # Errors/# Panics docs, assert! without a message, exported enums that aren't #[non_exhaustive], leftover dbg!/todo!). The guidance is distilled from five sources (Google Rust Style Guide, Rust API Guidelines, Effective Rust, Rust Design Patterns, Microsoft Pragmatic Rust Guidelines); where they disagree, the skill picks a side and says why. A dedicated reference covers Bevy (0.20) so generic advice doesn't fight ECS conventions. Every Rust example is compiled with cargo check via check-examples.py, and every lint is proven to fire by scripts/check-lints.sh. Claude Code can install the whole thing as a plugin (the repo ships its own marketplace manifest); Codex, Copilot, Cursor, Gemini CLI and claude.ai are covered too (one zip per skill, code execution required). Self-reported cross-agent benchmark (2026-10, eight cases, one run per configuration, graded blind by a Claude model): Claude Code (Opus 5.5) 72/85 without the skills, 80/85 with; Codex CLI 53/85 without, 76/85 with.

What it does

  • Three standard Agent Skills — rust-best-practices, rust-review, rust-port — plus a drop-in clippy config that enforces the machine-checkable rules in CI
  • Every rule cites a published source (Google Rust Style Guide, Rust API Guidelines, Effective Rust, Rust Design Patterns, Microsoft Pragmatic Rust Guidelines); where sources disagree the skill picks a side and says why
  • rust-review reports are graded must fix / should fix / consider, each finding at file:line with the rule, its source and the smallest change that fixes it
  • rust-port ports the original tests first, designs a Rust API instead of transliterating, and ships PORTING.md mapping old API and tests to new
  • A Bevy 0.20 reference keeps the skills from breaking ECS conventions, and lists the ECS bugs that compile cleanly (dual mutable queries, read-before-Commands-apply)
  • Every example compiles on stable Rust (check-examples.py) and every lint in the config is proven to fire (scripts/check-lints.sh)

When to use it

For day-to-day agent development and review on Rust codebases: idiomatic output from the first prompt, graded reviews of existing code or PRs, porting legacy C/C++/Python modules to Rust with behavior proven equal, and the clippy config dropped into CI so rules don't slip back.

Getting started

# Claude Code — install as a plugin so updates arrive with one command:
claude plugin install beautiful-rust --marketplace morganlinton/BeautifulRust

# inside a Claude Code session, the same thing is:
/plugin marketplace add morganlinton/BeautifulRust
/plugin install beautiful-rust@beautiful-rust

# any agent, one command (skills installer, Node 22.20+):
npx skills add morganlinton/BeautifulRust

# Cursor or anything else: copy the folders
git clone https://github.com/morganlinton/BeautifulRust
mkdir -p ~/.agents/skills
cp -R BeautifulRust/skills/rust-* ~/.agents/skills/

# enforce in CI:
cargo clippy --all-targets --all-features -- -D warnings

Things to know

The benchmark is self-reported and small: one run per configuration, graded by a Claude model — and it hurt in one case (Claude did worse on the Bevy feature task with the skills). The Bevy reference covers Bevy 0.20 specifically, and Bevy crates need four extra clippy allows or the table flags every idiomatic system signature. Claude Code does not read .agents/skills/ — use ~/.claude/skills/ or the plugin, and restart the agent if the skill doesn't show up. The allow_attributes lints need rust-version 1.81 or later. claude.ai upload takes one zip per skill and requires code execution to be enabled first. Running the evals is real model time and is billed. MIT. 1,769 stars as of writing (2026-11-09).

Repository

morganlinton/BeautifulRust

Charted

Related on the map

  • An instruction-only skill that makes agents research before they ask, plan before they build, and verify before they call anything done.

    • workflow
    • verification
    • quality
    • skill
  • Guizang's agent skill turns your repo's recent updates into a finished promo video — real components, code-rendered animation, an original code-written soundtrack — no video editor involved.

    • agent-skill
    • video
    • promo
    • marketing
  • An agent skill that geolocates a photo with nothing readable in it — OSM geometry, elevation skylines and satellite tiles turn “where was this taken?” into a measured answer with an error radius.

    • agent-skill
    • geolocation
    • osint
    • openstreetmap