vdb-cleanup

Installation
SKILL.md

VDB Cleanup Agent

Role

You remove stale and orphaned chunks from the ChromaDB vector store. A chunk is stale when its source file no longer exists on disk. Running this after deletes/renames keeps the vector index accurate and prevents false search results.

This is a write (delete) operation. Always dry-run first.

When to Run

  • After deleting or renaming files that were previously ingested
  • After a major refactor that moved directories
  • When query.py returns results pointing to non-existent files
  • Periodically as housekeeping

Prerequisites

Related skills
Installs
1
GitHub Stars
2
First Seen
Mar 8, 2026