About

Imported from stjbrown/agent-knowledge (skills/kb/SKILL.md). Install upstream with npx skills add stjbrown/agent-knowledge --skill kb. Copyright stays with the author.

kb — bundles

Name: kb
Author: stjbrown

Hub for the kb-* family: vocabulary, shared reference, routing. Knowledge compounds — compiled once, kept current, not re-derived per query. Does not modify a bundle — routes to the skill that does.

Key terms

references/glossary.md defines the vocabulary. Minimum before routing: Bundle, Ingest, Progressive disclosure, Trust model (see trust-model.md).

The one hard rule

A bundle is conformant iff every non-reserved .md file has parseable YAML frontmatter with a non-empty type. Everything else is soft guidance — consumers MUST tolerate missing optional fields, unknown types, and broken links. Never reject a bundle over them. Full rules: references/SPEC.md §11.

The domain portion of spec/types.md is a living, producer-chosen vocabulary, not a validation enum. Keep the workflow conventions Reference and Spec Section; start the domain types small and evolve them through kb-ingest or kb-document when the domain reveals a durable new kind of entity. Use kb-lint to detect schema drift.

Route to the right skill

The user wants to…	Use
Start a new bundle	`kb-init`
Capture, ingest, file, or process a source (note, transcript, PDF, image, URL)	`kb-ingest`
Document a repository, explain its architecture/workflows, or refresh knowledge after code changes	`kb-document`
Ask what the bundle knows; look something up; explore connections	`kb-query`
Health-check the bundle (drift, orphans, contradictions, conformance)	`kb-lint`
See the bundle as a graph	`kb-visualize`

If a knowledge/ bundle exists and would inform the current task, consult it via kb-query before answering from scratch — even when the user didn't ask an explicit knowledge question.

Shared reference (single source of truth)

Every kb-* skill reads these rather than restating them, so the family stays consistent:

references/SPEC.md — OKF v0.2, vendored verbatim.
references/version-profile.md — v0.2 production and v0.1 compatibility rules; every writing skill reads it before changing a bundle.
references/glossary.md — leading words and definitions.
references/trust-model.md — the maintenance rules.
templates/ — concept.md, index.md, log.md starters.
example-bundle/ — a tiny conformant bundle: a worked example, and the seed kb-init copies from.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/stjbrown-agent-knowledge-kb/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

stjbrown-agent-knowledge-kb.ocm.jsonjson

{
  "ocm": "1",
  "id": "stjbrown-agent-knowledge-kb",
  "kind": "skill",
  "name": "kb",
  "description": "Portable OKF knowledge bundle for coding-agent memory and LLM wikis. Use when the user wants to start a wiki, ingest a source, document a repository, query project knowledge with citations, lint for drift, or visualize connections; whenever a repo has a knowledge/ bundle that should inform the task; and when another kb-* skill needs the shared spec, glossary, templates, or trust model.",
  "publisher": "stjbrown",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "data_analysis"
    ],
    "tags": [
      "skill-md",
      "knowledge",
      "okf",
      "bundle",
      "hub",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Portable OKF knowledge bundle for coding-agent memory and LLM wikis. Use when the user wants to start a wiki, ingest a source, document a repository, query project knowledge with citations, lint for drift, or visualize connections; whenever a repo has a knowledge/ bundle that should inform the task; and when another kb-* skill needs the shared spec, glossary, templates, or trust model."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/stjbrown/agent-knowledge",
      "path": "skills/kb/SKILL.md",
      "ref": "0d1a8282d90b1ef347c5e26575e57603de7bad77",
      "url": "https://github.com/stjbrown/agent-knowledge/blob/0d1a8282d90b1ef347c5e26575e57603de7bad77/skills/kb/SKILL.md",
      "key": "stjbrown/agent-knowledge/skills/kb/SKILL.md"
    }
  },
  "instructions": "# kb — bundles\n\n**Hub** for the `kb-*` family: vocabulary, shared reference, routing. Knowledge **compounds** —\ncompiled once, kept current, not re-derived per query. Does not modify a bundle — routes to the\nskill that does.\n\n## Key terms\n\n[references/glossary.md](references/glossary.md) defines the vocabulary. Minimum before routing:\n**Bundle**, **Ingest**, **Progressive disclosure**, **Trust model** (see\n[trust-model.md](references/trust-model.md)).\n\n## The one hard rule\n\nA bundle is **conformant** iff every non-reserved `.md` file has parseable YAML frontmatter with a\nnon-empty `type`. Ever",
  "cost": {
    "context_tokens": 715
  }
}

Fetch it by URL: GET /api/v1/registry/stjbrown-agent-knowledge-kb/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.