skills.rest
SteveGJones
SteveGJonesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

kb-staleness-check

Compare knowledge base shelf-index hashes against library files to detect drift.

41|6|Updated Jul 12, 2025
Search Tags:#validation#drift#lint#pre-push#knowledge-base#shelf-index
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-staleness-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kb-staleness-check
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-knowledge-base/skills/kb-staleness-check
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill kb-staleness-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verify that the knowledge base shelf-index reflects the current state of the library files, surfacing drift without automatically rebuilding. This helps teams ensure alignment between the library content and its index, especially when enabling opt-in checks in CI or pre-push workflows.

Core Features & Use Cases

  • Opt-in environment validation extension that surfaces shelf-index drift without modifying existing core validation logic.
  • Supports both default warning mode and strict mode via the --strict flag for blocking drift in CI or pre-push hooks.
  • Provides a clear drift report and guidance to rebuild the index using kb-rebuild-indexes; safe to wire into pre-push validations.

Quick Start

Run the knowledge-base staleness check against your configured library and shelf-index to identify drift before pushing.

Frequently Asked Questions about kb-staleness-check

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

FAQPage Schema
How do I detect knowledge base shelf-index drift before pushing changes?▼

To detect knowledge base shelf-index drift, run a staleness check against your configured library and shelf-index to compare hashes and surface missing or changed entries without automatically rebuilding.

What is knowledge base drift validation in a pre-push hook?▼

Knowledge base drift validation is an opt-in environment check that compares the shelf-index against library files to ensure content alignment, operating in warning mode by default or strict mode to block drift.

Can I use strict mode to block shelf-index drift in CI pipelines?▼

Yes, you can use strict mode to block shelf-index drift in CI pipelines by passing the --strict flag, which elevates warnings to blocking errors and halts execution when index drift is detected.

How do I rebuild the shelf-index after finding drift?▼

To rebuild the shelf-index after finding drift, use kb-rebuild-indexes as guided by the staleness check's drift report to update the index and realign it with the current library content.

Do I need a configured knowledge base to check for shelf-index staleness?▼

Yes, you need a configured knowledge base to check for shelf-index staleness, requiring the shelf-index path to exist and the ability to parse and compare hashes against the library files.

Related Skills

Explore More Software Engineering Skills→
SteveGJonesSteveGJones
41

kb-rebuild-indexes

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

Community
Intermediate
tale-projecttale-project
20

auth-schema

Regenerate the Better Auth Convex schema from the auth config using the Better Auth CLI.

Official
Intermediate
FutureAtomsFutureAtoms
1

git-github-git-hooks

Configure Git hooks for automated linting, formatting, and commit message validation.

Community
Advanced
SteveGJonesSteveGJones
41

kb-codeindex

Parse '# implements:' annotations and generate library/_code-index.md and library/_dependency-edges.md.

Community
Advanced