Does this skill work with languages other than Rust?

Yes. Although the repository examples often feature Rust, the principles of module organization and dependency management are applicable to TypeScript, Go, Python, and more.

What is included in a migration plan?

Plans typically include three phases: Preparation (backups/tests), Structural Changes (moving files/updating imports), and Verification (running builds/linters).

How does the skill identify architectural problems?

The skill uses patterns to analyze directory trees and file content, looking for indicators like excessive file length, deep nesting, and improper separation of concerns.

Can it help me resolve circular dependencies?

Yes, it specifically detects circular references and provides a structural plan to decouple the modules, often by introducing an interface or shared core module.

Package Structure Refactoring

Name: Package Structure Refactoring
Author: j5ik2o

byj5ik2o

•

Developer Tools

Analyzes and optimizes module structures to eliminate circular dependencies and improve software architecture.

The Refactoring Packages skill enables Claude to perform deep architectural audits of codebases to identify structural technical debt. It specializes in detecting circular dependencies that cause build issues, identifying 'God modules' that violate the Single Responsibility Principle, and proposing clean module boundaries. By providing automated directory analysis and structured multi-phase migration plans, this skill guides developers through complex refactoring tasks, ensuring that file placements and dependency graphs remain maintainable and scalable.

Key Features

013 GitHub stars

02Identification of 'God modules' based on file size and responsibility density

03Standardized patterns for separating core logic, middleware, and error handling

04Generation of step-by-step migration plans with preparation and verification phases

05Directory structure analysis including depth and file distribution metrics

06Automated detection of circular dependencies and complex module coupling

Use Cases

01Resolving build failures caused by circular import dependencies

02Breaking down oversized modules into smaller, logically separated files

03Standardizing directory structures and naming conventions in a growing project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add j5ik2o/fraktor-rs refactoring-packages

For use in Claude.ai and ChatGPT

Download Skill