eval

Compares AI agent answers across three knowledge-access levels and scores them.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/blueraai/bluera-knowledge --skill eval-blueraai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eval
Source: https://github.com/blueraai/bluera-knowledge/tree/main/skills/eval
Command: npx skills add https://github.com/blueraai/bluera-knowledge --skill eval-blueraai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill rigorously evaluates and compares the performance of AI agents in answering questions, specifically highlighting the impact of different levels of access to a local knowledge base (BK).

Core Features & Use Cases

  • Comparative Analysis: Runs three agents in parallel: one with no BK access, one with file system access (grep/read/glob), and one with full BK vector search and file system access.
  • Scoring Rubric: Assesses answers based on accuracy, specificity, completeness, and source grounding.
  • Use Case: You want to understand how much value Bluera Knowledge adds to your AI agent. You can use this skill to run a set of predefined questions and see quantifiable improvements in answer quality and token usage when BK is enabled.

Quick Start

Run an evaluation of agent quality for the query "How does Express handle errors?".

Frequently Asked Questions about eval

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

FAQPage Schema
How do I benchmark agent performance with and without a knowledge base?

To benchmark agent performance with and without a knowledge base, you run a comparative evaluation across three modes: no knowledge base access, file system access only, and full vector search access. This provides detailed scoring on accuracy and token usage.

What metrics are used for evaluating AI agent quality?

Evaluating AI agent quality uses a scoring rubric that measures accuracy, specificity, completeness, and source grounding. It also tracks performance metrics including token usage and duration to quantify improvements.

How do I test the impact of vector search on my AI agent's answers?

You test the impact of vector search by running predefined or arbitrary queries through parallel agents with differing access levels. Comparing the outputs reveals quantifiable improvements in answer quality when full knowledge base search is enabled.

Can I evaluate agent responses using only file system access?

Yes, you can evaluate agent responses using only file system access. The comparative analysis runs one agent specifically with grep, read, and glob commands to see how it performs against both no access and full vector search modes.

What is the best way to compare AI agents across different knowledge base modes?

The best way to compare AI agents across different knowledge base modes is to run them in parallel on identical queries and assess the results using a standardized rubric for accuracy, specificity, completeness, and source grounding.