Kb core

Skill pfeff/claude-skills/skills/kb-core

Shared library for the LLM Knowledge Base skills (kb-capture, kb-compile, kb-lint). Holds the SPEC v2 §1 primitives — capture predicate, idempotency key, off-limits write-guard, KB-ownership check, concept-slug dedup, orphan detection — in one place so the three skills share one implementation. Reference/infrastructure content, not user-invocable; the three KB skills load its scripts.From its SKILL.md

Install

npx -y skills add pfeff/claude-skills --skill kb-core

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.1 KB, as published. Nobody here has run it

KB Core (shared library)

Shared infrastructure for the three LLM-Knowledge-Base skills. Not user-invocable — there is no operation to run here (precedent: lN-lifecycle-doctrine). It exists so the deterministic logic from SPEC v2 §1 lives in exactly one place.

Source of truth

File	Purpose
`references/spec-v2-contract.md`	Reconstructed KB SPEC v2 contract — the 3 design bullets (Ownership, Reuse the vault schema, Billing) and the AC-1.x/2.x/3.x/6.x acceptance-criteria checklist, with provenance to PR #123. The original `SPEC.md`'s §N numbering was lost with the unarchived `llm-kb` workspace; this reconstructs the surviving AC-level contract in-repo.

What it provides

scripts/kb_core.py — pure, vault-I/O-free primitives consumed by kb-capture, kb-compile, and kb-lint:

Capture predicate (is_eligible, CAPTURE_TAG) — the SPEC §2.1 eligibility gate (highlight/notes + work-relevance, with the kb tag override).
Idempotency (source_key) — stable, filesystem-safe key from the Reader id, so re-capture / re-compile are no-ops (INV-4).
Content-aware re-sync (highlights_fingerprint, new_highlights) — lets kb-capture tell whether an already-captured source's highlights changed since its last sweep, and compute just the delta to fold in, instead of source_key existence alone silently skipping a source forever once it's captured once.
Write boundary (is_writable, OFF_LIMITS) — the INV-1 floor: never write under DevOps Documentation/ or Confluence/.
KB ownership (is_kb_owned, KB_PROJECT) — is a note KB-authored? Confines lint auto-fix to KB notes (AC-6.2); everything else is proposal-only.
Concept dedup (concept_slug) — stable slug so re-compile updates a concept note in place instead of duplicating it (AC-2.3).
Orphan detection (find_orphans) — notes with no inbound backlinks (AC-6.3 input).
type: constants (TYPE_RAW, TYPE_SUMMARY, TYPE_CONCEPT, TYPE_MOC) — the note kinds compile emits (kb-raw / reference / zettel / moc).

No zones, no fence: edit safety is git + review (SPEC v2 §1, INV-5).

Status

All primitives implemented and unit-tested (test_kb_core.py).

Tests

cd skills/kb-core/scripts && python3 -m unittest test_kb_core

Stdlib unittest (zero-dependency, matches task-workflow/scripts/test_render_deps.py).