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.