Does it update paths in documentation like README files?

Yes, it scans Markdown, TXT, and RST files to ensure that documentation links reflect the new file location.

Does this skill preserve my Git history?

Yes, it specifically uses 'git mv' to ensure that all file history and metadata are preserved within your version control system.

What happens if a reference is ambiguous?

The skill flags any uncertain references in its final report, allowing you to manually verify or adjust changes that may require human context.

Can I move an entire folder at once?

Currently, this skill is optimized for moving one file at a time to ensure maximum accuracy when updating internal references and imports.

Safe File Refactor

Name: Safe File Refactor
Author: ayazhankadessova

byayazhankadessova

0•

開発者ツール

Relocates or renames files while automatically updating all imports, documentation, and configuration references across your codebase.

The Safe File Refactor skill automates the complex task of moving or renaming files within a project. Unlike standard move commands, it systematically scans your entire codebase to identify and update every reference—including source code imports, documentation links, configuration entries, and build scripts. By utilizing git-native operations, it preserves file history and intelligently calculates relative paths, preventing the broken dependencies and manual cleanup typically associated with structural project changes.

主な機能

01Preservation of version history using git mv operations

02Comprehensive reference scanning across source code, documentation, and config files

03Detailed reporting of all modified files and potential manual review flags

040 GitHub stars

05Intelligent path resolution for relative imports and project-root paths

06Automatic directory creation for new destination paths

ユースケース

01Moving utility files from a flat directory into a domain-specific folder hierarchy

02Renaming core modules to align with updated naming conventions without breaking imports

03Restructuring project folders while ensuring documentation and build scripts remain valid

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ayazhankadessova/essential-skills move-a-file

For use in Claude.ai and ChatGPT

Download Skill