# Kb Lint

> Use when auditing AgentKB frontmatter, context packs, and raw-source freshness.

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

---


# KB Lint

Use for knowledge-base health checks.

AgentKB keeps Markdown as the canonical storage format. Load the smallest sufficient context first, and make every write reviewable with Git diff.

## Checks

- Missing frontmatter on formal notes
- Missing required frontmatter fields
- Missing core project files
- Missing `_system/` protocol files
- Oversized or stale `context-pack.md`
- Raw sources that have not been processed
- Unprocessed captures in `inbox/codex-captures/`
- Stale candidates in `promotion/candidates/`
- Notes marked `needs_review: true`
- Active notes referencing `archive/`
- Index or logs that need review

## Procedure

1. Run `python3 scripts/kb_lint.py --vault <vault> --project <project> --write-report --json` when available.
2. Treat the generated report as review guidance, not an automatic repair.
3. Put risky changes in `proposed-changes/`.
4. Apply only scoped, source-grounded fixes.
5. Review the Git diff before completion.

## Safety

Do not auto-delete, rename, move, or rewrite canonical notes.