An automated utility that maintains a structured and searchable index of your workspace directories and project metadata.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install workspace-indexer
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-indexer 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 Indexer?
The Workspace Indexer is a specialized organizational tool designed to provide AI agents with a high-level map of their working environment. By scanning the workspace, it generates a comprehensive WORKSPACE_INDEX.md file that documents the purpose, status, and history of every major directory. This ensures that Openclaw Skills can navigate complex file structures efficiently without the overhead of analyzing every internal project file.
This skill bridges the gap between raw file systems and intelligent context. It identifies project roots, detects running services, and links directories to historical memory logs, making it an indispensable asset for developers managing multiple projects or research environments using Openclaw Skills.
Workspace Indexer Use Cases
- Automatically updating the directory map when new projects or research folders are created.
- Performing daily maintenance checks via a heartbeat system to ensure the workspace index remains accurate.
- Identifying active services, such as Docker containers or web apps running on specific ports, for better environment awareness.
- Categorizing folders for cleanup or archival when they are no longer in active use.
How Workspace Indexer Works
- The skill initiates by performing a memory search to understand the historical context and purpose of existing directories.
- It executes a directory scan to identify the current structure of the workspace.
- It applies smart recursion logic to distinguish between container directories (like projects/ or skills/), project roots (identified by .git or package.json), and standard folders.
- Information is gathered by reading README files, checking for active ports, and identifying associated memory logs.
- The gathered data is synthesized and written into a structured WORKSPACE_INDEX.md file, providing a clean reference for future tasks.
Workspace Indexer Setup
To integrate this skill into your workflow, ensure your agent has the necessary permissions to execute directory scans and read memory files. You can automate the indexing process by adding the following configuration to your HEARTBEAT.md file:
## Workspace Index Maintenance
Daily check for workspace directory changes; update the index if new projects or modifications are detected.
Workspace Indexer Data Schema & Taxonomy
The skill maintains the WORKSPACE_INDEX.md file using a consistent schema for each entry. Data is organized as follows:
| Component | Description |
|---|---|
| Directory Path | The relative path to the project or folder. |
| Project Summary | A brief description of the project purpose and technology stack. |
| Operational Status | Includes active ports, running Docker IDs, or 'Pending Cleanup' flags. |
| Memory Reference | Links to relevant daily memory logs for historical context. |
| Search Keywords | Optimized tags for the agent to use during future memory lookups. |
Workspace Indexer Advanced Features
- Intelligent recursion that stops at project roots to maintain performance and avoid file clutter.
- Port and service discovery to track live development environments automatically.
- Integration with the Openclaw Skills memory system to link directory changes with historical dialogue logs.
- Automatic flagging of deprecated or large directories for manual cleanup reviews.
- Support for custom container directory definitions to suit unique workspace layouts.
SKILL.md
Loading
Related Openclaw Skills
Message Injector
A powerful OpenClaw extension that automatically prepends custom instructions or context to every user message before the agent processes it.
Perplexity AI Search (Safe Edition)
A security-hardened Perplexity API integration for real-time web-grounded search with citations.
Miniflux News
A robust tool to fetch, summarize, and manage unread RSS entries from your Miniflux instance via its REST API.
Write My Blog
An autonomous AI skill for creating, managing, and deploying full-featured blogs across multiple database architectures and hosting providers.
AI Stock Insider
A sophisticated AI agent skill for generating real-time A-share sector reports, mapping global news to stock movements, and analyzing US-market correlations.
freshbooks-cli
A professional command-line interface for managing FreshBooks accounting, invoices, and client data using the official API SDK.
Featured*
