1---2name: rust-agents-orchestrator3description: Use when starting any Rust task to route to the correct rust-* skill, and when finishing any Rust task to run the cross-skill quality checklist (clippy, rustfmt, MSRV, edition idioms, error handling, async hygiene, doc coverage). Prevents loading the wrong skill, missing a relevant skill, and shipping Rust code that fails clippy or ignores the project MSRV. Covers: a routing table mapping user-prompt patterns to rust-* skills (ownership question to rust-syntax-ownership, lifetime error to rust-errors-lifetimes, async runtime question to rust-impl-async-tokio, etc.), and a cross-skill quality checklist every Rust task should pass before completion. Keywords: "which Rust skill", "Rust task routing", "Rust code review checklist", "rust quality gate", clippy, rustfmt, MSRV, "Rust best practice check", "Rust code quality", "before I ship Rust", orchestrator, "Rust skill index", "what skill for", routing, "Rust checklist".4license: MIT5---67# Rust Agents Orchestrator89This is the routing brain of the Rust skill package. It does two jobs:10111. **Route**: at the START of a Rust task, map the user prompt to the exact `rust-*` skill (or skills) to load.122. **Gate**: at the END of a Rust task, run the cross-skill quality checklist before declaring the work done.1314ALWAYS run step 1 before writing Rust code. ALWAYS run step 2 before reporting a Rust task complete.1516This skill routes and checklists. It does NOT do deep lint review: that is `rust-agents-code-reviewer`. It does NOT iterate on compiler errors: that is `rust-agents-compile-fix`. Treating these three as interchangeable is an anti-pattern.1718## The Package: 44 Skills, 5 Categories1920| Category | Count | Prefix | Purpose |21|----------|-------|--------|---------|22| core | 6 | `rust-core-` | Cross-cutting concepts, architecture, mental models |23| syntax | 15 | `rust-syntax-` | Language mechanics, API patterns, code form |24| impl | 13 | `rust-impl-` | Development workflows, end-to-end tasks |25| errors | 7 | `rust-errors-` | Diagnosing and fixing compiler/runtime errors |26| agents | 3 | `rust-agents-` | Routing, review, compile-fix orchestration |2728## Routing Table: Prompt Pattern to Skill2930ALWAYS pick the most specific skill. If a prompt contains a rustc error code (E0xxx) or the word "error"/"fails to compile", route to an `errors-*` skill, NOT a `syntax-*` skill.3132### Ownership, borrowing, lifetimes3334| User prompt signal | Skill |35|--------------------|-------|36| "move", "value used after move", "who owns this" | [[rust-syntax-ownership]] |37| E0382, "borrow of moved value" | [[rust-errors-borrow-checker]] |38| "`&` vs `&mut`", "borrow", "two-phase borrow", "RefCell" | [[rust-syntax-borrowing]] |39| E0502 / E0596 / E0500, "cannot borrow as mutable" | [[rust-errors-borrow-checker]] |40| "lifetime annotation", "`'a`", "HRTB", "`'static`" | [[rust-syntax-lifetimes]] |41| E0106 / E0623 / E0495 / E0700, "missing lifetime specifier" | [[rust-errors-lifetimes]] |4243### Traits, generics, type system4445| User prompt signal | Skill |46|--------------------|-------|47| "trait", "default method", "supertrait", "orphan rule", "blanket impl" | [[rust-syntax-traits]] |48| "generic", "type parameter", "`where` clause", "monomorphization", "const generics" | [[rust-syntax-generics]] |49| "`dyn Trait`", "trait object", "object safety", "vtable", "trait upcasting" | [[rust-syntax-trait-objects]] |50| "GAT", "generic associated type", "LendingIterator" | [[rust-syntax-gats]] |51| E0277 / E0599 / E0220, "trait bound not satisfied", "method not found" | [[rust-errors-trait-bounds]] |5253### Control flow, iterators, pointers5455| User prompt signal | Skill |56|--------------------|-------|57| "`match`", "`if let`", "`let else`", "destructure", "exhaustiveness", "or-pattern" | [[rust-syntax-pattern-matching]] |58| "iterator", "`map`/`filter`/`fold`", "closure", "`Fn`/`FnMut`/`FnOnce`", "`collect`" | [[rust-syntax-iterators-closures]] |59| "`Box`", "`Rc`", "`Arc`", "`Cell`", "`OnceLock`", "`Weak`", "smart pointer" | [[rust-syntax-smart-pointers]] |6061### Async6263| User prompt signal | Skill |64|--------------------|-------|65| "`async fn`", "`.await`", "async block", "async closure", "AFIT", "RPITIT" | [[rust-syntax-async-await]] |66| "Future trait", "executor", "Poll", "runtime choice", "structured concurrency" (concept) | [[rust-core-async-runtime]] |67| "tokio", "`tokio::spawn`", "`spawn_blocking`", "`select!`", "`JoinSet`", "timeout" | [[rust-impl-async-tokio]] |68| "`!Send` future", "Send across `.await`", async Pin/Unpin runtime error | [[rust-errors-async]] |6970### Macros, unsafe, FFI7172| User prompt signal | Skill |73|--------------------|-------|74| "`macro_rules!`", "declarative macro", "fragment specifier", "macro hygiene" | [[rust-syntax-macros-declarative]] |75| "proc macro", "derive macro", "`syn`", "`quote`", "`proc_macro2`" | [[rust-syntax-macros-procedural]] |76| "`unsafe`", "raw pointer", "UB", "strict provenance", "`unsafe extern`", "miri" | [[rust-syntax-unsafe]] |77| "FFI", "`extern \"C\"`", "bindgen", "cbindgen", "`#[repr(C)]`", "C interop" | [[rust-impl-ffi-bindgen]] |7879### Edition, toolchain, core concepts8081| User prompt signal | Skill |82|--------------------|-------|83| "edition 2024", "migrate to 2024", "edition migration", "edition idioms", "`gen` block" | [[rust-syntax-edition-2024]] |84| "rustup", "channels", "components", "clippy setup", "rustfmt config", "MSRV management" | [[rust-core-toolchain]] |85| "which Rust version", "edition system", "stability", "`rust-version`", "release matrix" | [[rust-core-language-versions]] |86| "type system", "ZST", "`repr`", "niche optimization", "never type", "type-state" | [[rust-core-type-system]] |87| "memory model", "stack vs heap", "drop scope", "RAII", "Send/Sync overview" | [[rust-core-memory-model]] |88| "stdlib", "which std module", "prelude", "`std::collections`", "`std::sync`" | [[rust-core-stdlib-overview]] |8990### Cargo and project workflows9192| User prompt signal | Skill |93|--------------------|-------|94| "`cargo new`", "Cargo.toml", "features", "profiles", "`[lints]` table" | [[rust-impl-cargo-project]] |95| "workspace", "member crate", "virtual manifest", "workspace inheritance" | [[rust-impl-workspaces]] |96| "build.rs", "build script", "`OUT_DIR`", "code generation", "`rerun-if-changed`" | [[rust-impl-build-scripts]] |97| "cross-compile", "target triple", "`rustup target add`", "`cross` crate", "`cfg`" | [[rust-impl-cross-compile]] |9899### Error handling design and error skills100101| User prompt signal | Skill |102|--------------------|-------|103| "`Result`/`Option` idioms", "`?` operator", "custom error type", "error design" | [[rust-impl-error-handling]] |104| "`thiserror`", "`anyhow`", "library vs application errors", "error context" | [[rust-errors-thiserror-anyhow]] |105| "panic", "`RUST_BACKTRACE`", "abort vs unwind", "index out of bounds at runtime" | [[rust-errors-runtime]] |106| "linker error", "missing native lib", "version conflict", "`cargo update`", MSRV mismatch | [[rust-errors-build-link]] |107108### Concurrency, common crates, testing109110| User prompt signal | Skill |111|--------------------|-------|112| "`Arc<Mutex>`", "`RwLock`", "atomics", "`Ordering`", "deadlock", "scoped thread" | [[rust-impl-concurrency]] |113| "channel", "`mpsc`", "`oneshot`", "`broadcast`", "`watch`", "backpressure" | [[rust-impl-channels]] |114| "serde", "`Serialize`/`Deserialize`", "JSON/TOML/YAML", "`#[serde(...)]`" | [[rust-impl-serde]] |115| "clap", "CLI args", "`derive(Parser)`", "subcommand", "shell completion" | [[rust-impl-clap-cli]] |116| "`#[test]`", "integration test", "doc test", "`nextest`", "`criterion`", "bench" | [[rust-impl-testing]] |117| "`#![no_std]`", "embedded", "`#[panic_handler]`", "`#[global_allocator]`" | [[rust-impl-no-std]] |118119### Agent / meta skills120121| User prompt signal | Skill |122|--------------------|-------|123| "review my Rust code", "is this idiomatic", deep clippy lint review | [[rust-agents-code-reviewer]] |124| "fix this compile error", iterate on rustc output, follow `--explain` suggestions | [[rust-agents-compile-fix]] |125| "which skill", "route this task", "run the quality checklist" | this skill |126127## Decision Tree: Ambiguous Prompt to Skill128129```130Rust task arrives131├── Contains an E0xxx code or "does not compile"? ......... ROUTE to errors-*132│ ├── E0382 / E0502 / E0596 / E0500 ............. rust-errors-borrow-checker133│ ├── E0106 / E0623 / E0495 / E0700 ............. rust-errors-lifetimes134│ ├── E0277 / E0599 / E0220 ..................... rust-errors-trait-bounds135│ ├── linker / native lib / version clash ....... rust-errors-build-link136│ ├── async `!Send` / Pin across .await ......... rust-errors-async137│ └── panic / OOB / abort at runtime ............ rust-errors-runtime138├── "How do I build / set up X"? ...................... ROUTE to impl-*139├── "Why does Rust work like X" (concept)? ............ ROUTE to core-*140├── "What is the syntax for X" (language form)? ....... ROUTE to syntax-*141├── "Review / is this idiomatic"? ..................... rust-agents-code-reviewer142└── Multiple skills plausible? ........................ load the NARROWEST143 that names the exact construct, then load its core-* concept skill144 only if the user needs the mental model, not just the syntax.145```146147ALWAYS prefer the narrowest match. NEVER load a `core-*` overview when the user asked a concrete `syntax-*` or `impl-*` question. Load 1 to 3 skills, not the whole package.148149## Cross-Skill Quality Checklist150151Run this BEFORE declaring ANY Rust task complete. Every item is a hard gate.152153| # | Check | Command / inspection | Pass criterion |154|---|-------|----------------------|----------------|155| a | Edition + MSRV | read `edition` and `rust-version` in Cargo.toml | code uses only features available at the stated MSRV; edition is 2024 unless the project pins older |156| b | Clippy | `cargo clippy --all-targets -- -D warnings` | no warnings; correctness + suspicious + perf clean |157| c | Formatting | `cargo fmt --all --check` | exits 0, no diff |158| d | No panics on fallible paths | grep `.unwrap()` / `.expect()` in non-test code | every remaining one is on a genuinely infallible path or has a justifying comment |159| e | Async hygiene | inspect `.await` points | no blocking call on the async executor; no `!Send` value held across `.await` in a spawned task |160| f | Doc coverage | `cargo doc` + inspect public items | every public item has a `///` doc; add a doctest where it clarifies usage |161| g | Unsafe is justified | grep `unsafe` blocks | every `unsafe` block has a `// SAFETY:` comment stating the invariant |162| h | Error type contract | inspect library error types | error types implement `std::error::Error` + `Display`; a library does NOT leak `anyhow::Error` in its public API |163| i | Tests | `cargo test --all-targets` and `cargo test --doc` | all unit, integration, and doc tests pass |164165If any item fails, fix it and re-run the failing check. NEVER report a Rust task done with an unchecked item.166167See `references/methods.md` for the full command set and CI wiring, `references/examples.md` for worked routing and checklist runs, `references/anti-patterns.md` for routing and gating mistakes.168169## Quick Reference170171- Routing happens FIRST, the checklist happens LAST. Never skip either.172- Error code present means an `errors-*` skill, never a `syntax-*` skill.173- `cargo build` passing is NOT the quality gate. `cargo clippy` plus `cargo fmt --check` plus `cargo test` is.174- MSRV is set by `rust-version` in Cargo.toml. A new dependency must not raise it silently.175- This skill routes and gates. Deep review is `rust-agents-code-reviewer`. Error iteration is `rust-agents-compile-fix`.176177## Reference Links178179- Rust API Guidelines: https://rust-lang.github.io/api-guidelines/180- Clippy lint reference: https://rust-lang.github.io/rust-clippy/master/181- `references/methods.md`: command set, clippy lint groups, CI configuration182- `references/examples.md`: worked routing and checklist examples183- `references/anti-patterns.md`: routing and quality-gate anti-patterns
Impertio-Studio