| name | kb |
| description | Umbrella for the kb LLM-maintained knowledge base skill. Bootstraps nine /kb-* slash commands (ingest, query, promote, lint, contradictions, prune, rebuild, reingest, bootstrap) on first use. Use when the user mentions kb, knowledge base, or wants to install/uninstall kb siblings. |
kb
/kb is the umbrella entrypoint for the kb knowledge base skill. Its job is twofold: run first-run setup, then tell the user which specific /kb-* command fits their intent.
First-run setup
Run this once. It is idempotent — safe to re-run.
bash "$(dirname "$(realpath "${BASH_SOURCE[0]:-$0}")")/bootstrap.sh"
If that command cannot be resolved (e.g. invoked in an environment that expanded the skill into ~/.claude/skills/kb/), instead run:
bash ~/.claude/skills/kb/bootstrap.sh
Expected output on success:
[kb] bootstrap complete (15 links managed)
On foreign-symlink abort, follow the printed remediation (rm <path> && re-run /kb). Never force. The script is non-destructive by design.
After setup — the nine commands
| Command | Purpose |
|---|
/kb-bootstrap | Initialize a new KB directory. |
/kb-ingest | Ingest a source file or URL. |
/kb-reingest | Re-process a changed source. |
/kb-query | Ask a question against the KB; answer saved to output/. |
/kb-promote | Promote a query output to wiki/synthesis/. |
/kb-lint | Health check schemas, links, staleness. |
/kb-contradictions | Semantic contradiction sweep (token-expensive). |
/kb-prune | Deprecate low-confidence or stale pages. |
/kb-rebuild | Regenerate the wiki from raw sources. |
When the user invokes /kb without a specific intent, ask which of these they want, or suggest the most likely one based on conversation context.
Uninstalling siblings
To remove the ~/.claude/skills/kb-* sibling links this install created (for example, before running npx skills remove minakoto00/kb):
bash ~/.claude/skills/kb/bootstrap.sh --uninstall
This removes only links tracked in ~/.config/kb/installed.json. Foreign links, user data, and the umbrella dir itself are left untouched.
Recovering from a deleted manifest
If ~/.config/kb/installed.json is missing or corrupt and /kb refuses-on-foreign for everything, delete the stale ~/.claude/skills/kb-* links manually, then run /kb again to rebuild.
Notes
- This umbrella does not perform KB operations itself — it is a setup + dispatcher.
- The shared registry at
~/.config/kb/registry.json and the ownership manifest at ~/.config/kb/installed.json are separate files; the manifest tracks only install state.
