reorganize-files

Reorganize ungrouped files into grouped layouts while updating references.

121|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/AgentSystemLabs/core --skill reorganize-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reorganize-files
Source: https://github.com/AgentSystemLabs/core/tree/main/plugins/agentsystem-core/skills/reorganize-files
Command: npx skills add https://github.com/AgentSystemLabs/core --skill reorganize-files

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill fixes production-breaking chaos caused by moving ungrouped files without updating every import, URL, CSS reference, and configuration path.

Core Features & Use Cases

  • Inventory-driven restructuring: Gathers a complete picture of every loose file and how each one is referenced, so nothing important is missed.
  • Approval-gated layout proposal: Proposes a single coherent grouping scheme (by type, feature, or topic signal) and stops for user approval before any changes.
  • Reference sweep that prevents silent runtime failures: Updates static imports, string-based paths, CSS url() usage, metadata/OG/sitemap references, and config-embedded path settings.
  • Verification that catches stale paths early: Enforces typechecking and a stale-segment grep so moved assets and references are actually correct before completion.

Example use: Reorganize a feature folder where images are scattered in public/ and scripts are piled in src/, then ensure every import and <img src>, url(), OG tag image, and tsconfig alias still works after the move.

Quick Start

Ask the agent to reorganize the folder “<your-target-directory>” and only use exclusions for build outputs (like dist/) while preserving any public URLs unless you explicitly approve changes.

Frequently Asked Questions about reorganize-files

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

FAQPage Schema
How do I reorganize a messy folder and fix broken file paths?

To reorganize a messy folder and fix broken paths, the Skill inventories scattered files, proposes a grouped layout, sweeps all imports and URL references, and verifies builds with typechecking. This ensures moved assets continue working at runtime.

What is the safest way to move web assets without breaking CSS url() references?

The safest way to move web assets without breaking CSS url() references is to use an inventory-driven sweep that updates string-based paths, static imports, and metadata references atomically. Post-change verification catches any stale paths early.

How does file restructuring handle static imports and metadata path updates?

File restructuring handles static imports and metadata path updates by performing a class-based reference sweep across configs, CSS, and OG tags. It updates every pointer atomically during the move to prevent silent runtime failures.

Can I reorganize feature folders and preserve public URLs without breaking builds?

Yes, you can reorganize feature folders and preserve public URLs without breaking builds. The Skill proposes an approval-gated layout, updates embedded config paths, and enforces stale-segment grep checks to guarantee build safety.

What are the limitations of automated dependency scanning during directory restructuring?

A limitation of automated dependency scanning during directory restructuring is that it requires an approval gate before execution and needs build outputs like dist/ excluded. Users must explicitly approve any changes to public URLs to maintain reference integrity.

Why do I need typecheck and stale-path grep after updating file references?

You need typecheck and stale-path grep after updating file references to verify that moved assets and configurations are actually correct. This post-change verification catches lingering broken paths and ensures build safety before the task completes.