A diagnostic utility that scans OpenClaw workspaces to identify maintenance needs, file bloat, and organizational issues for AI agents.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workspace-analyzer
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install workspace-analyzer using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Workspace Analyzer?
The Workspace Analyzer is a fundamental maintenance utility designed for developers and power users of Openclaw Skills to keep their agent environments lean and efficient. It dynamically scans the workspace to identify core files, detects redundant content across multiple documents, and flags broken wiki links or abandoned resources that contribute to technical debt.
By delegating the heavy lifting of structural analysis to a specialized script, this skill provides agents with actionable JSON reports. This enables a workflow where the tool analyzes the environment and the agent decides on the appropriate corrective actions, ensuring a high-performance workspace without manual auditing overhead.
Workspace Analyzer Use Cases
- Identifying duplicate content across SOUL.md, OPERATING.md, and other core configuration files to maintain a Single Source of Truth.
- Detecting file bloat where specific documents exceed recommended line-count thresholds for optimal agent processing.
- Finding orphan files or outdated session logs that haven't been modified in over 30 days to reduce storage noise.
- Validating complex directory structures within Openclaw Skills environments to ensure all core files are present.
- Troubleshooting broken wiki links within a local documentation hierarchy to maintain knowledge integrity.
How Workspace Analyzer Works
- The script initiates a dynamic scan of the root directory to categorize files based on location patterns like KAI Core, Mission Control, or Agent Cores.
- It performs a deep content analysis against category-specific thresholds for line counts and structural metadata.
- The tool executes a validation check for the Single Source of Truth (SSOT) to ensure critical topics exist in exactly one primary location.
- It generates a comprehensive JSON report mapping every detected issue to a severity level ranging from INFO to CRITICAL.
- The AI agent interprets the report findings and follows the provided fix instructions to consolidate or archive files.
Workspace Analyzer Setup
To install this utility within your Openclaw Skills directory, follow these steps:
# Clone or copy the skill to your local skills folder
cp -r workspace-analyzer/ ~/.openclaw/workspace/skills/
# Run a full analysis on your workspace
python3 skills/workspace-analyzer/scripts/analyzer.py
# Run a quick scan for structure only
python3 skills/workspace-analyzer/scripts/analyzer.py --quick
# Export the analysis to a specific report file
python3 skills/workspace-analyzer/scripts/analyzer.py --output report.json
Workspace Analyzer Data Schema & Taxonomy
The analyzer organizes its findings into a structured JSON schema for easy programmatic consumption:
| Component | Description |
|---|---|
| scan_info | Contains root path, timestamp, and total files scanned. |
| core_files_detected | Lists detected files categorized by role (e.g., skills, agent_cores). |
| analysis | Provides per-file metrics including line counts and detected issues. |
| single_source_validation | Flags topics that appear in multiple files and suggests a primary source. |
| recommendations | A list of actionable tasks with severity ratings (CRITICAL, WARN, INFO). |
Workspace Analyzer Advanced Features
- Dynamic core file detection that adapts automatically to changes in the workspace structure.
- Category-specific bloat thresholds that apply different limits to reference docs versus core identity files.
- Single Source of Truth (SSOT) validation to prevent logic conflicts in agent behavior files.
- Heartbeat integration support for automating weekly maintenance and cleanup cycles.
- Detailed fix instructions for agents to resolve duplicate content via reference links and bootstrap injection.
SKILL.md
Loading
Related Openclaw Skills
Skill Install Guardian
A security and due diligence layer that performs deep content scanning and malicious pattern detection before installing external skills.
Skill Creator
A comprehensive development pipeline for designing, testing, and publishing high-performance AI agent skills with built-in best practices.
Remotion Video Generator
An AI-driven video production workflow that generates professional motion graphics programmatically using React and Remotion.
Minimal Memory Management
A structured two-tier memory system for AI agents that categorizes learnings into GOOD, BAD, and NEUTRAL entries to ensure a lean and searchable knowledge base.
tg-miniapp
A comprehensive toolkit for building and debugging Telegram Mini Apps, resolving common safe area, layout, and API integration challenges.
Rocket.Chat
A comprehensive integration for managing Rocket.Chat messaging, channel operations, and user administrative tasks through a RESTful API.