# Rust Code Quality

> Perform comprehensive Rust code quality reviews against best practices for async Rust, error handling, testing, and project structure Use when this capability is needed.

- Skill: `tomevault-io/rust-code-quality-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/rust-code-quality-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/rust-code-quality-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/rust-code-quality-2

---


# Rust Code Quality Review

Systematically review Rust code quality against best practices.

## Quality Dimensions

| Dimension | Focus | Tools |
|-----------|-------|-------|
| Structure | Files <500 LOC, module hierarchy | `find . -name "*.rs"` |
| Error Handling | Custom Error, Result<T>, no unwrap | `rg "unwrap\|Result<"` |
| Async Patterns | async fn, spawn_blocking, no blocking | `rg "async fn\|spawn_blocking"` |
| Testing | >90% coverage, integration tests | `cargo tarpaulin` |
| Documentation | Public APIs 100% documented | `cargo doc --no-deps` |

## Analysis Commands

```bash
# Project structure
find . -name "*.rs" -not -path "*/target/*" -exec wc -l {} + | sort -rn

# Error handling
rg "unwrap\(\)" --glob "!*/tests/*" --glob "*.rs"

# Async patterns
rg "async fn|spawn_blocking|tokio::" --glob "*.rs"

# Testing
cargo test --all
cargo tarpaulin --out Html

# Linting
./scripts/code-quality.sh fmt
./scripts/code-quality.sh clippy --workspace
cargo audit
```

## Output Format

```markdown
# Rust Code Quality Report

## Summary
- **Score**: X/100
- **Critical Issues**: N
- **Warnings**: M

## By Dimension
- Structure: X/10 - [Status]
- Error Handling: X/10 - [Status]
- Async Patterns: X/10 - [Status]
- Testing: X/10 - [Status]
- Documentation: X/10 - [Status]

## Critical Issues
1. [Issue] - File:line
   - Fix: [Recommendation]

## Action Items
### High Priority
- [ ] Fix critical issues

### Medium Priority
- [ ] Address warnings
```

## Best Practices Checklist

✓ Files <500 LOC
✓ Clear module hierarchy
✓ Custom Error enum
✓ Result<T> for fallible ops
✓ No unwrap() in production
✓ async fn for IO operations
✓ spawn_blocking for CPU work
✓ >90% test coverage
✓ Public APIs documented

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/d-o-hub) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->