Agent skill

Clarity Gate

by sickn33 in sickn33/agentic-awesome-skills

Pre-ingestion verification for epistemic quality in RAG systems.

CC-BY-4.0Auto-check passedKnowledge Management

Install Clarity Gate

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill clarity-gate -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills clarity-gate --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/clarity-gate .claude/skills/clarity-gate && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clarity-gate
GitHub stars
47k
Used in
3 other repos
Token cost
~709 tokens
SKILL.md length
247 words
Files
2 (incl. references)
Skills in repo
1,497
Repo updated
First seen
Licence
CC-BY-4.0

At a glance

Pre-ingestion verification for epistemic quality in RAG systems.

  • Tasks that involve Knowledge bases
  • SKILL.md covers Detailed Guide, Critical Limitation, When to Use and What This Skill Does NOT Do
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Retrieval-augmented generation

What it does

Clarity Gate is an agent skill from sickn33/agentic-awesome-skills. 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.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/detailed-guide.md`).

It sits in Knowledge Management, covering Knowledge bases and Retrieval-augmented generation. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is CC-BY-4.0.

When your agent uses it

  • Tasks that involve Knowledge bases
  • Tasks that involve Retrieval-augmented generation

Example prompts

  • “/clarity-gate”

What it can do on your machine

Read from SKILL.md and the folder at commit b84d35a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clarity Gate loads about 709 tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 247 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~709
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit b84d35a, republished under its CC-BY-4.0 licence (© sickn33). 247 words, ~709 tokens.

Download SKILL.mdSave it as .claude/skills/clarity-gate/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
clarity-gate
description
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.
risk
critical
source
community
date_added
2026-09-04
version
2.1.3
author
Francesco Marinoni Moretto
license
CC-BY-4.0
repository
https://github.com/frmoretto/clarity-gate
triggers
clarity gate, check for hallucination risks, can an LLM read this safely, review for equivocation, verify document clarity, pre-ingestion check, cgd verify…
capabilities
document-verification, epistemic-quality, rag-preparation, cgd-generation, sot-validation
spec_version
2.1

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)

© sickn33, CC-BY-4.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/clarity-gate of sickn33/agentic-awesome-skills.

  • SKILL.md
  • references/detailed-guide.md

Open the folder on GitHubat commit b84d35a

Used in 3 other repositories

We found 12 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 9, 2026.

Compare with similar skills

Clarity Gate next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clarity Gate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clarity Gate this skillsickn33/agentic-awesome-skills47k3 repos~709Automated safety check: PassCC-BY-4.0
Knowledgebaseopen-edge-platform/edge-ai-suites140—~900Automated safety check: PassApache-2.0
Openloomimelandlabs/openloomi1k—~835Automated safety check: PassApache-2.0
AutoRAG LibrarianMarker-Inc-Korea/AutoRAG5.1k—~2.1kAutomated safety check: PassMIT
LLM Wikipraneybehl/llm-wiki-plugin118—~5.7kAutomated safety check: PassMIT
Obsidian Wiki QueryAgriciDaniel/claude-obsidian15k—~1.2kAutomated safety check: PassMIT

Similar skills

  • Knowledgebase

    open-edge-platform/edge-ai-suites

    Generic RAG query skill - Retrieve any information from the local knowledge base and generate structured reports, summaries, or Q&A responses.

    140 GitHub stars~900 tokensUpdated yesterday
    Knowledge ManagementAuto-check passed
  • Openloomi

    melandlabs/openloomi

    OpenLoomi entrypoint for skill-only agent runtimes without a plugin mechanism.

    1k GitHub stars~835 tokensUpdated 17 days ago
    Knowledge ManagementAuto-check passed
  • AutoRAG Librarian

    Marker-Inc-Korea/AutoRAG

    Searches, summarizes, compares and answers questions from an already configured AutoRAG librarian agent over local documents and authorized datasources.

    5.1k GitHub stars~2.1k tokensUpdated today
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    praneybehl/llm-wiki-plugin

    Build and maintain an LLM-curated knowledge base from papers, articles, transcripts, notes and project findings.

    118 GitHub stars~5.7k tokensUpdated 28 days ago
    Knowledge ManagementAuto-check passed
  • Obsidian Wiki Query

    AgriciDaniel/claude-obsidian

    Answers a question strictly from a chosen Obsidian vault at quick, standard or deep depth, using a verified retrieval index when available and never changing vault files.

    15k GitHub stars~1.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Vault Contextual Retrieval

    AgriciDaniel/claude-obsidian

    Builds and queries a local contextual BM25 index over an Obsidian vault, with optional Nomic reranking through Ollama and strict consent rules before any text leaves the machine.

    15k GitHub stars~1.4k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,497 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Clarity Gate

What does Clarity Gate do?

Pre-ingestion verification for epistemic quality in RAG systems. Clarity Gate is an agent skill from sickn33/agentic-awesome-skills. Pre-ingestion verification for epistemic quality in RAG systems.

When should I use Clarity Gate?

Clarity Gate fits situations like: tasks that involve Knowledge bases; tasks that involve Retrieval-augmented generation.

How do I install Clarity Gate in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill clarity-gate -a claude-code`. Or copy the skill folder (skills/clarity-gate in sickn33/agentic-awesome-skills) into .claude/skills/clarity-gate in your project. Claude Code loads it when a task matches its description.

How do I install Clarity Gate in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill clarity-gate -a codex`. Or copy the skill folder (skills/clarity-gate in sickn33/agentic-awesome-skills) into .agents/skills/clarity-gate in your project. Codex loads it when a task matches its description.

Can I use Clarity Gate in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill clarity-gate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clarity-gate, .gemini/skills/clarity-gate, .github/skills/clarity-gate and .opencode/skills/clarity-gate in your project.

What does Clarity Gate need to run?

SKILL.md names no scripts, command-line tools or credentials: Clarity Gate is instructions for the agent only.

Does Clarity Gate access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clarity Gate safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clarity Gate use?

Clarity Gate is published under the CC-BY-4.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Clarity Gate use?

About 709 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.7k tokens, read only when the agent opens those files.

What are the alternatives to Clarity Gate?

Skills that share tags, products or a category with Clarity Gate: Knowledgebase (open-edge-platform/edge-ai-suites, 140 stars), Openloomi (melandlabs/openloomi, 1k stars), AutoRAG Librarian (Marker-Inc-Korea/AutoRAG, 5.1k stars) and LLM Wiki (praneybehl/llm-wiki-plugin, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clarity Gate?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,405 GitHub stars. The repository holds 1,497 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.