Add Idiomatic Rust Review skill + Claude Code plugin manifest#55
Open
kzadorozhny wants to merge 3 commits into
Open
Add Idiomatic Rust Review skill + Claude Code plugin manifest#55kzadorozhny wants to merge 3 commits into
kzadorozhny wants to merge 3 commits into
Conversation
Adds a Claude Code skill under skills/idiomatic-rust-review/ that synthesizes review rules from this repository's resources, the Rust API Guidelines, Canonical's Rust Best Practices, Elements of Rust, and Clippy. Also registers it as a project entry in resources.json.
Adds .claude-plugin/marketplace.json and .claude-plugin/plugin.json so users can run `/plugin marketplace add mre/idiomatic-rust` and then `/plugin install idiomatic-rust-review@idiomatic-rust` to use the skill from Claude Code.
Adds a "Use as a Claude Code Skill" section to the README template with the `/plugin marketplace add` and `/plugin install` commands so users can discover and install the bundled idiomatic-rust-review skill.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds an installable Claude Code skill that turns the resources collected in this repository into an automated Rust code reviewer, plus the marketplace manifests needed so anyone can install it with a single command.
After this lands, users will be able to run
/plugin marketplace add mre/idiomatic-rustfollowed by/plugin install idiomatic-rust-review@idiomatic-rustfrom Claude Code, and the skill will activate automatically whenever they paste Rust code or ask for a Rust review.What's included
skills/idiomatic-rust-review/SKILL.md— a peer-reviewed ruleset (12 top-tier rules with severity tagsMUST/SHOULD/MAY, a reviewer process checklist, a "what not to flag" list, and a structured output format) synthesized from this repository's corpus, the Rust API Guidelines, Canonical's Rust Best Practices, Elements of Rust, and Clippy.skills/idiomatic-rust-review/references/— 12 category files (error handling, types & conversions, ownership & lifetimes, iterators, API design, async & concurrency, pattern matching, documentation & naming, unsafe & performance, anti-patterns, a flat rule index, and a worked before/after example) that the reviewer loads on demand, with each rule citing its source from this corpus..claude-plugin/marketplace.json+.claude-plugin/plugin.json— minimal Claude Code plugin manifests so the repo doubles as a plugin marketplace. The skill is sourced at./, so the existingskills/directory is auto-discovered.resources.json+render/templates/README.md— registers the skill as a project entry and adds a "🤖 Use as a Claude Code Skill" section to the rendered README with the install commands. README.md is regenerated viamake render.Design notes
The skill ruleset is opinionated but deliberately conservative — it scopes which rules are
MUSTvsSHOULDvsMAY, tells reviewers to pick the 5–10 highest-value findings rather than nitpicking, and includes an explicit "what NOT to flag" list. Every rule cites the source resource it came from, most of which are already inresources.json, so the review output stays traceable to this corpus.Plugin manifests are intentionally minimal (just
name,description,version, owner). The plugin'ssourceis./so adding more skills to this repo later is a one-line change tomarketplace.json.Test plan
make renderruns cleanly and regeneratesREADME.mdwith the new section and resource entry/plugin marketplace add mre/idiomatic-rustresolves the manifest/plugin install idiomatic-rust-review@idiomatic-rustinstalls the skill from the marketplace.rssnippet into Claude Code activates the skill and produces a review in the documented output format/plugin uninstall idiomatic-rust-review@idiomatic-rustcleanly removes it