uncle-bob

Apply Robert C. Martin's clean code, SOLID, and architecture principles to code reviews.

38|8|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/yun520-1/mark-heartflow-skill --skill uncle-bob
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uncle-bob
Source: https://github.com/yun520-1/mark-heartflow-skill/tree/main/skills/uncle-bob
Command: npx skills add https://github.com/yun520-1/mark-heartflow-skill --skill uncle-bob

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps developers apply Robert C. Martin's principles to clean code, SOLID design, and clean architecture, addressing issues like code quality, refactoring, and architectural boundaries.

Core Features & Use Cases

  • Clean Code Guidelines: Provides naming conventions, function size guidelines, and error handling practices.
  • SOLID Principles: Offers detailed guidance on the Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, and Dependency Inversion principles.
  • Clean Architecture: Explains the layered architecture and dependency rules for maintainable code.
  • Code Smells: Identifies common code issues and offers solutions.
  • Testing: Offers TDD guidelines and best practices for robust code.
  • Use Case: Use this Skill while reviewing or refactoring code to ensure adherence to best practices.

Quick Start

Apply the uncle-bob skill to your codebase to identify and resolve code smells and implement best practices.

Frequently Asked Questions about uncle-bob

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

FAQPage Schema
How do I apply SOLID principles and clean code guidelines during code refactoring?

To apply clean code guidelines during refactoring, analyze your codebase for function size violations and code smells, then implement proper naming conventions and error handling practices to improve code quality.

What is clean architecture and how does it improve software maintainability?

Clean architecture is a layered design approach that enforces dependency rules to separate business logic from external interfaces. It improves software maintainability by ensuring architectural boundaries are respected, making code easier to modify and test.

How do I identify and resolve code smells in my codebase?

Identify code smells by reviewing your code against common anti-patterns and structural violations. Resolve them by applying design patterns, refactoring large functions, and adhering to SOLID principles to achieve maintainable code.

Does this approach work for assessing architectural boundaries in existing projects?

Yes, this approach works for assessing architectural boundaries in existing projects. It evaluates your codebase against clean architecture dependency rules, identifying violations and offering solutions to realign layer interactions for better maintainability.

When should I not use clean architecture for my software design?

You should not use clean architecture when a project's scale does not justify strict layered boundaries and dependency rules, as the overhead of separating concerns may outweigh maintainability benefits for small or simple scripts.