structural-refactor-creator

Analyze repository structure and generate custom organizational rules.

7|4|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/nklisch/skills --skill structural-refactor-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: structural-refactor-creator
Source: https://github.com/nklisch/skills/tree/main/plugins/workflow/skills/structural-refactor-creator
Command: npx skills add https://github.com/nklisch/skills --skill structural-refactor-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Many codebases suffer from inconsistent folder structures, oversized files, and unclear module boundaries, making navigation and maintenance difficult. This skill creates a tailored structural refactor guide to organize projects consistently.

Core Features & Use Cases

  • Repository analysis: Scans file sizes, folder layouts, module boundaries, and documentation.
  • Stack research: Retrieves best‑practice organization guidelines for the project's language and framework.
  • User interview: Asks the developer about preferred conventions and constraints.
  • Rule generation: Produces concrete structural rules with reference documents and a prioritized refactoring plan.
  • Skill creation: Builds or updates a reusable structural‑refactor skill for future projects.

Quick Start

Ask the structural‑refactor‑creator skill to generate a new structural refactor plan for the current repository.

Frequently Asked Questions about structural-refactor-creator

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

FAQPage Schema
How do I create structural refactor rules for my codebase?

Structural refactoring reorganizes folder layouts and module boundaries to fix codebase inconsistencies. This skill automates that process by analyzing repository files and generating concrete rules to enforce consistent project organization.

When do I need to refactor a codebase's folder structure?

You need a structural refactor when your project suffers from inconsistent folder structures, oversized files, and unclear module boundaries that make codebase navigation and ongoing maintenance difficult for your team.

How do I analyze a repository to fix inconsistent file layouts?

You can analyze a repository by scanning file sizes, folder layouts, module boundaries, and documentation. This skill performs that repository analysis automatically and uses the results to produce a prioritized refactoring plan.

Can I generate a reusable refactoring plan for multiple projects?

Yes, you can generate a reusable structural-refactor skill. After analyzing your current repository and defining conventions, it builds or updates a custom skill you can apply to future projects.

What do I need to generate structural guidelines for a specific framework?

To generate structural guidelines, you need read and write repository access, shell execution, web search capability, and interactive user questioning to define preferred conventions and constraints for your specific stack.