← Back to Skills Marketplace
theagentwire

Workspace Audit

by The Agent Wire · GitHub ↗ · v1.1.0
cross-platform ✓ Security Clean
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
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install workspace-audit
  3. After installation, invoke the skill by name or use /workspace-audit
  4. 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
Slug workspace-audit
Version 1.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 3
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.

💬 Comments