kb-spec

Create or update Knowledge Database specifications with governance checks.

2|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill kb-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-spec
Source: https://github.com/Remaker-Digital/groundtruth-kb/tree/main/.claude/skills/kb-spec
Command: npx skills add https://github.com/Remaker-Digital/groundtruth-kb --skill kb-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of keeping the Knowledge Database consistent, complete, and governance-compliant by turning spec creation and updates into a validated, repeatable workflow.

Core Features & Use Cases

  • Governed spec-first workflow (GOV-01): Creates or updates specs while enforcing required fields and ID formatting to prevent drift and ambiguity.
  • Duplicate prevention & ID validation: Validates SPEC-ID format and checks for duplicates before inserting new records.
  • Assertion-driven quality (GOV-18): Encourages machine-verifiable assertions so specs can be verified via automated checks.
  • Status transition safety (GOV-02): Restricts updates that would break governance rules, especially around immutable fields and status promotion logic.

Use cases: Drafting new requirements for an application, formalizing governance rules as specs, updating existing specs for implementation/verification stages, and ensuring every spec includes meaningful assertions for later verification.

Quick Start

Run the kb-spec skill with the action new and provide the SPEC-ID you want to create or update, then follow the prompted steps to validate fields, prevent duplicates, and include at least one machine-verifiable assertion.

Frequently Asked Questions about kb-spec

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

FAQPage Schema
How do I enforce spec-first governance rules when creating new specifications?

To enforce spec-first governance rules, you must validate required fields and SPEC-NNNN ID formats before inserting new records. This prevents duplicates and ensures specification-first workflows maintain consistency across the knowledge database.

What is the best way to prevent duplicate specifications in a knowledge database?

The best way to prevent duplicate specifications is to validate the SPEC-NNNN ID format and check existing records before insertion. This duplicate prevention mechanism ensures knowledge database consistency during governed spec creation.

How do I add machine-verifiable assertions to a specification for automated checks?

To add machine-verifiable assertions, include at least one assertion that meets GOV-18 quality expectations when creating or updating a specification. This assertion-driven quality approach enables specs to be verified via automated checks.

Can I update existing specifications during status transitions without breaking governance rules?

Yes, you can update existing specifications during status transitions while maintaining status transition safety. The workflow enforces GOV-02 governance rules, restricting updates that would alter immutable fields or break status promotion logic.

When do I need to validate SPEC-NNNN ID formats for specification lifecycle transitions?

You need to validate SPEC-NNNN ID formats whenever creating or updating specifications across lifecycle transitions. This validation is required to enforce GOV-01 spec-first workflows and prevent drift, ambiguity, and duplicate records.

What are the limitations of spec-first knowledge updates regarding immutable fields?

A key limitation of spec-first knowledge updates is that immutable fields cannot be altered during status transitions. Governance checks restrict these updates to ensure status promotion logic remains intact and spec lifecycle integrity is preserved.