← Back to Skills Marketplace
50
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install skill2cleaner
Description
扫描工作区所有 Skill，检测授权、配置和环境变量是否齐全， 并可按需禁用或卸载无效 Skill。
Usage Guidance
This skill appears to implement the advertised feature set, but review before use:
- It calls the 'openclaw' command-line tool, yet the skill declares no required binaries; ensure the 'openclaw' CLI is installed and works on the agent host or the script will fail or report nothing.
- The script reads ~/.openclaw/openclaw.json and the workspace skills directory to determine disabled/installed skills; make sure you trust the environment and that these paths are correct for your setup.
- The code checks for environment variable names found in other skills' manifests (to detect missing API keys) — it only checks presence and does not exfiltrate values, but it will report which keys are missing. If you have sensitive naming conventions you do not want enumerated, be aware of this behavior.
- The 'clean' action runs 'openclaw skills disable' or 'openclaw skills uninstall --force' — these are destructive operations. Always run 'report' first, inspect the list, and preferably run the cleanup in a controlled environment or with a backup.
- The implementation contains a bug: diagnose_skill references SkillStatus.CONFIG_INVALID which is not defined in SkillStatus; this can cause runtime exceptions when a manifest is missing or invalid. Consider fixing or testing the script yourself before relying on automated cleanup.
If you decide to install: run the script manually first (python3 skill_cleaner.py) to verify output, inspect the code locally, and avoid running the 'clean' action until you confirm the report is accurate.
Capability Analysis
Type: OpenClaw Skill
Name: skill2cleaner
Version: 1.0.0
The skill bundle is a management utility designed to audit and maintain the health of installed OpenClaw skills. The Python script (skill_cleaner.py) scans the local workspace, checks for missing environment variables defined in skill manifests, and provides options to disable or uninstall invalid skills using the 'openclaw' CLI. The code uses safe subprocess execution (passing arguments as lists) and limits its file operations to the standard OpenClaw configuration and skill directories, showing no signs of malicious intent or data exfiltration.
Capability Tags
Capability Assessment
Purpose & Capability
The code implements scanning, checking manifests, inspecting env vars, and invoking 'openclaw skills disable/uninstall', which matches the described purpose. However the skill metadata declares no required binaries while the implementation calls the 'openclaw' CLI via subprocess; this undeclared dependency is an inconsistency that will make the skill non-functional or behave unexpectedly when 'openclaw' is missing.
Instruction Scope
SKILL.md instructs running the included script to report/clean skills. The script reads the workspace skills directory and ~/.openclaw/openclaw.json and inspects other skills' SKILL.md/skill.yaml files to determine required env vars. It only checks for presence of env vars (does not print or transmit their values) and uses the 'openclaw' CLI to perform disable/uninstall. SKILL.md does not mention these filesystem/config dependencies or the need for the 'openclaw' binary, which is a documentation gap.
Install Mechanism
There is no external install step or network download; the repository includes the Python script and a small requirements.txt (pyyaml). No remote code fetch is performed during runtime.
Credentials
The skill declares no required environment variables. At runtime it reads whatever env var names it discovers in other skills' manifests to check whether they are set — this is proportionate to diagnosing missing API keys, but it means the script enumerates names of env vars present in the system's environment and will report which are missing. It does not itself request, store, or transmit secret values, but the ability to scan many env var names could reveal which vars are in use.
Persistence & Privilege
The skill does not request permanent 'always' inclusion and does not modify other skills' configurations directly; it invokes the 'openclaw' CLI to disable or uninstall skills (including '--force' for uninstall) which is appropriate for its purpose but is a privileged action — ensure the user running the agent consents before executing cleanup.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install skill2cleaner - After installation, invoke the skill by name or use
/skill2cleaner - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of skill-cleaner.
- Scans all installed skills to detect missing authorization, configuration, or environment variables.
- Generates a detailed skill health report with the `report` action.
- Allows users to disable or uninstall invalid skills using the `clean` action.
- Supports trigger phrases for health checks and cleanup scenarios.
- Guides users through identifying and removing unusable skills interactively.
Metadata
Frequently Asked Questions
What is Skill-cleaner?
扫描工作区所有 Skill，检测授权、配置和环境变量是否齐全， 并可按需禁用或卸载无效 Skill。 It is an AI Agent Skill for Claude Code / OpenClaw, with 50 downloads so far.
How do I install Skill-cleaner?
Run "/install skill2cleaner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Skill-cleaner free?
Yes, Skill-cleaner is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Skill-cleaner support?
Skill-cleaner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Skill-cleaner?
It is built and maintained by Edde-101 (@edde-101); the current version is v1.0.0.
More Skills