How does this skill help with AI-generated code?

It specifically targets common AI tendencies, such as adding new code instead of modifying existing logic, to prevent 'wrapper inflation' and 'additive-only' technical debt.

Can this skill be used with any programming language?

Yes, the patterns and heuristics provided are language-agnostic and focus on structural logic and code health signals common to all modern programming environments.

How does it distinguish between refactoring and new features?

It uses a specific set of criteria—checking for behavior changes, test modifications, and API shifts—to ensure structural clean-up is separated from functional additions.

Does it automate the refactoring process?

It provides the decision criteria and verification steps that Claude uses to ensure refactoring is safe, necessary, and logically sound before any changes are applied.

What are the size-check heuristics used for?

These are investigation triggers (such as function length or nesting depth) that signal when a piece of code might need a closer look for potential refactoring, rather than being hard mandates.

AI-Optimized Refactoring Patterns

Name: AI-Optimized Refactoring Patterns
Author: Kiwi-Home

byKiwi-Home

0•

생산성 및 워크플로

Implements safe code restructuring patterns and eliminates AI-specific technical debt like additive-only changes and wrapper inflation.

This skill provides a comprehensive framework for safe refactoring during AI-assisted development, specifically addressing common AI behaviors like code duplication and 'thin wrapper' inflation. It equips Claude with language-agnostic decision criteria, size-check heuristics, and verification checklists to ensure structural improvements never compromise functional integrity. By identifying and correcting patterns such as 'rename-without-delete' and 'compatibility shim hoarding,' it helps maintain clean, maintainable codebases while managing technical debt throughout the development lifecycle.

주요 기능

01Identification of AI-specific anti-patterns like additive-only changes and wrapper inflation

020 GitHub stars

03Safe refactoring patterns including extraction, consolidation, and dead code removal

04Strict verification checklists to ensure behavior-preserving changes and zero regressions

05TDD-integrated decision criteria to distinguish refactoring from new feature work

06Standardized size-check heuristics for functions, files, and parameter counts

사용 사례

01Conducting structural code reviews to identify and remove unnecessary abstraction layers

02Planning large-scale code health improvements and module decomposition sessions

03Addressing technical debt during automated issue execution and TDD loops

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kiwi-home/ai-coding-resources refactoring-patterns

For use in Claude.ai and ChatGPT

Download Skill