kb-register-library

Register knowledge base libraries in ~/.sdlc/global-libraries.json with path and format validation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill registers an external knowledge base into the user-scope global registry at ~/.sdlc/global-libraries.json, validating the library path, ensuring it contains a _shelf-index.md, and parsing its format_version to guarantee compatibility.

Core Features & Use Cases

  • Registers external knowledge bases for cross-project reuse.
  • Validates path existence and presence of a shelf index.
  • Parses and validates the shelf index format_version for compatibility.
  • Supports optional descriptions to improve library discoverability.

Quick Start

Register a library by providing a unique name and the absolute path to its library directory in ~/.sdlc/global-libraries.json.

Frequently Asked Questions about kb-register-library

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

FAQPage Schema
How do I register an external knowledge base into a global library registry?▼

To register an external knowledge base, provide a unique name and the absolute path to its directory. The skill validates the path exists, confirms a _shelf-index.md is present, and parses its format_version for compatibility before adding it to the registry.

What validation steps are required when adding a knowledge base to the registry?▼

Validation requires checking that the library directory path exists, verifying it contains a _shelf-index.md file, and parsing the format_version within that shelf index to ensure compatibility before registering the knowledge base.

Can I add a description when registering a knowledge base library?▼

Yes, you can supply an optional description when registering a knowledge base library. This annotation improves library discoverability and helps identify the knowledge base within the global registry.

Where is registered knowledge base library data stored?▼

Registered knowledge base library data is stored in ~/.sdlc/global-libraries.json. This user-scope global registry file tracks the unique name, absolute directory path, and optional description of each validated library.

Why does my knowledge base registration fail without a shelf index?▼

Registration fails because the skill validates the presence of a _shelf-index.md file within the library directory. Without this shelf index, the knowledge base cannot be parsed for format_version compatibility and will not be registered.

When do I need to register a knowledge base in the global libraries registry?▼

You need to register a knowledge base when you want to enable cross-project reuse of external information. This process links a named library directory into the global registry after validating its shelf index format.