How does it decide which classes go into which files?

It uses grouping heuristics such as inheritance chains, shared naming patterns (e.g., Mixins/Renderers), and base class identification to suggest a logical organization.

Do I need any external tools to use this skill?

Yes, this skill requires ast-grep to be installed globally on your system (npm install -g @ast-grep/cli) to accurately parse Python structures.

What happens if the split breaks my imports?

The skill includes an automatic rollback mechanism. If the generated files fail to import correctly, it reverts to the original state so you can adjust the groupings.json configuration and try again.

Does this break existing imports in my project?

No. The skill replaces the original file with a re-export stub that points to the new package, maintaining backwards compatibility while the implementation is modularized.

Can I customize the final package structure?

Yes. After the initial parse phase, you can edit the generated groupings.json file to manually assign items to specific groups or the base module before the split is executed.

Python File Splitter

Name: Python File Splitter
Author: OhadRubin

byOhadRubin

•

개발자 도구

Refactors large, monolithic Python files into organized, maintainable packages with automated dependency validation.

소개

The Python File Splitter skill automates the complex task of breaking down oversized Python modules into clean, modular package structures. Using ast-grep for precise code analysis, it identifies classes, functions, and inheritance chains to suggest logical groupings. The skill follows a safe, two-phase workflow: first, it generates a plan for user approval; second, it executes the split with an integrated retry loop that automatically rolls back changes if the new imports fail. This ensures your codebase remains functional while evolving from a single file into a professional package layout with backwards-compatible re-export stubs.

주요 기능

Intelligent AST-based parsing of Python classes and functions
1 GitHub stars
Backwards-compatible re-export stubs for existing imports
Automated rollback mechanism to prevent broken builds
Heuristic-driven grouping based on inheritance and naming patterns
Customizable groupings.json for precise architectural control

사용 사례

Improving code maintainability and readability by separating concerns in large projects
Organizing utility functions and base classes into a structured package hierarchy
Decomposing legacy 'God objects' and massive modules into clean sub-modules

소개

주요 기능

Intelligent AST-based parsing of Python classes and functions
1 GitHub stars
Backwards-compatible re-export stubs for existing imports
Automated rollback mechanism to prevent broken builds
Heuristic-driven grouping based on inheritance and naming patterns
Customizable groupings.json for precise architectural control

사용 사례

Improving code maintainability and readability by separating concerns in large projects
Organizing utility functions and base classes into a structured package hierarchy
Decomposing legacy 'God objects' and massive modules into clean sub-modules