project-claude-organizer

Reconcile a project's .claude/ folder with the canonical SDD structure.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/fearovex/agent-config --skill project-claude-organizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-claude-organizer
Source: https://github.com/fearovex/agent-config/tree/main/skills/project-claude-organizer
Command: npx skills add https://github.com/fearovex/agent-config --skill project-claude-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads the project .claude/ folder, compares observed contents against the canonical SDD structure, presents a dry-run reorganization plan, and applies it additively after user confirmation. After successful migration, offers to delete source files from .claude/<category>/ with explicit user confirmation. Produces claude-organizer-report.md. Trigger: /project-claude-organizer, organize .claude folder, fix project claude structure, align project .claude to canonical SDD layout.

Core Features & Use Cases

  • Provides a stable organizer kernel with detect/classify/propose/apply lifecycle.
  • Applies additive migrations only after explicit user confirmation and generates a report.
  • Handles migration safety and documentation via claude-organizer-report.md.
  • Cleans up by optionally deleting source files post-migration with user consent.

Quick Start

Run the organizer from the project root to align the .claude folder with the canonical SDD layout.

Frequently Asked Questions about project-claude-organizer

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

FAQPage Schema
How do I organize my .claude folder to match the canonical SDD structure?

To organize your .claude folder, this Skill reads its contents, compares them against the canonical SDD structure, and presents a dry-run reorganization plan before applying additive migrations after your explicit confirmation.

What is the safest way to migrate project claude files without losing data?

The safest way to migrate project claude files is through an additive migration that requires explicit user confirmation before applying changes, followed by an optional source file deletion step that also requires your consent.

How does the dry-run reorganization process work for a project claude setup?

The dry-run reorganization process works by detecting and classifying your current .claude folder contents, proposing a reorganization plan against the canonical SDD layout, and waiting for your confirmation before mutating any files.

Can I get a report of changes made during the .claude folder migration?

Yes, you can get a report of changes made during the .claude folder migration. The Skill ensures traceability by automatically producing a claude-organizer-report.md file after the reorganization is complete.

Does organizing the .claude folder require any external dependencies?

No, organizing the .claude folder does not require any external dependencies. The Skill operates independently to audit and reconcile your project setup against the canonical SDD structure.

Why should I align my project claude setup to the canonical SDD layout?

You should align your project claude setup to the canonical SDD layout to ensure structural consistency, prevent unintended mutations through guarded additive migrations, and maintain traceability via a generated audit report.