← Back to Skills Marketplace
Tidyfiles
by
bytesagain4
· GitHub ↗
· v2.0.0
· MIT-0
163
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install tidyfiles
Description
Sort and organize files into folders by type, date, or rules. Use when decluttering dirs, checking structure, running cleanup, generating reports.
Usage Guidance
This skill appears to do what it says: a small offline bash tool that logs and exports activity to ~/.local/share/tidyfiles. Before installing or running: (1) inspect the script (scripts/script.sh) yourself if you can; (2) be aware it will create and append to log files in your home directory — do not pass passwords, API keys, or other secrets as command arguments; (3) to remove it, delete ~/.local/share/tidyfiles; (4) note that while the skill does not require network access or credentials, allowing an autonomous agent to call it could cause it to record whatever text the agent passes, so limit autonomous use if you may provide sensitive context.
Capability Analysis
Type: OpenClaw Skill
Name: tidyfiles
Version: 2.0.0
The skill is a simple bash-based logging utility designed to record and track file management activities. It stores timestamped entries in local log files within `~/.local/share/tidyfiles/` and provides basic search, statistics, and export (JSON/CSV/TXT) functionalities. The script (scripts/script.sh) contains no network calls, persistence mechanisms, or dangerous execution commands like eval; it strictly performs text appending and local file metadata reporting.
Capability Assessment
Purpose & Capability
Name/description (file organization, tracking, reports) match the shipped assets: SKILL.md and a bash script that only records entries, exports, searches, and reports. No unrelated credentials, binaries, or services are requested.
Instruction Scope
SKILL.md instructs only local operations (logging, exporting, searching, stats). The included script implements these behaviors and references only files under the declared data directory (~/.local/share/tidyfiles). There are no instructions to read unrelated system files or transmit data externally.
Install Mechanism
No install spec is provided (instruction-only with an included script). Nothing is downloaded or extracted from remote URLs; code is contained in the repo. This is low-risk from an install standpoint.
Credentials
The skill requires no environment variables or credentials. The script uses only standard Unix utilities (grep, cat, tail, wc, du, date, sed, printf) consistent with the declared requirements.
Persistence & Privilege
The skill creates and writes files under the user's home directory (~/.local/share/tidyfiles). It does not request elevated privileges or system-wide config changes. The agent can invoke the skill autonomously by default (platform default) — this combined with local logging means an agent call could cause entries to be recorded, so avoid passing secrets to the skill.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tidyfiles - After installation, invoke the skill by name or use
/tidyfiles - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
Domain-specific upgrade
Metadata
Frequently Asked Questions
What is Tidyfiles?
Sort and organize files into folders by type, date, or rules. Use when decluttering dirs, checking structure, running cleanup, generating reports. It is an AI Agent Skill for Claude Code / OpenClaw, with 163 downloads so far.
How do I install Tidyfiles?
Run "/install tidyfiles" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tidyfiles free?
Yes, Tidyfiles is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tidyfiles support?
Tidyfiles is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tidyfiles?
It is built and maintained by bytesagain4 (@xueyetianya); the current version is v2.0.0.
More Skills