rag-eval

Orchestrate filesystem-based RAG benchmarking with corpus/train.json and evaluate_rag.py.

Updated May 29, 2026
One-click install
npx skills add https://github.com/rblake2320/vigil --skill rag-eval-rblake2320
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rag-eval
Source: https://github.com/rblake2320/vigil/tree/main/.claude/skills/rag-eval
Command: npx skills add https://github.com/rblake2320/vigil --skill rag-eval-rblake2320

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Filesystem-based RAG benchmarks require a reproducible layout and a consistent evaluation workflow to measure retrieval quality and grounding in a realistic setting.

Core Features & Use Cases

  • Prepares and validates corpus/train.json layouts for RAGAS benchmarking.
  • Orchestrates evaluation with scripts/eval/evaluate_rag.py and provides guidance for result analysis.
  • Includes references and example workflows to triage errors and interpret metrics.

Quick Start

From the repository root, run the evaluation by invoking uv run --project scripts/eval python scripts/eval/evaluate_rag.py with your dataset-paths, host, and port to execute a RAGAS benchmark.

Frequently Asked Questions about rag-eval

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

FAQPage Schema
How do I benchmark RAG quality using a local filesystem dataset?

To benchmark RAG quality, you can structure your documents under a corpus/ directory and use a train.json file to run RAGAS evaluations. This validates your local dataset layout and measures retrieval and grounding metrics.

What is the best way to evaluate RAG retrieval and grounding accuracy?

Evaluating RAG retrieval and grounding accuracy is best done by orchestrating a RAGAS benchmark against your configured RAG stack. This measures how well your system retrieves relevant context and grounds responses in local datasets.

Do I need a configured RAG server to run RAGAS evaluations?

Yes, you need a configured RAG stack accessible at localhost:8081 or 8082. The evaluation script queries this server to measure retrieval quality, grounding, and efficiency metrics against your local datasets.

How do I run a RAGAS benchmark with Python and uv?

Run a RAGAS benchmark by executing uv run --project scripts/eval python scripts/eval/evaluate_rag.py from the repository root. You must provide your dataset paths, host, and port to generate quality metrics.

Can I use this to measure RAG efficiency across different ingestors?

Yes, you can measure RAG efficiency across different ingestors and local datasets. The evaluation workflow orchestrates benchmarking against your RAG server to compare ingestion strategies and retrieval performance.

Why are my RAG benchmark results inconsistent across local datasets?

Inconsistent RAG benchmark results often stem from unvalidated corpus/train.json layouts. Preparing and validating your filesystem-based dataset structure ensures a reproducible layout and consistent evaluation workflow.