← Back to Skills Marketplace
Workspace Audit
by
The Agent Wire
· GitHub ↗
· v1.1.0
298
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install workspace-audit
Description
Audit your OpenClaw workspace for drift — stale paths, duplicate content, oversized files, secret leaks, and 1Password vault mismatches. Zero deps. By The Ag...
Usage Guidance
This skill appears to do what it says — scan your local OpenClaw workspace for drift and optionally compare TOOLS.md to your 1Password vault. Before running it:
- Review the scripts locally (they're included) and run them interactively first so you can inspect outputs.
- Ensure bash and python3 are available; the 1Password check requires the official op CLI and valid authentication (OP_SERVICE_ACCOUNT_TOKEN or op signin) if you want that audit.
- Be aware outputs (vault item titles, matching/missing filenames, and detected 'possible secrets') are printed to stdout and could end up in logs, cron emails, or monitoring systems — avoid running in environments where logs are exposed to untrusted parties.
- If you schedule it (cron/agent automation), restrict the execution environment and do not expose OP tokens or other secrets to shared runners. Review audit.conf to tune size limits.
- If you need stricter privacy, skip the 1Password audit or run the scripts with op disconnected so network calls to 1Password are avoided.
Capability Analysis
Type: OpenClaw Skill
Name: workspace-audit
Version: 1.1.0
The workspace-audit skill is a legitimate utility designed to maintain the integrity of an OpenClaw workspace by checking for broken paths, duplicate content, and file size limits. It includes security-enhancing features such as scanning for leaked secrets in memory files (audit-structure.sh) and ensuring credentials are confined to specific files (audit-duplication.sh). While it interacts with the 1Password CLI (audit-1password.sh), it does so locally to verify documentation alignment and shows no evidence of data exfiltration or malicious intent.
Capability Assessment
Purpose & Capability
The name/description match the included scripts: structure/size checks, duplication detection, path verification, and an optional 1Password vault cross-check. The declared 'zero deps' claim is accurate in spirit (bash + Python stdlib; 1Password CLI and git are optional). No unrelated credentials or remote services are requested.
Instruction Scope
Scripts operate on local workspace files, run grep/find/git/python, and optionally call the 1Password CLI (op) to list item titles. They do not fetch or transmit file contents to arbitrary external endpoints. Caveat: audit-1password.sh will invoke the user's configured op CLI which will contact 1Password to list items (expected for a vault audit). The scripts also print matching/missing items and file names to stdout — these outputs can surface sensitive metadata (item titles, filenames) into logs or cron emails.
Install Mechanism
No install specification; this is an instruction-and-script bundle. No downloads or archive extraction. The runtime relies on standard system tools (bash, python3) and optionally on op and git if present — all documented in SKILL.md.
Credentials
The skill declares no required env vars and only uses reasonable, optional environment variables (WS, TOOLS_MD, OP_VAULT, AUDIT_CONFIG). It suggests OP_SERVICE_ACCOUNT_TOKEN for 1Password authentication but does not require unrelated secrets or cloud credentials.
Persistence & Privilege
Skill is not forced-always (always:false) and does not modify other skills or system configuration. It is user-invocable and may be run on a schedule if you choose (cron), which is documented; that scheduling is under the user's control.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install workspace-audit - After installation, invoke the skill by name or use
/workspace-audit - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
Add FAQ section for GEO/AEO (LLM citation optimization)
v1.0.1
Fix frontmatter: match ClawHub format, add branding to description
v1.0.0
Initial release: structure/size checks, 1Password vault alignment, duplication detection, path reference validation, secret scanning. Zero deps.
Metadata
Frequently Asked Questions
What is Workspace Audit?
Audit your OpenClaw workspace for drift — stale paths, duplicate content, oversized files, secret leaks, and 1Password vault mismatches. Zero deps. By The Ag... It is an AI Agent Skill for Claude Code / OpenClaw, with 298 downloads so far.
How do I install Workspace Audit?
Run "/install workspace-audit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Workspace Audit free?
Yes, Workspace Audit is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Workspace Audit support?
Workspace Audit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Workspace Audit?
It is built and maintained by The Agent Wire (@theagentwire); the current version is v1.1.0.
More Skills