tune

Run automated chunk-size sweeps and report nDCG, MRR, and Hit@5 metrics.

27|9|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/nicholasglazer/gnosis-mcp --skill tune-nicholasglazer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tune
Source: https://github.com/nicholasglazer/gnosis-mcp/tree/main/skills/tune
Command: npx skills add https://github.com/nicholasglazer/gnosis-mcp --skill tune-nicholasglazer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Chunking and retrieval configuration determine search quality; this skill helps you measure and optimize chunk size, embedding, and reranker settings against your corpus.

Core Features & Use Cases

  • Automated chunk-size sweeps across a corpus to identify the best balance of context and latency.
  • Ingest-based evaluation using a golden-query set, with reporting of nDCG, MRR, and Hit@5 for informed configuration.
  • Use Case: you’ve ingested a new corpus and want to adapt chunking, embedding, and reranking parameters to maximize search quality.

Quick Start

Run a default sweep to compare chunk sizes and retrieve settings for your corpus.

Frequently Asked Questions about tune

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

FAQPage Schema
How do I tune chunking and retrieval settings to improve search quality?

To tune chunking and retrieval settings, you can run automated sweeps across your corpus to compare different chunk sizes, ingestion states, and modes. The skill evaluates configurations using a golden-query set and reports nDCG, MRR, and Hit@5 metrics to identify optimal parameters.

What is a golden-query set and do I need it to evaluate chunk size?

A golden-query set is a benchmark dataset used to evaluate retrieval accuracy. You need it to perform ingest-based evaluation, as the skill uses this set to measure and report metrics like nDCG, MRR, and Hit@5, guiding your chunking configuration decisions.

How do I find the best chunk size for my corpus?

You can find the best chunk size for your corpus by running an automated chunk-size sweep. This process tests various configurations across your corpus to identify the optimal balance of context and latency, measuring search quality with nDCG, MRR, and Hit@5 metrics.

Can I evaluate embedding and reranker parameters against my own corpus?

Yes, you can evaluate embedding and reranker parameters against your own corpus. The skill applies automated sweeps across different ingestion states and modes, using benchmarks to maximize search quality and guide your configuration decisions.

What metrics are used for evaluating retrieval quality during chunking sweeps?

The metrics used for evaluating retrieval quality during chunking sweeps are nDCG, MRR, and Hit@5. These metrics are reported after running automated sweeps against a golden-query set to help you measure and optimize corpus search performance.

Are there limitations to tuning retrieval configuration with automated sweeps?

The main limitation is that automated sweeps require a prepared golden-query set and enforce specific prerequisites before execution. You must have your corpus ingested and a benchmark dataset ready to measure nDCG, MRR, and Hit@5 metrics effectively.