ctx-kb-site-review

Mechanical structural audit of the kb. Coerces malformed capitalization, flags malformed closeout frontmatter, and refuses to make judgment calls that require evidence. Writes a site-review closeout for the audit trail.

Jump to install

Repository: ActiveMemory/ctx
Last source activity: May 18, 2026 at 02:55
Detected SKILL.md language: English
Stars: 74
Forks: 14

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/ActiveMemory/ctx --skill ctx-kb-site-review

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

name	ctx-kb-site-review
description	Mechanical structural audit of the kb. Coerces malformed capitalization, flags malformed closeout frontmatter, and refuses to make judgment calls that require evidence. Writes a site-review closeout for the audit trail.

Site-Review Pass

Walk .context/kb/ and .context/ingest/closeouts/ mechanically. Fix what is unambiguous (capitalization drift, missing frontmatter fields the CLI knows how to coerce). Flag what is not (claims that read as broken but require evidence to fix). Never invent prose. Never mint EV-### rows. Never modify a claim's Confidence band.

This is a janitor pass, not an editorial pass. Editorial judgment lives in /ctx-kb-ingest.

Authoritative background reading: .context/ingest/KB-RULES.md §Authority boundary; specs/kb-editorial-pipeline.md §Validation Rules.

When to Use

The user says "audit the kb", "check kb for rot", "run a site-review", or invokes the explicit slash form.
Before a release / handover where structural cleanliness matters.
After bulk ingest where drift may have accumulated.
When the doctor advisory has surfaced structural warnings the user wants triaged.

When NOT to Use

The user wants new material extracted (use /ctx-kb-ingest).
The user wants kb claims re-grounded against external sources (use /ctx-kb-ground).
The user is asking a content question (use /ctx-kb-ask).
The user wants to capture a quick finding (use /ctx-kb-note).

Authority Boundary (vs Other Skills)

/ctx-kb-site-review: mechanical structural audit. May coerce capitalization that the spec deems lossless (e.g. → ). May flag any other malformation in the closeout's block. modify a claim, an row's content, a Confidence band, a topic page's prose, or a ledger state. Those require evidence judgment.

Case	Expected behavior
`.context/` missing	Refuse; suggest `ctx init`. No residue.
`.context/kb/` missing	Refuse; suggest `ctx init --upgrade`. No residue.
Kb scope undeclared	Refuse with the scope message. No residue.
Zero topic pages on disk	Walk closeouts and ledger anyway. Note the bootstrap state in the closeout. Not a failure mode.
Zero closeouts on disk	Walk topic pages and ledger anyway. Note in the closeout body. Not a failure mode.
`Confidence: High` (capitalization drift)	Coerce to `high` silently; record in `What changed`.
`Confidence: probable` (unknown band)	Flag for the user; do not coerce.
`Author: hand-authored`	Flag for the user; do not coerce (human intent matters).
Duplicate `EV-###` ID across files	Flag both files; defer renumbering to the LLM cleanup pass per spec's P1.
`EV-12` (missing zero-pad)	Flag for the user; do not auto-pad (cascades to citations).
Unresolved `EV-###` on a topic page	Flag; recommend `/ctx-kb-ingest <slug>` in `Next pass hint`.
Ledger row `Updated` predates source file mtime	Flag (lying-to-the-ledger advisory). Do not auto-edit.
Illegal ledger transition (e.g. `comprehensive → highlights-extracted` without `superseded`)	Flag; recommend the corrective ingest invocation. Do not auto-correct.
Closeout missing `pass-mode` frontmatter field	Flag; the handover-fold skips malformed closeouts so the user can fix or delete.
Closeout body's `Pass-mode` `Declared:` disagrees with frontmatter `pass-mode:`	Flag (false-finish signal); recommend hand-edit.
Closeout's `Adjacency pre-flight` is free prose instead of `none surfaced` or a slug-list	Flag; recommend hand-edit to structured form.
`CTX:KB:TOPICS` managed block drift	Recommend `ctx kb reindex` in `Next pass hint`; do not run the CLI from this skill.
`TBD-cite` on a page with Confidence above `speculative`	Flag; do not auto-demote (demotion is evidence work for `/ctx-kb-ingest`).
Sibling sub-page exists with no link from `index.md`	Flag; recommend hand-edit or `/ctx-kb-ingest <slug>` to extend.

ctx-kb-site-review

Install options

Review the source files

Site-Review Pass

When to Use

When NOT to Use

Authority Boundary (vs Other Skills)

Site-Review Pass

When to Use

When NOT to Use

Authority Boundary (vs Other Skills)

Usage Examples

Pre-Write Gates

Process

Edge Cases

Anti-Patterns

Output Contract

Quality Checklist

ctx-kb-site-review

Source facts

Install options

Review the source files

More from this repository

More from this repository

Site-Review Pass

When to Use

When NOT to Use

Authority Boundary (vs Other Skills)

Site-Review Pass

When to Use

When NOT to Use

Authority Boundary (vs Other Skills)

Usage Examples

Pre-Write Gates

Process

Edge Cases

Anti-Patterns

Output Contract

Quality Checklist