kb-rebuild-indexes

Rebuild knowledge base shelf-indexes by detecting modified library files with content hashes.

41|6|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-rebuild-indexes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-rebuild-indexes
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-knowledge-base/skills/kb-rebuild-indexes
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-rebuild-indexes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rebuilds the knowledge base shelf-index efficiently by detecting and reprocessing only changed library files, reducing processing time after updates.

Core Features & Use Cases

  • Incremental rebuild by default using content hashes to detect changes.
  • Full rebuild with the --full flag for complete re-extraction after logic changes or index drift.
  • Preflight validation ensuring knowledge base configuration and library path exist.
  • Use Case: After ingesting new sources or editing library files, run the skill to refresh the shelf-index.

Quick Start

Run /sdlc-knowledge-base:kb-rebuild-indexes to refresh the shelf-index after updating library files.

Frequently Asked Questions about kb-rebuild-indexes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I incrementally rebuild a knowledge base index after editing library files?

To incrementally rebuild a knowledge base index, the skill applies hash-based change detection to identify and reprocess only modified library files, refreshing the shelf-index efficiently after updates without reprocessing unchanged content.

When should I use a full index rebuild instead of an incremental one?

A full index rebuild is necessary after logic changes or index drift. You trigger it with the --full flag to perform complete re-extraction of all library files, bypassing the default hash-based incremental detection.

What is hash-based change detection for knowledge base shelf-indexes?

Hash-based change detection is a mechanism that uses content hashes to identify which library files have been modified, allowing the shelf-index to be rebuilt incrementally by targeting only those changed files.

What configuration do I need to run a shelf-index rebuild?

Running a shelf-index rebuild requires a valid knowledge base path, an existing library directory, and the sdlc-knowledge-base plugin's build_shelf_index module, which the skill validates during preflight before processing.

Why is my incremental shelf-index rebuild missing recent library file updates?

If an incremental shelf-index rebuild misses updates, index drift may have occurred; running a full rebuild with the --full flag forces complete re-extraction to synchronize the index with the current library state.