move-a-file

Move or rename a file and update all references using rg and git mv.

1|2|Updated Sep 17, 2025
One-click install
npx skills add https://github.com/MAdrid1011/Zircon-VLIW --skill move-a-file-madrid1011
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: move-a-file
Source: https://github.com/MAdrid1011/Zircon-VLIW/tree/main/.claude/skills/move-a-file
Command: npx skills add https://github.com/MAdrid1011/Zircon-VLIW --skill move-a-file-madrid1011

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Moving or renaming a file without breaking references across a project can be error-prone and time-consuming.

Core Features & Use Cases

  • Safe file relocation with automatic reference updates in code, docs, and configurations.
  • Validation steps to ensure old path exists, new path is available, and overwrites are avoided.
  • End-to-end workflow including reference search, path updates, and final git mv to preserve history.

Quick Start

Provide the old path and the new path to relocate a file and have all references updated automatically.

Frequently Asked Questions about move-a-file

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

FAQPage Schema
How do I move a file and update all references in my codebase?

To move a file and update references, the Skill validates paths, searches for references using rg, updates them across code and docs, and executes git mv to preserve history.

What is the best way to rename a file without breaking source code references?

Renaming a file without breaking references requires searching the codebase for the old path and updating all occurrences. This Skill automates that search and update process safely.

Does git mv automatically update references in configuration files and docs?

Git mv only relocates the file and preserves history; it does not update references. You need a dedicated tool to search and replace the old paths in code, docs, and configurations.

Can I safely relocate a file if the new path already exists?

Relocating a file to an existing path risks overwrites. This Skill includes validation steps to ensure the old path exists, the new path is available, and overwrites are avoided.

What happens to my Git history when I move or rename a file?

Moving or renaming a file uses git mv to preserve Git history. The Skill executes git mv at the end of the workflow after all references are successfully updated.