What problem does it solve?
The .agents folder infrastructure is central to cross-system workflows, requiring consistent structure, automatic integration updates, and safe changes. This Skill eliminates manual coordination by orchestrating folder creation, renames, removals, and subfolder management across docs-manager, indexing, dev UI, and routing.
Core Features & Use Cases
- Structure Analysis & Validation: scans the current .agents layout, detects gaps, and verifies cross-system consistency.
- Automated Folder Operations: ADD, REMOVE, RENAME, SUBFOLDER changes with backup and migration support.
- Complete System Integration: updates templates, index generation, dev UI navigation, routing, and status detection in a coordinated manner.
- Safety & Interactive Workflow: pre-operation validation, backups, progress tracking, and rollback capabilities; asks clarifying questions and previews changes.
- Use Case: when onboarding a new project or adjusting workflows, run the skill to create or rename folders and automatically wire up associated systems.
Quick Start
Use this skill to add a new top-level folder under .agents, such as .agents/analyses with a .archive subfolder.