reorganize-files

Reorganize loose project files and update all path-based references.

22|3|Updated Jul 28, 2024
One-click install
npx skills add https://github.com/webdevcody/go-mailing-list --skill reorganize-files-webdevcody
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reorganize-files
Source: https://github.com/webdevcody/go-mailing-list/tree/main/.claude/skills/reorganize-files
Command: npx skills add https://github.com/webdevcody/go-mailing-list --skill reorganize-files-webdevcody

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents broken builds and runtime failures caused by moving scattered files without updating every import, URL, CSS reference, and configuration pointer.

Core Features & Use Cases

  • Inventory-driven reorganization: Collects an exhaustive list of loose files at the specified root (with kinds, topics, and reference style).
  • Approval-gated layout proposal: Proposes a coherent target structure based on signals in filenames and file types, with an explicit user approve/revise step before any moves.
  • Reference sweep that catches silent path breakage: Updates all reference classes including static/bundler imports, string URL paths, CSS url() usage, metadata/OG/sitemap/JSON-LD, config-embedded paths, and test/fixture references.
  • Safe execution workflow: Uses an atomic edit pass and enforces verification via typecheck and stale-segment grep to ensure no old path segments remain.

Quick Start

Use the reorganize-files skill to reorganize the directory and update every reference after you confirm the proposed file layout.

Frequently Asked Questions about reorganize-files

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

FAQPage Schema
How do I reorganize project files without breaking imports and asset URLs?

Reorganizing files without breaking imports requires an exhaustive reference sweep that updates static imports, string URL paths, CSS url() usage, and metadata references after moving files. It enforces verification via typecheck and stale-segment grep to catch silent path breakage.

What is the safest way to refactor a messy public directory in TypeScript?

Refactoring a messy public directory safely requires an approval-gated workflow that proposes a coherent target structure based on filename signals before any moves occur. It then applies an atomic edit pass to update configuration path embeddings and verify correctness.

How do I update CSS url() references and JSON-LD metadata paths after moving assets?

Updating CSS url() references and JSON-LD metadata paths after moving assets requires a comprehensive reference sweep across all path-based pointers. This includes static bundler imports, sitemap entries, and OG tags to ensure no old path segments remain post-move.

Can I reorganize loose feature area files without manually updating every configuration pointer?

Yes, reorganizing loose feature area files without manual updates is possible using an inventory-driven approach that collects all files and applies an atomic edit pass. It automatically updates configuration-embedded paths and test fixtures, finishing with typecheck verification.

What are the limitations of automated file path updates when refactoring a project directory?

The main limitation of automated file path updates is the risk of missing silent breakage in complex metadata, OG tags, or sitemap entries if the reference sweep is not exhaustive. Stale-segment grep is required post-move to ensure no old path segments remain hidden in config embeddings.