How do I install the Solid Rust skill?

Run npx skillmds@latest add fusengine/solid-rust in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Solid Rust safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Solid Rust?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Solid Rust free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Solid Rust?

fusengine (@fusengine) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Solid Rust by fusengine — Agent Skill

Name: Solid Rust
Rating: 4.2 (5 reviews)
Author: fusengine

File contents

Before writing any new code it requires a DRY check against src/core/services and src/core/traits. See solid-principles.md for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/trait/handler/error/test scaffolding.

SOLID Rust - Modular Architecture

Agent Workflow (MANDATORY)

Before ANY implementation, spawn 3 agents in parallel, one Agent call each with a name:

fuse-ai-pilot:explore-codebase - Analyze existing architecture
fuse-ai-pilot:research-expert - Verify Rust docs via Context7
fuse-ai-pilot:sniper - Post-implementation validation

DRY - Reuse Before Creating (MANDATORY)

Before writing ANY new code:

Grep the codebase for similar traits, services, or logic
Check shared locations: src/core/services/, src/core/traits/
If similar code exists -> extend/reuse instead of duplicate
If code will be used by 2+ features -> create it in src/core/

Architecture (Modules MANDATORY)

Layer	Location	Max Lines
Handlers	`src/modules/[feature]/handlers.rs`	50
Services	`src/modules/[feature]/services.rs`	100
Repositories	`src/modules/[feature]/repository.rs`	100
Traits	`src/modules/[feature]/traits.rs`	30
Models	`src/modules/[feature]/models.rs`	50
Shared	`src/core/{services,traits,models}/`	-

NEVER use flat src/ structure - always src/modules/[feature]/

Critical Rules (MANDATORY)

Rule	Value
File limit	100 lines (split at 90)
Handlers	< 50 lines, delegate to services
Traits	`traits.rs` or `src/core/traits/` ONLY
Rustdoc	`///` on every public item
Error handling	Use `thiserror` for custom errors
Generics	Use trait bounds, not concrete types

Reference Guide

Concepts

Topic	Reference	When to consult
SOLID Overview	solid-principles.md	Quick reference
SRP	single-responsibility.md	Fat structs
OCP	open-closed.md	Adding impls
LSP	liskov-substitution.md	Trait contracts
ISP	interface-segregation.md	Fat traits
DIP	dependency-inversion.md	Generics/DI
Architecture	architecture-patterns.md	Modular crate

Templates

Template	When to use
module.md	Feature module structure
service.md	Business logic service
trait-def.md	Trait definition
handler.md	HTTP handler (Axum)
error.md	Custom errors (thiserror)
test.md	Unit + integration tests

Forbidden

Anti-Pattern	Fix
Files > 100 lines	Split at 90
Traits in impl files	Move to `traits.rs`
`Box<dyn Any>`	Use proper trait bounds
Flat `src/` structure	Use `src/modules/[feature]/`
Unwrap in library code	Use `Result<T, E>`

---name: solid-rustdescription: Use when writing or refactoring Rust code, structuring src/modules/[feature]/ layers, or defining traits.rs interfaces (SOLID, files < 100 lines).---<objective>SOLID Rust enforces a modular architecture for Rust 2024 edition: every feature lives under `src/modules/[feature]/` (handlers.rs, services.rs, repository.rs, traits.rs, models.rs) with shared code in `src/core/`, traits live only in `traits.rs` or `src/core/traits/`, generics use trait bounds instead of concrete types, `thiserror` handles custom errors, and every public item carries a rustdoc `///` comment.Before writing any new code it requires a DRY check against `src/core/services` and `src/core/traits`. See `solid-principles.md` for the overview, the per-principle references for SRP/OCP/LSP/ISP/DIP detail, and the templates for module/service/trait/handler/error/test scaffolding.</objective># SOLID Rust - Modular Architecture## Agent Workflow (MANDATORY)Before ANY implementation, spawn 3 agents in parallel, one `Agent` call each with a `name`:1. **fuse-ai-pilot:explore-codebase** - Analyze existing architecture2. **fuse-ai-pilot:research-expert** - Verify Rust docs via Context73. **fuse-ai-pilot:sniper** - Post-implementation validation---## DRY - Reuse Before Creating (MANDATORY)**Before writing ANY new code:**1. **Grep the codebase** for similar traits, services, or logic2. Check shared locations: `src/core/services/`, `src/core/traits/`3. If similar code exists -> extend/reuse instead of duplicate4. If code will be used by 2+ features -> create it in `src/core/`---## Architecture (Modules MANDATORY)| Layer | Location | Max Lines ||-------|----------|-----------|| Handlers | `src/modules/[feature]/handlers.rs` | 50 || Services | `src/modules/[feature]/services.rs` | 100 || Repositories | `src/modules/[feature]/repository.rs` | 100 || Traits | `src/modules/[feature]/traits.rs` | 30 || Models | `src/modules/[feature]/models.rs` | 50 || Shared | `src/core/{services,traits,models}/` | - |**NEVER use flat `src/` structure - always `src/modules/[feature]/`**---## Critical Rules (MANDATORY)| Rule | Value ||------|-------|| File limit | 100 lines (split at 90) || Handlers | < 50 lines, delegate to services || Traits | `traits.rs` or `src/core/traits/` ONLY || Rustdoc | `///` on every public item || Error handling | Use `thiserror` for custom errors || Generics | Use trait bounds, not concrete types |---## Reference Guide### Concepts| Topic | Reference | When to consult ||-------|-----------|-----------------|| **SOLID Overview** | [solid-principles.md](references/solid-principles.md) | Quick reference || **SRP** | [single-responsibility.md](references/single-responsibility.md) | Fat structs || **OCP** | [open-closed.md](references/open-closed.md) | Adding impls || **LSP** | [liskov-substitution.md](references/liskov-substitution.md) | Trait contracts || **ISP** | [interface-segregation.md](references/interface-segregation.md) | Fat traits || **DIP** | [dependency-inversion.md](references/dependency-inversion.md) | Generics/DI || **Architecture** | [architecture-patterns.md](references/architecture-patterns.md) | Modular crate |### Templates| Template | When to use ||----------|-------------|| [module.md](references/templates/module.md) | Feature module structure || [service.md](references/templates/service.md) | Business logic service || [trait-def.md](references/templates/trait-def.md) | Trait definition || [handler.md](references/templates/handler.md) | HTTP handler (Axum) || [error.md](references/templates/error.md) | Custom errors (thiserror) || [test.md](references/templates/test.md) | Unit + integration tests |---## Forbidden| Anti-Pattern | Fix ||--------------|-----|| Files > 100 lines | Split at 90 || Traits in impl files | Move to `traits.rs` || `Box<dyn Any>` | Use proper trait bounds || Flat `src/` structure | Use `src/modules/[feature]/` || Unwrap in library code | Use `Result<T, E>` |

Frequently asked questions

Solid Rust