SkillsAdd

smithery/phamhung075

safe-file-removal

Use safe-rm command to safely 'remove' files by renaming them to .obsolete instead of permanent deletion. Reversible, collision-safe, hook-compliant.

Installation

$ npx skills add smithery/phamhung075 --skill safe-file-removal
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

background-removal Similar name
eachlabs/skills

Remove backgrounds from images using each::sense AI. Create transparent PNGs, replace backgroun…

423 installs
object-removal Similar name
eachlabs/skills

Remove unwanted objects, people, text, and imperfections from photos using each::sense AI. Clea…

384 installs
Account Access Removal Similar name
mukul975/anthropic-cybersecurity-skills

Auditing Kubernetes cluster RBAC configurations to identify overly permissive roles, wildcard p…

269 installs
video-background-removal Similar name
eachlabs/skills

Remove, replace, or modify video backgrounds using each::sense AI. Create transparent backgroun…

193 installs
dead-code-removal Similar name
89jobrien/steve

Detects and safely removes unused code (imports, functions, classes) across multiple languages.…

193 installs
watermark-removal Similar name
faas-tech/extend-my-claude-code

Universal watermark removal with ML-based inpainting and automatic detection. Works on ANY wate…

174 installs

Also in this package

Other skills from smithery/phamhung075.

npx skills add smithery/phamhung075
token-economy 0 spawn-team 0

Browse all from smithery/phamhung075

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,786 B
  • docs SUMMARY.md 174 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Safe File Removal

Rename files to .obsolete instead of permanent deletion via safe-rm command.

When to Use

  • Removing temp files, build artifacts, old code, deprecated tests
  • After refactoring (keep backup during testing)
  • Any situation where rm is blocked by pre-tool hooks
  • Need reversible "deletion"

Why Not rm

Project setting: .claude/settings.json:132 → "RMBASHBLOCK": "true"

Issue Solution
rm permanently deletes safe-rm renames (reversible)
Blocked by pre-tool hooks Works within safety constraints
No recovery mv file.obsolete file restores

Command

./.claude/bin/safe-rm [file1] [file2] [dir/]

Path: .claude/bin/safe-rm:1-72

Features

Feature Benefit
Reversible mv file.obsolete file recovers
Multi-file Handle multiple args in one command
Collision safe Adds timestamp if .obsolete exists
Color output Green ✓ / Yellow ⚠ / Red ✗
Statistics Reports renamed/failed count

Basic Usage

Operation Command Result
Single file ./.claude/bin/safe-rm file.txt file.txt.obsolete
Multiple ./.claude/bin/safe-rm f1 f2 dir/ All get .obsolete suffix
Restore mv file.obsolete file Original restored

Recovery

Scenario Command
Single mv file.obsolete file
With timestamp mv file.obsolete.20251109_110500 file
Find all find . -name "*.obsolete"
Restore all `find . -name "*.obsolete" \ while read f; do mv "$f" "${f%.obsolete}"; done`

Workflow

  1. Mark obsolete → safe-rm [files]
  2. Verify works → npm test && npm run build
  3. Review periodic → find . -name "*.obsolete"
  4. Permanent delete (when confident) → /bin/rm [file].obsolete

When NOT to Use

Scenario Use safe-rm? Why
Secrets (.env, keys) ❌ Needs secure deletion + git history rewrite
.git folder ❌ Too risky
node_modules ⚠️ rm -rf safe, but safe-rm works
Temp/build ✅ Reversible, safe

Output Examples

Success:

✓ Renamed: file.txt → file.txt.obsolete
─────────────────────────────────────
Renamed: 1

Collision (timestamp fallback):

⚠ Already exists: file.obsolete
  Using: file.obsolete.20251109_110500
✓ Renamed: file → file.obsolete.20251109_110500

Error:

✗ Not found: missing.txt
─────────────────────────────────────
Failed: 1

Quick Reference

Task Command
Remove single ./.claude/bin/safe-rm file.txt
Remove multiple ./.claude/bin/safe-rm f1 f2 dir/
Restore mv file.obsolete file
List obsolete find . -name "*.obsolete"
Count `find . -name "*.obsolete" \ wc -l`

Supporting Files

  • [EXAMPLES.md](EXAMPLES.md) - 10 scenarios: temp files, refactoring, tests, collisions, assets, docs, batch ops, scripting, git, hooks
  • [TEMPLATES.md](TEMPLATES.md) - Copy-paste commands for all operations
  • [VALIDATION.md](VALIDATION.md) - Safety checklists, verification commands

Key Insight

Safety by design: No permanent deletion → collision protection → hook compliance → audit trail. Development workflow: Refactor → safe-rm → Test → Review period → Permanent delete after confidence.