← Back to Skills Marketplace
Workspace Auto Maintenance
by
zhangyi881
· GitHub ↗
· v1.0.0
· MIT-0
87
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install workspace-auto-maintenance
Description
Automates OpenClaw workspace health checks and fixes issues like redundant files, permissions, naming, and Git commits across platforms.
Usage Guidance
This tool will modify your workspace when run with --fix: it moves files into ./tmp, renames files under memory/, changes .ps1 ACLs on Windows, and will run git add/commit if a .git folder exists. Before installing or running: (1) review the included src/workspace_check.py source yourself; (2) run the script without --fix first to inspect its report; (3) back up your workspace or use a disposable/test repository; (4) ensure you understand which files the script considers 'non-essential' (it will move any root file not in its small whitelist); (5) be aware the package metadata does not declare required binaries (git, icacls), and the script will commit using your Git identity/config; (6) if you do not want autonomous modifications, restrict agent ability to invoke skills or disallow automated runs of this skill. If the developer intends automatic fixes, ask them to add a dry-run mode, explicit confirmation prompts, and to declare required binaries in the metadata.
Capability Analysis
Type: OpenClaw Skill
Name: workspace-auto-maintenance
Version: 1.0.0
The skill performs automated workspace maintenance that involves high-privilege file system and shell operations. Specifically, `src/workspace_check.py` uses `shutil.move` to automatically relocate any root-level files not on a hardcoded allowlist to a temporary directory, and employs `subprocess.run` to modify file permissions using `icacls` (on Windows) and execute `git` commands. While these behaviors are aligned with the 'Auto Maintenance' purpose described in `SKILL.md`, the automated movement of potentially sensitive files and the use of shell execution for permission changes are risky capabilities that warrant caution.
Capability Assessment
Purpose & Capability
Name/description align with the code: the script scans the workspace, renames/moves files, adjusts script permissions, and auto-commits Git changes — all consistent with an 'auto maintenance' tool.
Instruction Scope
SKILL.md instructs the user to run the Python script (and to use --fix to auto-repair). The code will move non-essential root files into a tmp folder, rename memory files, change ACLs on .ps1 files, and run git add/commit. These are local, modifying operations that can change or hide user data and create commits without interactive confirmation; the README does not adequately warn about risk or require an explicit confirmation/dry-run before performing destructive actions.
Install Mechanism
No install spec (instruction-only plus included script). That is low-install-risk — nothing is downloaded or written by an installer. The script itself is included in the package.
Credentials
Registry metadata claims 'required binaries: none', but the script calls external tools (git via subprocess, and icacls on Windows). It also uses os.getlogin() and will commit using whatever Git credentials/config are present. No environment variables or credentials are requested in metadata, yet the script can modify a Git repo and change ACLs — this mismatch should be declared and explained.
Persistence & Privilege
always:false and no special persistence requested. The skill does not try to modify other skills or global agent settings. However, because model invocation is allowed by default, an agent could run the script (including with --fix) autonomously unless restricted — note for the user.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-auto-maintenance - After installation, invoke the skill by name or use
/workspace-auto-maintenance - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of workspace-auto-maintenance.
- Automates workspace health checks and provides a health score with problem identification.
- Supports one-click fixing of common issues (file archiving, naming conventions, script permissions, auto-commit Git changes) using the --fix flag.
- Allows for custom rule extensions.
- Fully compatible with Windows, Linux, and macOS.
- No extra dependencies; requires OpenClaw v0.9+ and Python 3.9+.
Metadata
Frequently Asked Questions
What is Workspace Auto Maintenance?
Automates OpenClaw workspace health checks and fixes issues like redundant files, permissions, naming, and Git commits across platforms. It is an AI Agent Skill for Claude Code / OpenClaw, with 87 downloads so far.
How do I install Workspace Auto Maintenance?
Run "/install workspace-auto-maintenance" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Workspace Auto Maintenance free?
Yes, Workspace Auto Maintenance is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Workspace Auto Maintenance support?
Workspace Auto Maintenance is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Workspace Auto Maintenance?
It is built and maintained by zhangyi881 (@zhangyi881); the current version is v1.0.0.
More Skills