# Generate Cargo

> Scaffold a Cargo project with idiomatic structure and edition 2021

- Skill: `erp-core-dev/generate-cargo` (Agent Skill)
- Install (CLI): `npx skillmds@latest add erp-core-dev/generate-cargo`
- Raw SKILL.md: https://api.skillmd.com/api/skills/erp-core-dev/generate-cargo/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ERP-CORE-DEV (https://skillmd.com/u/erp-core-dev)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/erp-core-dev/generate-cargo

---


# Generate Cargo Project

Scaffold a Rust Cargo project with idiomatic structure and Cargo best practices.

## What To Do

1. **Cargo.toml** with edition = "2021", pinned dependency versions, and [profile.release] optimizations
2. **src/lib.rs or src/main.rs** with module declaration skeleton and top-level lint attributes
3. **src/error.rs** with a thiserror-derived error type
4. **tests/ directory** with a basic integration test stub
5. **benches/ directory** with a criterion benchmark stub
6. **.cargo/config.toml** with rustflags = ["-D", "warnings"]

## Project Types

### lib (default)
- src/lib.rs re-exports the public API
- Include #![deny(missing_docs)] and #![deny(clippy::unwrap_used)]

### bin
- src/main.rs entry point with anyhow::Result return type
- Suitable for CLI tools and application binaries

### workspace
- Root Cargo.toml with [workspace] members list
- crates/{name}-core/ (lib) and crates/{name}-cli/ (bin) as initial members
- Shared [workspace.dependencies] table for version pinning

## Best Practices
- Set edition = "2021" in every Cargo.toml
- Pin dependencies to major.minor.* (e.g., serde = "1.0.*")
- Add [profile.release] with lto = true, codegen-units = 1, opt-level = 3
- Use [workspace.dependencies] to deduplicate versions across workspace members
- List thiserror for lib crates, anyhow for bin crates

## Arguments
- `<project-name>`: Crate name in snake_case (e.g., my_service, data_pipeline)
- `--type=<lib|bin|workspace>`: Project type (default: lib)