Pragmatic Clean Code Reviewer

A Claude Code skill for conducting rigorous code reviews based on software engineering classics

Installation • Usage • Features • Project Positioning • Rule Sources

Overview

This skill transforms Claude Code into a strict code review expert that evaluates your code against 350+ rules from three foundational software engineering books:

Philosophy: Let machines handle formatting; humans focus on logic and design.

Installation

Quick Install

From GitHub Release

1. Go to Releases
2. Download the latest .skill or .zip file
3. Extract to your skills directory (see table above)

Usage

Invoke the Skill

/pragmatic-clean-code-reviewer

Or Use Natural Language

• "Review my code for code smells"
• "Check if this PR is ready to merge"
• "Audit the architecture of this module"

Features

👉 See detailed features →

Quick Reference

Strictness Levels

👉 Full positioning guide →

Rule Prefixes

👉 Full rule sources →

Documentation

File Structure

pragmatic-clean-code-reviewer/
├── SKILL.md                # Main skill (for AI)
├── README.md               # This file
├── CHANGELOG.md            # Release history
├── docs/                   # Detailed documentation (for humans)
│   ├── features.md
│   ├── project-positioning.md
│   ├── metrics.md
│   └── rule-sources.md
└── references/             # Rule references (for AI)
    ├── clean-code.md
    ├── clean-architecture.md
    ├── pragmatic-programmer.md
    └── ...

Contributing

Contributions are welcome! Please feel free to:

• 🐛 Report issues
• 💡 Suggest improvements
• 🔧 Submit pull requests

License

MIT License - See LICENSE for details.

Credits

Based on principles from:

• 📗 "The Pragmatic Programmer" by David Thomas and Andrew Hunt
• 📘 "Clean Code" by Robert C. Martin
• 📙 "Clean Architecture" by Robert C. Martin

_{Built with principles from software engineering classics}