repo-maintainer

Reorganize messy repositories into clean structures with migration manifests.

6|1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/auldsyababua/instructor-workflow --skill repo-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-maintainer
Source: https://github.com/auldsyababua/instructor-workflow/tree/main/skills/repo-maintainer
Command: npx skills add https://github.com/auldsyababua/instructor-workflow --skill repo-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, and includes scripts (resource) and assets (resource) components.

What problem does it solve?

Non-destructively reorganizes cluttered repositories using a Migration Manifest, preserving history and enabling LLM-friendly context zones.

Core Features & Use Cases

  • Non-destructive migration planning with manifests
  • Git-aware moves using git mv to preserve history
  • LLm-context zones (.ai/) for agent-ready knowledge
  • Quarantine for uncertain files and updated documentation hierarchy

Quick Start

Scaffold a migration manifest, review changes, then apply migration to reorganize the repo.

Frequently Asked Questions about repo-maintainer

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

FAQPage Schema
How do I reorganize a messy repository into a clean structure?

Reorganize repositories non-destructively by generating a migration manifest that plans file moves by extension and context, then apply it using git mv to preserve history. The Skill creates an .ai/CONTEXT.md zone for LLM agents and quarantines uncertain files for manual review.

Can I preserve git history when moving files to a new repository structure?

Yes, git mv preserves commit history for every moved file. The migration manifest workflow lets you review all planned moves before applying them, ensuring no history is lost during reorganization.

What happens to files the tool can't categorize during migration?

Uncertain files are quarantined separately so you can review and decide their placement manually. This prevents destructive decisions and keeps the migration process reviewable and safe.

How do I make my repository LLM-friendly?

Create an .ai/CONTEXT.md context zone that organizes knowledge for AI agents. The tool automatically generates this alongside repository restructuring, establishing a dedicated space for LLM-readable documentation and context.

Can I review changes before reorganizing my repository?

Yes, the migration manifest in YAML format shows all planned moves and categorizations before execution. Review and modify the manifest, then apply only the changes you approve.

What file types does the tool categorize automatically?

The Skill uses heuristic categorization by file extension to sort scripts, documentation, assets, and other file types. Files matching known patterns are grouped accordingly; ambiguous files go to quarantine for manual placement.