kb-init

Creates a six-file knowledge base scaffold and wires it into CLAUDE.md or AGENT.md.

1|1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/Navdeepgambhir9023/nav --skill kb-init-navdeepgambhir9023
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-init
Source: https://github.com/Navdeepgambhir9023/nav/tree/main/skills/kb-init
Command: npx skills add https://github.com/Navdeepgambhir9023/nav --skill kb-init-navdeepgambhir9023

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? New projects lack a shared source of truth, so every agent session starts cold and humans repeat context. This Skill scaffolds a canonical kb/ knowledge base and links it into the agent entry-point file so project truth travels with the repo. ## Core Features & Use Cases - Canonical KB scaffolding: Creates kb/product.md, architecture.md, rules.md, principles.md, glossary.md, decisions.md, plus a README.md index, all with prompt-only placeholders. - Agent entry-point wiring: Creates CLAUDE.md if missing, or idempotently inserts a ## Knowledge Base reference section into an existing CLAUDE.md or AGENT.md. - Idempotent and non-destructive: Never overwrites existing KB files or unrelated CLAUDE.md sections, so it is safe to re-run. - Use Case: After cloning a fresh repo, run the skill once to establish the knowledge base structure, then fill in product truth yourself while every future agent session reads the same files. ## Quick Start Ask the agent to run /kb-init from your project root to create the kb/ knowledge base files and register them in CLAUDE.md.

Frequently Asked Questions about kb-init

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

FAQPage Schema
How do I set up a knowledge base for AI agents in my repo?

Run /kb-init from your project root. It creates a kb/ folder with six canonical Markdown files (product, architecture, rules, principles, glossary, decisions) plus a README index, and adds a Knowledge Base reference section to CLAUDE.md or AGENT.md.

What files does a project knowledge base need for Claude Code?

The canonical set is product.md, architecture.md, rules.md, principles.md, glossary.md, and decisions.md under kb/, referenced from a ## Knowledge Base section in CLAUDE.md so agents read them at the start of non-trivial tasks.

Does kb-init overwrite my existing CLAUDE.md or kb files?

No. The skill is idempotent and non-destructive: it only creates missing files and replaces or appends the managed ## Knowledge Base section, leaving all other CLAUDE.md or AGENT.md content and existing kb files untouched.

Can I use AGENT.md instead of CLAUDE.md with kb-init?

Yes. The skill prefers CLAUDE.md but falls back to AGENT.md if CLAUDE.md is absent, honoring whichever agent entry-point convention your tooling uses. It only creates CLAUDE.md when neither file exists.

Does kb-init fill in the knowledge base content automatically?

No. It creates prompt-only scaffolds with placeholder questions; writing actual product truth is the owner's responsibility. The skill explicitly refuses to invent content, and /kb-re-structure handles reorganizing existing notes.