tao-judge

Score goal-state pairs and output a JudgeVerdict with done status and next_action_hint.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill tao-judge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tao-judge
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/tao-judge
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill tao-judge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns subjective “goal achieved” judgments into a repeatable, measurable termination decision for an agent loop, preventing wasted iterations and stalled runs.

Core Features & Use Cases

  • Goal-state termination gating: Scores a goal-state pair into a single scalar and decides whether the loop should stop.
  • Structured verdict output: Returns a JudgeVerdict with done, reason, score (0..1), and a next_action_hint to guide continuation.
  • Autoresearch-aligned scoring: Uses the score as the primary scalar and terminates only when the evaluator explicitly reports GOAL_MET.
  • Operational checkpoint & one-shot evaluation: Supports being called at a judge-checkpoint after worker steps or as a one-shot scoring pass without running the full loop.

Quick Start

Ask your agent system to call tao-judge as a goal-completion evaluator at each judge-checkpoint to decide when to stop or continue the TAO loop.

Frequently Asked Questions about tao-judge

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

FAQPage Schema
How do I stop an autonomous agent loop when a goal is met?▼

To stop an autonomous agent loop when a goal is met, you apply a termination gating mechanism that scores the goal-state pair and returns a structured verdict with a done status. This prevents wasted iterations by only terminating when the evaluator explicitly reports the goal is met.

What is termination gating in agent orchestration?▼

Termination gating in agent orchestration is the process of evaluating whether an autonomous agent has sufficiently completed a specified goal. It scores the current workspace state into a measurable 0..1 scalar to decide whether the iterative worker loop should stop or continue.

How do I score autonomous agent performance during a TAO run?▼

You score autonomous agent performance during a TAO run by applying an evaluator to score the goal-state pair at judge-checkpoints. This produces a measurable 0..1 score and a next_action_hint based on evaluator reasoning to guide continuation.

Can I evaluate the current workspace state without running the full agent loop?▼

Yes, you can evaluate the current workspace state without running the full agent loop by performing a one-shot evaluation pass. This allows you to score the goal-state pair independently of the iterative worker steps.

How do I prevent wasted iterations in an autonomous agent worker loop?▼

You prevent wasted iterations in an autonomous agent worker loop by using a structured JudgeVerdict to gate termination. The evaluator returns a done status, a score, and a next_action_hint, ensuring the loop only stops when the goal is explicitly met.