clarity-gate
by frmoretto
Search & ResearchBrief
Pre-ingestion verification for epistemic quality in RAG systems.
Description
What This Skill Does
Pre-ingestion verification system for RAG knowledge bases. Checks documents for missing uncertainty markers, unhedged claims, and implicit assumptions before they enter AI knowledge stores. Produces Clarity-Gated Documents (CGD) with a structured HITL verification record and validation error codes.
Unlike detection tools that find hedges already present in text, it flags where uncertainty markers are absent but required, catching hallucination risks at their source before documents enter knowledge bases.
When to Use It
- Checking a product spec before loading it into a RAG pipeline
- Flagging unverified revenue projections in a planning document
- Reviewing methodology docs for assumptions stated as facts
- Validating a Source of Truth file before sharing across AI sessions
- Auditing technical reports with specific statistics or competitor claims before publishing
Example Workflow
User asks: Verify this API pricing doc before we ingest it into our knowledge base
- 1
Run 9-point epistemic check across all claims in the document
- 2
Flag critical issues where forward-looking statements lack uncertainty markers
- 3
Identify externally verifiable claims such as pricing figures and statistics for HITL routing
- 4
Produce CGD frontmatter with clarity-status, hitl-pending-count, and per-claim records
- 5
Present Round A and Round B verification requests for human confirmation
A .cgd.md file with clarity-status: PENDING, a structured hitl-claims list, and a verification report categorized by Critical, Warning, Temporal, and Verifiable issues
Installation
clawhub install frmoretto/clarity-gateRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.