rag-audit

Validate RAG retrieval accuracy and refusal logic with Docker-based acceptance tests.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/MikkoNumminen/mikkonumminen.dev --skill rag-audit-mikkonumminen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rag-audit
Source: https://github.com/MikkoNumminen/mikkonumminen.dev/tree/main/.claude/skills/rag-audit
Command: npx skills add https://github.com/MikkoNumminen/mikkonumminen.dev --skill rag-audit-mikkonumminen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the inconsistency and manual overhead of auditing RAG (Retrieval-Augmented Generation) systems by providing a standardized, adversarial battery of tests to ensure retrieval accuracy and gate integrity.

Core Features & Use Cases

  • Acceptance Testing: Validates the RAG system against a strict 9/9 acceptance contract to prevent regressions.
  • Adversarial Auditing: Includes specific test cases for containment leaks, generative task gates, and translation task gates to ensure the model refuses out-of-scope queries.
  • Performance Evaluation: Measures dense vs. hybrid retrieval hit-rates to optimize search quality.
  • Use Case: Use this before merging any RAG-related pull request to verify that changes to chunking, prompts, or retrieval logic do not introduce leaks or over-gating.

Quick Start

Run the rag-audit skill to execute the full acceptance battery and validate the current RAG backend against the local development environment.

Frequently Asked Questions about rag-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate acceptance testing for my RAG system?▼

RAG validation uses automated acceptance testing and adversarial query batteries to verify retrieval accuracy, gate integrity, and refusal logic against a strict 9/9 contract to prevent regressions.

What is gate integrity in retrieval-augmented generation systems?▼

Gate integrity in retrieval-augmented generation ensures the model refuses out-of-scope queries, preventing containment leaks and blocking unauthorized generative or translation tasks through adversarial auditing.

Do I need Docker and Python to run RAG validation scripts?▼

Yes, RAG validation requires Docker and Python-based evaluation scripts to verify hit-rates and refusal logic against the local corpus within a containerized backend environment.

When should I run an adversarial audit on my RAG backend?▼

Run an adversarial RAG audit before merging any pull request to verify that changes to chunking, prompts, or retrieval logic do not introduce containment leaks or over-gating.

How do I measure dense vs hybrid retrieval hit-rates for search quality?▼

Measure dense vs hybrid retrieval hit-rates by executing Python evaluation scripts within a containerized backend, comparing search quality and accuracy directly against your local development corpus.

What are the limitations of automated RAG acceptance testing?▼

Automated RAG acceptance testing is limited to verifying hit-rates and refusal logic against a local corpus, requiring a containerized Docker backend and Python scripts to execute the validation battery.