← Back to Skills Marketplace
xlionjuan

Trash Cli

by XLion · GitHub ↗ · v1.0.5
cross-platform ✓ Security Clean
518
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install trash-cli
Description
Use trash-cli to safely delete files by moving them to the system trash instead of permanently removing them. This prevents accidental data loss and allows f...
Usage Guidance
This skill is a documentation/integration wrapper for the existing trash-cli tool and appears coherent. Before installing or following its commands: 1) prefer installing from your distro's package manager or the official GitHub release; 2) review any sudo commands (creating /.Trash and changing its permissions) because they modify root-owned paths and can affect system security; 3) be cautious about following instructions that list other users' trash (--all-users) if you care about privacy; 4) think twice before aliasing rm to anything — it can change your workflow and break scripts; and 5) if you allow the agent to run commands autonomously, restrict or require confirmation for any commands that alter filesystem permissions or run with sudo.
Capability Analysis
Type: OpenClaw Skill Name: trash-cli Version: 1.0.5 The OpenClaw AgentSkills bundle for 'trash-cli' is benign. The skill's purpose is to provide a safe file deletion utility, and all instructions and code examples in SKILL.md are directly related to installing and using this tool. There is no evidence of data exfiltration, unauthorized execution, persistence mechanisms, or prompt injection attempts against the AI agent. The administrative `sudo` commands for creating a top-level `.Trash` directory are clearly explained as an optional setup for specific partitions, not as a hidden or automatically executed malicious instruction.
Capability Assessment
Purpose & Capability
Name, description, required binaries, and install methods (brew/pip/apt/pacman/dnf) match the documented trash-cli tool. The skill does not request unrelated credentials or unusual binaries.
Instruction Scope
SKILL.md stays on-topic (how to use trash-put, trash-list, trash-restore, trash-empty, trash-rm). It does include instructions that modify system state: creating a top-level /.Trash with sudo and broad permissions, using trash-list --all-users (which surfaces other users' trash), and recommending shell rc edits/aliases. These are expected for a trash utility but are actions with real side effects that deserve user review.
Install Mechanism
Install options are standard package managers (brew, pip, apt, pacman, dnf). The registry metadata also lists a brew formula; these are proportionate to installing trash-cli.
Credentials
No environment variables, credentials, or config paths are requested. The skill does not attempt to access unrelated secrets or system configuration.
Persistence & Privilege
The skill is not always-enabled and requests no special platform privileges. However, its instructions explicitly advise editing shell rc files (aliases) and running sudo commands; installing or following those instructions will change user/system state. If you allow autonomous agent actions, those steps could be executed — consider limiting automation or requiring explicit confirmation.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install trash-cli
  3. After installation, invoke the skill by name or use /trash-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
* Enhanced metadata format* Removed homepage (not directly related to this project)
v1.0.4
* Enhanced metadata format * Removed homepage (not directly related to this project)
v1.0.3
- Updated version to 1.0.3 in documentation. - Removed the "Auto-delete files older than 30 days" FAQ and crontab example. - No changes to commands, usage, or installation instructions. - Content otherwise unchanged.
v1.0.2
Fix FreeDesktop.org Trash Spec link to correct URL (trash/latest/)
v1.0.1
Fix FreeDesktop.org Trash Spec link (was 404, now correct .xhtml)
v1.0.0
Initial release of trash-cli skill. - Safely deletes files by moving them to the system trash instead of permanently removing. - Offers commands to trash, list, restore, and permanently delete files. - Provides aliases, tips, and safety recommendations for replacing rm. - Includes installation instructions for multiple package managers. - Documents limitations and usage notes for supported filesystems.
Metadata
Slug trash-cli
Version 1.0.5
License
All-time Installs 2
Active Installs 1
Total Versions 6
Frequently Asked Questions

What is Trash Cli?

Use trash-cli to safely delete files by moving them to the system trash instead of permanently removing them. This prevents accidental data loss and allows f... It is an AI Agent Skill for Claude Code / OpenClaw, with 518 downloads so far.

How do I install Trash Cli?

Run "/install trash-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Trash Cli free?

Yes, Trash Cli is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Trash Cli support?

Trash Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Trash Cli?

It is built and maintained by XLion (@xlionjuan); the current version is v1.0.5.

💬 Comments