meta-debug

Diagnose consistency issues between prompt, ideal state, and rubrics to generate calibration_report.json.

6|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/slowman2084/meta-agent --skill meta-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: meta-debug
Source: https://github.com/slowman2084/meta-agent/tree/main/source/skills/meta-debug
Command: npx skills add https://github.com/slowman2084/meta-agent --skill meta-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects inconsistencies across an agent's prompt, ideal state, and evaluation rubrics to avoid wasted optimization cycles and ensure that automatic evaluation reflects true user value.

Core Features & Use Cases

  • Evidence-based per-case diagnostics: Extracts scores, dimension breakdowns, and judge comments from eval results and ties each diagnostic to concrete rubric, prompt, or testcase excerpts.
  • Cross-case pattern detection: Computes score distributions and identifies systemic issues such as consistently low dimensions, over-triggered negative criteria, and rubric coverage gaps.
  • Decision item generation for HCI review: Produces user-facing decisions (with skip option) and auto-applicable actions where safe, exporting a strict calibration_report.json consumable by the calibration viewer.
  • Use Cases: Initial calibration after agent creation, first-run validation before iterative tuning, and pre-release sanity checks for evaluation fairness.

Quick Start

Calibrate the agent 'cls-log-agent' by providing its prompt, ideal_state, testcases, evaluation results directory, and an output directory to generate calibration_report.json.

Frequently Asked Questions about meta-debug

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

FAQPage Schema
How do I diagnose inconsistencies between agent prompts and evaluation rubrics?

To diagnose evaluation inconsistencies, this Skill cross-references prompt definitions, ideal states, and rubric annotations to detect systemic issues and output a calibration_report.json. It extracts per-case evidence and computes score distributions to identify over-triggered negative criteria.

How do I generate a calibration report for agent testing sessions?

Generating a calibration report requires providing testcases, evaluation results, and rubric annotations to compute score distributions and cross-case patterns. The Skill processes these inputs to output a strict calibration_report.json containing structured diagnostics and user-facing decision items.

What is agent evaluation calibration and when do I need it?

Agent evaluation calibration is the process of validating that automatic evaluation reflects true user value by checking consistency across prompts, ideal states, and rubrics. You need it during initial agent creation, first-run validation, and pre-release sanity checks for evaluation fairness.

Can I use this diagnostic tool for multi-agent evaluation workflows?

This diagnostic tool is designed strictly for single-agent evaluation sessions with testcases, eval results, and rubric annotations. It computes per-case evidence and decision options specifically for individual agents rather than multi-agent orchestration workflows.

What file formats are needed to run agent evaluation diagnostics?

Running agent evaluation diagnostics requires evaluation markdowns, actual outputs, and rubric annotations as inputs. The Skill reads these formats to extract scores, dimension breakdowns, and judge comments, exporting results as a structured calibration_report.json.

Why does my agent evaluation produce inconsistent rubric scores?

Inconsistent rubric scores often stem from misalignment between the agent prompt, ideal state, and evaluation rubrics. This Skill detects these inconsistencies by computing score distributions and identifying systemic issues like over-triggered negative criteria or rubric coverage gaps.