uncle-bob-craft

Review and refactor code using Clean Code, Clean Architecture, and SOLID principles.

1|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/Hamzaoui-Louai/LEAN-gym-dashboard-frontend --skill uncle-bob-craft-hamzaoui-louai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uncle-bob-craft
Source: https://github.com/Hamzaoui-Louai/LEAN-gym-dashboard-frontend/tree/main/.opencode/skills/clean%20code%20skills/uncle-bob-craft
Command: npx skills add https://github.com/Hamzaoui-Louai/LEAN-gym-dashboard-frontend --skill uncle-bob-craft-hamzaoui-louai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Code reviews and refactoring decisions often lack consistent design criteria, leading to subjective feedback, architecture drift, and unjustified design patterns. This Skill applies Robert C. Martin's principles (Clean Code, Clean Architecture, The Clean Coder, Clean Agile) as concrete review and production criteria. ## Core Features & Use Cases - Principle-Based Code Review: Check Dependency Rule, layer boundaries, SOLID violations, and design smells (rigidity, fragility, opacity) with a copy-paste checklist. - Refactoring Guidance: Identify one smell at a time and suggest concrete refactors such as extracting functions or inverting dependencies. - Design Pattern Discipline: Evaluate whether a Factory, Strategy, or Repository solves real duplication or variation versus cargo-cult overuse. - Use Case: When reviewing a pull request, ask for an Uncle Bob-oriented review to get boundary violations, SOLID issues, named smells, and one or two concrete refactor suggestions. ## Quick Start Ask the AI to review the current code changes using uncle-bob-craft criteria covering dependency direction, SOLID, smells, and concrete refactor suggestions.

Frequently Asked Questions about uncle-bob-craft

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I do a code review using Clean Architecture principles?

Check that dependencies point inward so use cases never import UI or database details, verify SOLID principles in the changed code, and list smells like rigidity or opacity. The skill provides a copy-paste checklist and suggests concrete refactors such as extracting functions or inverting dependencies.

When should I introduce a design pattern like Factory or Strategy?

Introduce a pattern when you hit the third duplication or a second reason to change the same module. Avoid adding Factory or Strategy to simple linear code, since that adds indirection without reducing duplication or clarifying intent.

Does this skill replace my linter or formatter?

No. It provides design and craft criteria only, covering structure, dependencies, smells, and professional practice. Syntax and style enforcement remain the responsibility of your project linter and formatter, which you should always run separately.

What is the difference between uncle-bob-craft and the clean-code skill?

The clean-code skill covers the Clean Code book in detail: naming, functions, comments, and formatting. Uncle-bob-craft aggregates cross-book criteria including Clean Architecture boundaries, Clean Coder professionalism, Clean Agile practices, and design pattern discipline.

What are the most common code smells to check in review?

The seven core smells are rigidity, fragility, immobility, viscosity, needless complexity, needless repetition, and opacity. Each maps to a concrete fix such as reducing coupling, extracting shared logic, or renaming for clarity.