move-a-file

Move or rename files with `git mv` and update all codebase references.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/ayazhankadessova/essential-skills --skill move-a-file-ayazhankadessova
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: move-a-file
Source: https://github.com/ayazhankadessova/essential-skills/tree/main/plugins/essential-skills/skills/move-a-file
Command: npx skills add https://github.com/ayazhankadessova/essential-skills --skill move-a-file-ayazhankadessova

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that when a file is moved or renamed, all references to it across the entire codebase are automatically updated, preventing broken links and build errors.

Core Features & Use Cases

  • Safe File Relocation: Moves or renames a file while preserving Git history.
  • Comprehensive Reference Updates: Scans and modifies references in source code, documentation, configuration files, and build scripts.
  • Use Case: You need to refactor your project by moving a utility function from src/utils/helpers.py to src/core/utils.py. This skill will move the file and update all import statements and any other references to it throughout the project.

Quick Start

Use the move-a-file skill to move the file 'old_path/to/file.txt' to 'new_path/destination/file.txt'.

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 in a git repository and update all references automatically?

To move a file and update references automatically, this skill uses git mv to relocate the file while scanning the codebase to update import statements, documentation, and configuration files for project integrity.

What happens to import statements when I move a file to a new directory?

When you move a file to a new directory, this skill scans the codebase and automatically updates all import statements and cross-references in source code, documentation, and build scripts to prevent broken links.

How do I refactor a project by renaming a file without breaking the build?

To refactor a project by renaming a file without breaking the build, this skill performs broad codebase scanning to identify all references before moving the file using git mv, ensuring all cross-references are safely updated.

Can I use this to move utility functions between source code directories?

Yes, you can use this skill to move utility functions between source code directories. It safely relocates the file and modifies all references across the project, preserving your git history throughout the refactoring process.

What's the best way to update documentation and configuration files when relocating code?

The best way to update documentation and configuration files when relocating code is using an automated approach that handles comprehensive reference updates across source code, documentation, configuration files, and build scripts simultaneously.

Does moving files with git mv preserve version history across the entire codebase?

Yes, moving files with git mv preserves version history. This skill requires precise path validation and uses git mv to ensure the relocation maintains project integrity while updating all cross-references.