kb-lint

kb-lint is a skill for Claude Code, Codex from hogu-dev/llmkb. It costs 54 tokens per session (369 once invoked), scanned A, original, Apache-2.0.

A maintenance workflow for an llmkb knowledge base, a folder of linked notes built for language-model queries. It checks both file-level errors and problems that require reading and comparing the content.

In plain words
What is it for?
Use it to run the knowledge-base linter, repair indexes and page metadata, reconcile contradictions, update outdated claims, add missing concept pages, and record the check in the project log.
Why use it?
It helps prevent broken links, missing pages, conflicting statements, and information that has been replaced by newer sources from making the knowledge base unreliable.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/hogu-dev/llmkb/kb-lint
Any agent
npx skills add hogu-dev/llmkb --skill kb-lint
Clone the repo
git clone --depth 1 https://github.com/hogu-dev/llmkb

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for kb-lint

README.md
[![agentmods](https://agentmods.dev/badge/skills/hogu-dev/llmkb/kb-lint.svg)](https://agentmods.dev/skills/hogu-dev/llmkb/kb-lint)
Your own site
<a href="https://agentmods.dev/skills/hogu-dev/llmkb/kb-lint"><img src="https://agentmods.dev/badge/skills/hogu-dev/llmkb/kb-lint.svg" alt="Measured on agentmods" height="20"></a>
Per session 54 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 369 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00054 $0.00369
Opus 5 $0.00027 $0.00185
Sonnet 5 $0.00011 $0.00074
Haiku 4.5 $0.00005 $0.00037

Measured 3d ago against content hash fd7b73f54508, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

kb-lint scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/kb-lint/SKILL.md · 36 lines

What it actually says

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.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 36 lines · 54 tokens per session scan A fd7b73f54508

Subscribe to this mod's changes

kb-lint is a skill published in the GitHub repository hogu-dev/llmkb (1 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 54 tokens to every session and 369 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

memory-loop-setup

Bootstrap a battle-tested memory loop (shared warm-layer BRIEF · 6-type capture log · open-loops registry · session-card hook · deadman switch · human gate) into any repo or Obsidian vault. Triggers: (1) "set up the memory loop / second brain / warm layer here", (2) "install this memory structure in another…

Elliotoh-jin/claude-memory-loop · 100 tokens

qector-testing-strategy

The QECTOR testing and validation strategy (manual 23). Covers the eight validation layers (syndrome faithfulness, property- based, exhaustive oracle, cross-decoder equivalence, DEM pipeline, LER parity, qLDPC correctness, memory behaviour, API stability, GPU kernels), the stale test-count policy, the cross-decoder…

GuillaumeLessard/qector-claude-plugin · 126 tokens

qector-architecture

QECTOR architecture overview: the Rust core / Python layer FFI boundary, the module map, the threading and memory models, the layering of services, and the bit-determinism guarantee. Load for any question about the engine's internals, where a class lives, how the GIL interacts with the decode call, or why batch decode…

GuillaumeLessard/qector-claude-plugin · 80 tokens

eng-unity-mobile-optimization

Mobile-specific Unity optimization patterns for memory, battery, thermal, and performance.

IdoCohen560/claude-unity-game-studio · 22 tokens

tools-unity-addressables

Unity Addressables patterns for asset loading, memory management, reference counting, and remote content delivery.

IdoCohen560/claude-unity-game-studio · 25 tokens

tools-unity-memorypack

MemoryPack high-performance binary serialization for Unity including custom formatters, versioning, and performance patterns.

IdoCohen560/claude-unity-game-studio · 26 tokens