evaluator-optimizer

Run iterative generator-evaluator-optimizer rounds with structured critique and best-of-N selection.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/thistleknot/skills --skill evaluator-optimizer-thistleknot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evaluator-optimizer
Source: https://github.com/thistleknot/skills/tree/main/evaluator-optimizer
Command: npx skills add https://github.com/thistleknot/skills --skill evaluator-optimizer-thistleknot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Evaluator-optimizer solves the problem of consistently improving output quality when a single LLM generation pass is not enough, by looping through generation, structured critique, and regeneration.

Core Features & Use Cases

  • Iterative generation with compound quality: run a generator–evaluator–optimizer loop that carries critique forward across rounds until quality meets a threshold.
  • MBR-style best-of-N selection: compare multiple candidates (parallel if needed), score them, and select the best using argmax or consensus voting.
  • Structured evaluator verdicts: require the evaluator to output a rubric-aligned score plus blocking issues that become direct optimizer context.
  • Judge capability guardrail: enforce that the evaluator/judge model is more capable than the model being evaluated to prevent self-assessment bias.

Quick Start

Use evaluator-optimizer to generate an answer, have a stronger judge model score it against a rubric, and regenerate with the evaluator’s blocking issues threaded into the next prompt until the acceptance threshold is reached.

Frequently Asked Questions about evaluator-optimizer

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

FAQPage Schema
How do I iteratively improve LLM output quality when a single generation pass is not enough?

Iteratively improve LLM output quality by running a generator-evaluator-optimizer loop that carries structured critique forward across rounds until a quality threshold is met. This loop applies to code, text, and plans where a rubric can score correctness.

What is the best way to select the highest quality LLM response from multiple candidates?

Use MBR-style best-of-N selection to compare multiple candidates, score them against a rubric, and select the best using argmax or consensus voting. This ensures the highest quality output is chosen from parallel generations.

How does an LLM judge evaluate generated text for accuracy and compliance?

An LLM judge evaluates generated text by outputting structured evaluator verdicts containing a rubric-aligned score and blocking issues. These issues become direct optimizer context for the next generation round.

Do I need a stronger judge model to evaluate LLM generation quality accurately?

Yes, you need a stronger judge model to evaluate LLM generation quality accurately. Enforcing a judge capability guardrail ensures the evaluator is more capable than the evaluated model, preventing self-assessment bias.

What are the limitations of using an optimization loop for LLM generation?

Limitations of using an optimization loop include requiring explicit stopping criteria and a max-rounds budget to prevent infinite cycles. Additionally, the evaluator must produce structured verdicts with actionable blocking issues for effective threading.

Can I use best-of-N selection for code generation and plan optimization?

Yes, you can use best-of-N selection for code generation and plan optimization. The evaluator-optimizer applies to any artifact where a rubric can score correctness, safety, accuracy, or compliance and best-of-N selection is needed.