Guide safe codebase refactoring with characterization tests and stepwise commits.
npx skills add https://github.com/jscott3201/ai-agent-skills --skill refactor-jscott3201
Please help me install this Agent Skill. Skill: refactor Source: https://github.com/jscott3201/ai-agent-skills/tree/main/skills/refactor Command: npx skills add https://github.com/jscott3201/ai-agent-skills --skill refactor-jscott3201
Reduce the risk of regressions and large, unsafe changes by guiding developers through a structured refactoring workflow that identifies code smells, locks current behavior with characterization tests, and enforces small, verifiable steps.
Run the refactor skill on the target module with a brief description of the smell to produce a stepwise plan, write characterization tests, and execute each step with tests and compilation checks.
High-intent search queries and answers about installing and using this skill.
To safely refactor long functions and god modules, identify code smells, lock current behavior with characterization tests, and execute incremental changes with compilation checks and per-step commits. This structured workflow prevents behavioral regressions in Rust, Python, and JavaScript codebases.
Characterization testing is a technique to lock in the current behavior of existing code before making changes. You need it during code refactoring to verify that incremental transformations preserve the original logic and prevent regressions across Rust, Python, and JavaScript projects.
Plan incremental refactoring by detecting specific code smells like duplicate logic, then producing a stepwise transformation plan. Execute each step independently with characterization tests, compilation checks, and per-step commits to ensure no behavioral regressions occur during the reorganization.
Yes, this refactoring workflow supports Rust, Python, and JavaScript or TypeScript projects. It provides cross-language refactoring patterns to handle long functions, god modules, duplicate logic, and API-preserving reorganizations safely.
Track refactoring decisions and outcomes by optionally recording them to SeleneDB for future recall. This persistence layer captures the stepwise transformations and characterization test results, enabling better decision tracking across incremental codebase changes.
Incremental refactoring focuses on file- and module-level transformations, requiring compilation checks and tests at each step. It may not scale efficiently for massive architectural changes without first breaking them down into smaller, independently verifiable API-preserving reorganizations.
cwinvestmentsPlan incremental code refactoring with risk assessment and regression coverage.
jscott3201Detect languages, build systems, CI, tests, and conventions in code repositories.
arbazkhan971Configure linters, formatters, pre-commit hooks, and CI enforcement across repositories.
OpenWaggleDetect dead code, duplicates, and structural weaknesses in JavaScript and TypeScript codebases.
