craftsmanship-skills

Use when deciding whether, how, or where to write code comments — applies Clean Code comment principles

Use when designing or reviewing exception handling, error boundaries, or error propagation patterns — applies Clean Code error handling principles

Use when designing, reviewing, or refactoring functions — applies Clean Code function principles for small, focused, well-argumented functions

Use when choosing names for variables, functions, classes, or modules — applies Clean Code naming principles for clear, intention-revealing identifiers

Routes to Clean Code sub-skills for naming, functions, comments, and error handling based on Robert C. Martin's Clean Code

Detects code smells and recommends specific refactorings. Covers the 22 canonical code smells from Fowler's Refactoring with Python examples.

Techniques for breaking down and reorganizing methods: Extract Method, Inline Method, Replace Temp with Query, Introduce Explaining Variable, Split Temporary Variable, Replace Method with Method Object, Substitute Algorithm. All with Python before/after examples.

Techniques for moving behavior and data between classes: Move Method, Move Field, Extract Class, Inline Class, Hide Delegate, Remove Middle Man. All with Python before/after examples.

Techniques for simplifying conditional logic: Decompose Conditional, Consolidate Conditional Expression, Consolidate Duplicate Conditional Fragments, Remove Control Flag, Replace Nested Conditions with Guard Clauses, Replace Conditional with Polymorphism. All with Python before/after examples.

Router skill for refactoring code. Analyzes the situation and delegates to the appropriate sub-skill: code-smells, composing-methods, moving-features, or simplifying-conditionals.