os-eval-runner

Score and gate skill-improvement iterations using Python evaluation scripts.

5|3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/richfrem/agent-plugins-skills --skill os-eval-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: os-eval-runner
Source: https://github.com/richfrem/agent-plugins-skills/tree/main/plugins/agent-agentic-os/skills/os-eval-runner
Command: npx skills add https://github.com/richfrem/agent-plugins-skills --skill os-eval-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Stateless evaluation engine that scores and gates skill improvement iterations using headless Python evaluation scripts. Use when the user says "evaluate this skill", "run autoresearch loop on", "optimize this skill", "run the eval loop", or when another agent proposes a change to an existing skill and needs empirical validation before applying it. Supports autonomous loop mode for iterative improvement and single-shot QA mode for validating one specific proposed change. Requires Python 3.8+ and a git repository.

Core Features & Use Cases

  • Pure metric producer: eval_runner.py reads a target and evals.json and emits objective scores without side effects.
  • Loop gate: evaluate.py enforces baseline, keeps or reverts changes, and appends results to the per-target ledger.
  • Scaffold templates: init_autoresearch.py deploys standard program/evals/results templates into your experiment.
  • Autonomous optimization: runs iterative mutations on a single-mutation target with KEEP/DISCARD decisions, or validates a specific change (QA mode).

Quick Start

Install and initialize an autoresearch experiment, then baseline the target with evaluate.py and start the loop.

Frequently Asked Questions about os-eval-runner

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

FAQPage Schema
How do I automate skill evaluation loops for autonomous optimization?

You can automate skill evaluation loops using headless Python scripts that score iterations and apply KEEP or DISCARD gating decisions. The engine reads a target directory and evals.json to emit objective metrics without side effects.

What is the best way to validate a proposed change to an existing skill?

Validating a proposed skill change is best done using single-shot QA mode, which empirically scores the specific mutation before applying it. The evaluation engine checks routing accuracy and structural heuristics against the baseline.

Do I need git and Python to run autonomous evaluation loops?

Yes, running autonomous evaluation loops requires git and Python 3.8 or higher. Git manages the repository for reverting discarded changes, while Python executes the evaluation and scoring scripts.

How does the evaluation gate decide whether to keep or revert skill improvements?

The evaluation gate decides to keep or revert skill improvements by scoring iterations against an enforced baseline. It evaluates routing accuracy, structural heuristics, and an F1 guard, then appends results to a per-target ledger.

Can I initialize standard templates for autoresearch experiments?

Yes, you can initialize standard templates for autoresearch experiments using a scaffold script. It deploys program, evals, and results templates into your experiment directory to structure the evaluation loop.

What limitations exist when running stateless skill evaluation?

Stateless skill evaluation is limited by its lack of side effects, meaning it only emits objective scores from evals.json without modifying the target. It requires a git repository to manage baseline enforcement and reverts for discarded iterations.