Rust Module Architect skill for Claude and Codex
A compilable Rust module skeleton designed before the code: public API, core structs, trait boundaries, visibility, and a test scaffold with todo bodies, with…
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a new Rust module needs its structure decided up front (structs, traits, visibility, ownership) as a compilable skeleton before the logic is written. Do not use for filling in a fully specified module, analysing existing code, or documenting it. Related topics: coding, rust.
What it will ask you for
- Module name (free text, e.g. "my_module")
- Purpose (longer free text)
- Core structs (choose any: Config, State, Manager, Handler)
- Traits to implement (choose any: Serialize, Clone, Debug, AsyncRead)
- Visibility (choose one: pub, pub(crate), private)
- Test depth (choose one: minimal, standard, thorough)
- Input 7 (choose one: cfg(test))
How it works
- Settle the ownership model: which struct owns the data, which borrow it, and where Arc or lifetimes are required.
- Define the smallest public API that fulfils the purpose, applying the chosen visibility consistently and keeping everything else private.
- Derive the selected traits where possible and write stub impls where a derive cannot work.
- Give every function a signature, a doc comment, and a todo!() body so the skeleton compiles as written.
- Add a #[cfg(test)] module with behaviour-named tests at the chosen depth and summarise the design in the table and rationale lines.
What you get
A code block with the compilable skeleton, a markdown table of name, purpose, structs, traits, visibility, and test depth, and one rationale line per struct or trait.
What it watches out for
- Deriving Clone on a struct that holds a mutex or a file handle, which either fails to compile or clones the wrong thing.
- Making every item pub so the module compiles quickly, which freezes the internal layout into the public API.
- Leaving function bodies empty instead of todo!(), so the skeleton fails type checking on missing return values.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.