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.
Profile →npx skills add sickn33/agentic-awesome-skills --skill clarity-gate --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
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.
How it works
The skill evaluates documents for epistemic markers and hedges to determine if claims are properly qualified. It generates a Clarity-Gated Document (CGD) in the .cgd.md format and applies a validation framework with codes like W-HC01, W-HC02, E-SC06, E-ST10, and W-ST11. It bundles helper scripts claim_id.py and document_hash.py to compute deterministic IDs and document hashes, and instructs the agent to structure CGD content according to the CLARITY_GATE_FORMAT_SPEC.md v2.1. The implementation includes a YAML frontmatter portion with fields such as clarity-gate-version, processed-date, processed-by, clarity-status, hitl-status, hitl-pending-count, points-passed, hitl-claims, and a final HTML end marker with Clarity Gate status. The provided scripts illustrate how to compute a stable claim ID and a SHA-256 hash for the CGD.
When to use it
- Before ingesting documents into RAG systems
- Before sharing documents with other AI systems
- When evaluating documents with projections, estimates, or hypotheses
- Prior to publishing claims that have not been validated
- When handing off documentation between LLM sessions
What it can touch
- The CGD file produced (.cgd.md) and the CGD format specification docs referenced in the skill
- Bundled scripts: scripts/claim_id.py and scripts/document_hash.py
Caveats
- Risk level declared as critical; it verifies FORM, not TRUTH
- HITL verification is mandatory to pass; the system flags potential issues but does not guarantee truth
- It enforces presence of uncertainty markers but cannot verify factual correctness
# 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."* --- ## What's New in v2.1 | Feature | Description | |---------|-------------| | **Claim Completion Status** | PENDING/VERIFIED determined by field presence (no explicit status field) | | **Source Field Semantics** | Actionable source (PENDING) vs. what-was-found (VERIFIED) | | **Claim ID Format Guidance** | Hash-based IDs preferred, collision analysis for scale | | **Body Structure Requirements** | HITL Verification Record section mandatory when claims exist | | **New Validation Codes** | E-ST10, W-ST11, W-HC01, W-HC02, E-SC06 (FORMAT_SPEC); E-TB01-07 (SOT validation) | | **Bundled Scripts** | `claim_id.py` and `document_hash.py` for deterministic computations | --- ## Speci
- What's New in v2.1
- Specifications
- Validation Codes
- HITL Claim Validation (§1.3.2-1.3.3)
- Body Structure (§1.2.1)
- SOT Table Validation (§3.1)
- Bundled Scripts
- scripts/claimid.py
- scripts/documenthash.py
- The Key Distinction
- Critical Limitation
- When to Use
- The 9 Verification Points
- Relationship to Spec Suite
Generate claim ID python scripts/claim_id.py "Base price is $99/mo" "api-pricing/1" Run test vectors python scripts/claim_id.py --test Compute hash python scripts/document_hash.py my-doc.cgd.md Verify existing hash python scripts/document_hash.py --verify my-doc.cgd.md Run normalization tests python scripts/document_hash.py --test
What does the clarity-gate skill do?
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.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill clarity-gate --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.