rag-eval

Run filesystem-based RAG benchmarks and output NVSkills metrics.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill rag-eval-sayalinvidia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rag-eval
Source: https://github.com/sayalinvidia/sayali-skills-test/tree/main/skills/rag-eval
Command: npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill rag-eval-sayalinvidia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured framework to evaluate the quality of filesystem-based RAG deployments by running controlled benchmarks against a corpus/ and train.json layout, enabling predictable comparison of retrieval and answer grounding.

Core Features & Use Cases

  • End-to-end RAG evaluation: assesses retrieval, grounding, and answer accuracy against ground-truth data.
  • Dataset-layout guidance: promotes a consistent corpus/ and train.json organization and conversion practices.
  • Operational workflow: guides users through data preparation, evaluation execution with uv and evaluate_rag.py, and results analysis with NVSkills metrics.

Quick Start

Prepare a corpus/ with PDFs or documents and a train.json at repo root, then run the evaluation against your RAG server to obtain NVSkills metrics.

Frequently Asked Questions about rag-eval

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

FAQPage Schema
How do I evaluate RAG retrieval quality and answer accuracy?

RAG evaluation benchmarks retrieval quality, context grounding, and answer correctness by running controlled tests against a RAG server using a standardized corpus/ and train.json dataset layout.

How do I benchmark a RAG deployment against a custom dataset?

To benchmark a RAG deployment, organize your documents in a corpus/ directory with a train.json file, provide the RAG server host and port, and run the evaluation to receive structured NVSkills metrics.

What data format is needed for RAG evaluation?

RAG evaluation requires a filesystem-based dataset organized with a corpus/ directory containing source documents and a train.json file holding ground-truth data for predictable comparison.

Can I use a custom judge model for RAG evaluation?

Yes, you can specify an optional RAG_EVAL_JUDGE_MODEL environment variable when running the evaluation to assess answer correctness and grounding against your ground-truth data.

What metrics do I get from RAG benchmarking?

RAG benchmarking provides structured NVSkills metrics and per-query data, enabling direct comparisons of retrieval quality, context grounding, and answer correctness across different configurations.

Does RAG evaluation work with PDF documents?

Yes, RAG evaluation supports PDFs and other documents placed in the corpus/ directory, allowing the benchmarking process to assess retrieval and answer accuracy against the ground-truth train.json.