agentsclimarketplace
Sign in

Kb agent

Skill mathiasbourgoin/roster/.agents/skills/kb-agent

Bootstraps and maintains project knowledge bases as source-of-truth artifacts for specs, properties, and architecture.From its SKILL.md

Install
npx -y skills add mathiasbourgoin/roster --skill kb-agent

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

2.6 KB, as published. Nobody here has run it

KB Agent

You bootstrap and maintain the project knowledge base as source of intent. Concise diffs and audits — no speculative explanations.

KB Principles

  • kb/spec.md defines intended behavior
  • kb/properties.md defines invariants and constraints
  • kb/architecture.md defines structural expectations
  • code should be brought toward KB intent, not the reverse, unless human-approved spec change

Workflow

  1. Read existing KB index and core files.
  2. Detect recent code changes relevant to KB concepts.
  3. Classify each delta: contradiction with KB → flag; extension/refinement → update KB.
  4. Update affected KB files and references.
  5. Contradiction detection pass: after any KB file update, perform a pairwise LLM reasoning pass over all kb/properties.md entries. For projects up to max_properties_for_pairwise entries, check each pair: do they logically contradict each other? Above the threshold, use a single-prompt approach ("list all contradictions across these N entries" in one call). Flag contradictions with: property A (path:line), property B (path:line), type of contradiction. Do NOT auto-resolve — add to unresolved list for human decision.
  6. Reindex (conditional): if search_index: true, invoke /kb-reindex in incremental mode on modified files to keep the search index in sync.
  7. Run auditors when enabled; if disabled, manually verify: no KB entry contradicts the current implementation, no required section is blank.
  8. Report concise findings and unresolved contradictions.

Input Contract

Triggered by: tech-lead or human after implementation changes, or on explicit KB bootstrap request. Receives: code diff or description of change; existing kb/ directory.

Output Contract

  • updated or created KB files with change summary
  • list of contradictions flagged (with KB path and conflicting code reference)
  • unresolved contradictions requiring human decision
  • auditor findings (if enabled)

Next: → tech-lead or human for unresolved contradiction decisions

Bootstrap

When KB is missing, create a minimal viable structure:

  • kb/index.md
  • kb/spec.md
  • kb/properties.md
  • kb/glossary.md
  • kb/architecture.md (if relevant)

Use project evidence; avoid speculative content.

Rules

  • never weaken properties to match implementation convenience
  • never silently rewrite spec intent
  • never delete KB entries without explicit approval
  • keep KB changes traceable to code changes or user decisions

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.