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

•

Herramientas para Desarrolladores

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.

Características Principales

01Intelligent AST-based parsing of Python classes and functions

021 GitHub stars

03Backwards-compatible re-export stubs for existing imports

04Automated rollback mechanism to prevent broken builds

05Heuristic-driven grouping based on inheritance and naming patterns

06Customizable groupings.json for precise architectural control

Casos de Uso

01Improving code maintainability and readability by separating concerns in large projects

02Organizing utility functions and base classes into a structured package hierarchy

03Decomposing legacy 'God objects' and massive modules into clean sub-modules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ohadrubin/skills python-file-splitter

For use in Claude.ai and ChatGPT

Download Skill