Agent skill · research science · sickn33
clarity-gate
Pre-ingestion verification for epistemic quality in RAG systems. Ensures documents are properly qualified before entering knowledge bases. Produces CGD (Clarity-Gated Documents) and validates SOT (Source of Truth) files.
Why this skill is useful
Includes executable Python scripts for generating claim IDs and document hashes, enhancing document verification capabilities.
What it needs
Requires python installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Clarity Gate v2.1 Purpose: Pre-ingestion verification system that enforces epistemic quality before documents enter RAG knowledge bases. Produces Clarity-Gated Documents (CGD) compliant with the Clarity Gate Format Specification v2.1. Core Question: "If another LLM reads this document, will it mistake assumptions for facts?" Core Principle: "Detection finds what is; enforcement ensures what should be. In practice: find the missing uncertainty markers before they become confident hallucinations." --- Detailed Guide Read the detailed guide before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely. Critical Limitation Clarity Gate verifies FORM, not TRUTH. This skill checks whether claims are properly marked as uncertain—it cannot verify if claims are actually true. Risk: An LLM can hallucinate facts INTO a document, then "pass" Clarity Gate by adding source markers to false claims. Solution: HITL (Human-In-The-Loop) verification is MANDATORY before declaring PASS. --- When to Use Before ingesting documents into RAG systems Before sharing documents with other AI systems After writing specifications, state docs, or methodology descriptions When a document contains projections, estimates, or hypotheses Before publishing claims that haven't been validated When handing off documentation between LLM sessions --- What This Skill Does NOT Do Does not classify document types (use Stream Coding for that) Does not restructure documents Does not add deep links or references Does not evaluate writing quality Does not check factual accuracy autonomously (requires HITL) ---
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/clarity-gate--22dadb