safe-file-ops

Move, rename, or delete tracked files while updating references and validating with dry-run.

5|1|Updated Dec 10, 2025
One-click install
npx skills add https://github.com/Pravin-surawase/structural_engineering_lib --skill safe-file-ops-pravin-surawase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: safe-file-ops
Source: https://github.com/Pravin-surawase/structural_engineering_lib/tree/main/.github/skills/safe-file-ops
Command: npx skills add https://github.com/Pravin-surawase/structural_engineering_lib --skill safe-file-ops-pravin-surawase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents repository damage when files are moved, renamed, or deleted by keeping internal documentation links and related references in sync.

Core Features & Use Cases

  • Safe moves and renames: Reorganize tracked files without leaving broken links behind.
  • Safe deletions: Check whether a file can be removed without creating dangling references.
  • Migration support: Update Python imports, React component references, and folder indexes after path changes.
  • Use Case: When restructuring a large codebase or documentation set, use this Skill to avoid manual link repair and reduce the risk of regressions.

Quick Start

Ask the assistant to safely move or delete the specified file and update every affected reference.

Frequently Asked Questions about safe-file-ops

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

FAQPage Schema
How do I move files in a large repository without breaking internal documentation links?

To move files without breaking internal documentation links, you need a safe migration workflow that automatically updates tracked references during path changes. This prevents broken links by validating operations and updating paths in sync.

What is the best way to rename Python modules and React components while preserving imports?

The best way to rename Python modules and React components while preserving imports is using a migration tool that applies reference updates. This ensures internal links, component references, and Python imports are automatically repaired after path changes.

Can I check if a file can be deleted without creating dangling references in my codebase?

Yes, you can check for dangling references before deletion by using dry-run validation. This safe deletion process scans the repository to verify whether a file is referenced elsewhere, ensuring it can be removed without creating broken links.

Does safe file refactoring support dry-run validation for documentation and code?

Yes, safe file refactoring supports dry-run validation for both documentation and code. This allows you to preview reference updates and verify that internal links, Python imports, and React component paths remain intact before applying actual file moves.

Why do my documentation links break when I reorganize tracked files and how do I fix it?

Documentation links break during reorganization because internal references point to old paths. You fix this by using a safe move workflow that automatically updates folder indexes and internal links, ensuring tracked references synchronize with new file locations.