file-deleter

Safe deletion moves files to a recoverable .deleted/ trash instead of permanently removing them. This Skill implements a Node.js script that routes deletions through a hidden trash directory while preserving the original directory structure, allowing you to restore files if needed.

Yes. Deleted files and directories are moved to .deleted/ with their original path structure intact, making restoration straightforward. Check the .deleted/ directory to locate and restore any item you removed.

Run the provided Node.js script with the file or directory path as an argument. The script detects your project root via .git and .claude directories, moves the target to .deleted/ preserving its hierarchy, and handles both absolute and relative paths automatically.

The script skips non-existent targets gracefully without error, so you can safely run deletion commands on paths that may or may not exist. Existing entries in .deleted/ are overwritten when needed.

Unlike rm/rmdir which permanently erase data, this approach routes deletions through a recoverable trash. Files remain accessible in .deleted/ until explicitly purged, eliminating irreversible loss during cleanup tasks.

The script requires a .git or .claude directory to locate your project root but has no external npm dependencies. It's a standalone Node.js script that works across codebases, configs, docs, and build artifacts.