skills.rest
vladm3105
vladm3105COMMUNITY
Explore all skills by this author →
GitHub

refactor-flow

Detect code smells and plan safe refactoring across multi-repository systems.

16|3|Updated Nov 10, 2025
Search Tags:#code quality#static analysis#refactoring#software development#code maintenance#technical debt#documentation sync
One-click install
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill refactor-flow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactor-flow
Source: https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/refactor-flow
Command: npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill refactor-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rope, autopep8, radon, pylint.

What problem does it solve?

This Skill systematically improves code quality, reduces technical debt, and ensures documentation remains synchronized with code changes, preventing code rot and increasing maintainability without manual oversight.

Core Features & Use Cases

  • Code Smell Detection: Automatically identify common code smells such as long methods, duplicate code, god classes, and complex conditionals.
  • Refactoring Recommendations: Get intelligent suggestions for safe code transformations like extracting methods, simplifying logic, and applying appropriate design patterns.
  • Documentation Synchronization: Ensure docstrings, specification documents, and traceability references are automatically updated after code changes.
  • Use Case: Analyze a complex legacy codebase to identify refactoring opportunities, generate a step-by-step plan to address high-priority issues, and automatically update related documentation, ensuring traceability and reducing future maintenance costs.

Quick Start

Use the refactor-flow skill to analyze 'src/auth/service.py' for code smells and refactoring opportunities.

Frequently Asked Questions about refactor-flow

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

FAQPage Schema
How do I detect code smells in my Python codebase?▼

Code smell detection identifies common issues like long methods, duplicate code, and god classes using static analysis. This skill automatically scans your codebase with tools like pylint and radon to flag maintainability problems and technical debt, helping you prioritize refactoring efforts.

Can I automate refactoring recommendations for legacy Python code?▼

Yes. This skill generates intelligent refactoring suggestions—extracting methods, simplifying logic, applying design patterns—and plans safe transformations step-by-step. It validates changes against your test suite to ensure modifications don't break functionality.

How do I keep documentation synchronized when refactoring code?▼

After code changes, this skill automatically updates docstrings, specification documents, and architecture decision records (ADRs), maintaining traceability. This prevents documentation drift and reduces future maintenance costs across multi-repository systems.

Does this work with microservices and monolithic architectures?▼

Yes. This skill applies to diverse architectures including monoliths, microservices, and libraries. It handles multi-repository software systems, requiring version control access and test suites to validate changes across your entire codebase.

What dependencies do I need to run code refactoring analysis?▼

This skill requires rope for refactoring, autopep8 for code formatting, radon for complexity metrics, and pylint for static analysis. You'll also need test suites and version control access to validate and track changes safely.

When should I use automated refactoring over manual code review?▼

Automated refactoring excels at systematic detection across large codebases, reducing time spent on routine improvements. Use it when addressing high-priority technical debt at scale; manual review complements it for architectural decisions and complex transformations requiring human judgment.

Related Skills

Explore More Software Engineering Skills→
cdman28cdman28

code-analyzer

Analyze Python and JavaScript/TypeScript code for smells, complexity, and refactoring opportunities.

Community
Advanced
joshbandjoshband
3

docs

Validate YAML frontmatter metadata and generate auditable change history for LocusQ documentation.

Community
Intermediate
LilwenzLilwenz

python-refactor

Refactor complex Python code into maintainable implementations with validation.

Community
Advanced
TakfesTakfes

python-simplifier

Analyze Python code for maintainability issues and refactoring opportunities.

Community
Advanced