Recycle Bin - File Recovery Skill

Recover deleted files from a project's recycle bin using a Python script.

12|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/aidanmorgan/token-bonfire --skill recycle-bin-file-recovery-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Recycle Bin - File Recovery Skill
Source: https://github.com/aidanmorgan/token-bonfire/tree/main/.claude/skills/recycle-bin
Command: npx skills add https://github.com/aidanmorgan/token-bonfire --skill recycle-bin-file-recovery-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bashlex, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a safety net for accidental file deletions, allowing for the recovery of files that have been moved to the recycle bin.

Core Features & Use Cases

  • List Recoverable Files: View all files currently in the recycle bin with their original details.
  • Recover Files: Restore deleted files to their original location or a specified new path.
  • Purge Files: Permanently delete files from the recycle bin.
  • Check Hook Status: Verify if the file recovery hook is active.
  • Use Case: If a critical configuration file is accidentally deleted during a development sprint, this skill can be used to quickly recover it, preventing build failures and saving development time.

Quick Start

Use the recycle-bin skill to list all recoverable files.

Frequently Asked Questions about Recycle Bin - File Recovery Skill

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

FAQPage Schema
How do I recover accidentally deleted files from a project recycle bin?

To recover accidentally deleted files, use this skill to list recoverable items in the designated trash directory and restore them to their original location or a new path. It intercepts file deletion commands to prevent permanent data loss.

Can I list and restore deleted configuration files to their original path?

Yes, you can list deleted configuration files and restore them to their original path. This skill recovers accidentally deleted project files from the recycle bin, preventing build failures and saving development time during a sprint.

Does this file recovery method protect critical system files from being deleted?

Yes, this file recovery method includes security guarantees against deleting critical system files. It operates by intercepting file deletion commands and moving files to a designated trash directory instead of permanently removing them.

How do I permanently purge files from the recycle bin after data restoration?

You can permanently purge files from the recycle bin after data restoration by using the skill's purge feature. This ensures that deleted files are completely removed from the designated trash directory when they are no longer needed.

What is the best way to check if my file recovery hook is active?

The best way to check if your file recovery hook is active is to use the skill's hook status verification feature. This confirms that file deletion commands are being successfully intercepted and moved to the trash directory.

Do I need bashlex to use this undelete and data restoration script?

Yes, you need bashlex installed to use this undelete and data restoration script. The Python script relies on this dependency to parse bash commands and intercept file deletions for the recycle bin.