# Kb Lint

> Use to health-check an `llmkb` knowledge base — run llmkb lint and fix what it reports, then do the judgment-level checks code cannot: contradictions between pages, stale claims superseded by newer sources, and missing concept pages.

- Skill: `hogu-dev/kb-lint` (Agent Skill)
- Install (CLI): `npx skillmds@latest add hogu-dev/kb-lint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hogu-dev/kb-lint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: hogu-dev (https://skillmd.com/u/hogu-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hogu-dev/kb-lint

---


# kb-lint

Bring an `llmkb` knowledge base back to health: fix the mechanical defects the
tool finds, then the semantic ones only a reader can catch.

## When to use

Periodically, or when a KB feels stale or inconsistent, or before relying on it
for an important query.

## Steps

1. **Run the tool.** `llmkb lint --kb <dir>`. Fix every error: broken links,
   pages missing from the index (`llmkb reindex` repairs the index), dangling
   index entries, malformed frontmatter. Address warnings (orphans, log-format)
   where they matter.
2. **Judgment checks the tool cannot do:**
   - **Contradictions.** Read related pages together; reconcile claims that
     conflict, and note the resolution.
   - **Stale claims.** Where a newer source supersedes an older page, update the
     page and its `timestamp`; keep provenance in `sources`.
   - **Missing concept pages.** If several summaries reference an idea that has
     no concept page, create one and link them.
3. **Re-run** `llmkb lint` and confirm it is clean; append a
   `## [YYYY-MM-DD] lint | <scope>` line to `wiki/log.md`.

## Done when

`llmkb lint` is error-free and the semantic pass found no unresolved
contradictions, stale claims, or missing concept pages.