Ghost Catalog provides a semantic file header system and SQLite database to scan, tag, and organize files within any workspace for better discoverability and compliance.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ghost-catalog
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 ghost-catalog 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 Ghost Catalog?
Ghost Catalog is a sophisticated file management skill designed to bring order to messy codebases through a standardized semantic header system (SOM-XXX-NNNN-vX.X.X). By prepending metadata directly into source files and indexing them in a local SQLite database, it enables developers to track file versions, categories, and ownership effortlessly. This Openclaw Skills utility bridges the gap between raw file systems and structured documentation by automating the tagging process and providing powerful search capabilities across a project's entire file tree.
The system is built to be language-agnostic, adapting its comment syntax to fit Python, JavaScript, HTML, SQL, and more. It ensures that every file in your project has a clear identity, making it easier for both humans and AI agents to understand the purpose and history of the code they are interacting with.
Ghost Catalog Use Cases
- Onboarding to a new codebase and needing to understand file purposes quickly.
- Maintaining compliance with project-wide file header standards and versioning.
- Searching for specific components, scripts, or documentation by category or tag.
- Generating automated compliance reports for project health monitoring.
- Identifying and tagging untagged files created by various AI agents to maintain metadata integrity.
How Ghost Catalog Works
- The agent scans the workspace, merging exclusion rules from .ghost_ignore and .gitignore to identify relevant files while skipping dependencies.
- It checks for existing SOM headers in the first 20 lines of each file to determine its current catalog status.
- For untagged files, the system identifies the correct category (e.g., SCR for scripts, CMP for components) based on file extension and location.
- A unique sequence number and semantic header are generated and prepended to the file using the appropriate comment syntax for that file type.
- Metadata is synchronized into a local SQLite database, allowing for rapid fuzzy searching and statistical reporting across the project.
Ghost Catalog Setup
Ensure your environment has Python 3 and SQLite available. The database will be automatically initialized at data/ghost-catalog.db upon first use within the Openclaw Skills environment.
# Initialize or scan the workspace for untagged files
/ghost-catalog scan
# Tag a specific directory or pattern with semantic headers
/ghost-catalog tag ./src/components
# Verify header compliance and check for duplicates
/ghost-catalog validate
Ghost Catalog Data Schema & Taxonomy
The system utilizes a structured SQLite database to track file metadata and tags. Files are identified by a unique ID following the format SOM-XXX-NNNN-vX.X.X.
| Table | Description | Key Fields |
|---|---|---|
| file_catalog | Main registry of all tagged files in the workspace | file_id, path, category, checksum, agent_id |
| file_tags | Many-to-many relationship for searchable file tags | file_id, tag |
| agent_registry | Tracks which AI agents have modified specific files | id, model, first_seen, last_active |
Ghost Catalog Advanced Features
- Multi-agent tracking using the agent_id field to monitor which AI models or tools created specific files.
- Automated ignore-logic merging that respects both .gitignore and skill-specific .ghost_ignore files for precise scanning.
- Fuzzy search and deep filtering capabilities across categories, tags, and agent identifiers.
- Markdown report generation saved to docs/ghost-catalog-report.md for full workspace compliance auditing.
- Intelligent comment syntax detection that automatically selects the correct format for over a dozen file types including React components and Rust modules.
SKILL.md
Loading
Related Openclaw Skills
Lobster Trap
A shared digital whiteboard for synchronized management of notes, code snippets, and key labels via API.
OpenDex API Skill
A high-performance interface for retrieving Solana market data and community-driven token insights.
Multi Search Engine Integration
A comprehensive search integration providing access to 17 global and Chinese search engines without the need for API keys.
Event Watcher
A lightweight event-driven trigger system that wakes Openclaw agents only when specific Redis or Webhook events occur to minimize token spend.
Ghost Catalog
An intelligent file management system that implements semantic headers and a SQLite database to organize, tag, and validate project assets.
Improve Skill: The Meta-Skill
A meta-skill designed to evaluate and optimize other skills by identifying gaps in logic, codebase fit, and output quality.
Featured*
