github-repo-restructure

Move repository folders with git mv and update README references.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/shiftrepo/aws --skill github-repo-restructure
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-repo-restructure
Source: https://github.com/shiftrepo/aws/tree/main/HermesAgent/skills/skills/github/github-repo-restructure
Command: npx skills add https://github.com/shiftrepo/aws --skill github-repo-restructure

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organizes scattered GitHub repository folders into a clean, navigable structure by relocating directories under a new parent (for example projects/) and refreshing README references.

Core Features & Use Cases

  • Atomic folder moves with git mv to preserve history, avoiding brittle API-based moves.
  • Bulk restructuring patterns that group related modules under a common parent and update internal links.
  • README refresh strategies to maintain navigability and context post-reshape.

Quick Start

Clone the repository, create a new parent directory, move folders with git mv, refresh READMEs and links, and push the changes.

Frequently Asked Questions about github-repo-restructure

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

FAQPage Schema
How do I restructure a GitHub repository without losing git history?▼

To restructure a GitHub repository without losing history, use git mv to relocate directories under a new parent like projects/. This preserves version history and allows you to commit the changes atomically.

What's the best way to reorganize folders in a monorepo?▼

The best way to reorganize monorepo folders is using git mv for atomic directory moves. This groups related modules under a common parent while maintaining navigability and preserving the commit history.

How do I update README links after moving folders in a git repository?▼

To update README links after moving folders in a git repository, apply README refresh strategies post-reshape. This maintains navigability and context by updating internal links to reflect the new directory structure.

Do I need special permissions to restructure a GitHub repository with git mv?▼

Yes, restructuring a GitHub repository requires proper git access permissions. You need to clone the repository, create a new parent directory, move folders with git mv, and push the changes to apply the restructuring safely.

Why should I use git mv instead of the GitHub API to move repository folders?▼

You should use git mv instead of the GitHub API to move repository folders because API-based moves can be brittle. Using git mv ensures atomic commits and preserves version history during repository restructuring.

Can I bulk restructure multiple projects under a new parent directory in git?▼

Yes, you can bulk restructure multiple projects under a new parent directory in git. This involves creating a new parent folder, using git mv to relocate related modules, and refreshing READMEs to maintain documentation consistency.