optimization-controller

Orchestrate multi-phase agent optimization loops with hypothesis generation and controlled experimentation.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mberto10/mberto-compound --skill optimization-controller
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimization-controller
Source: https://github.com/mberto10/mberto-compound/tree/main/plugins/agentic-optimization-loop/skills/optimization-controller
Command: npx skills add https://github.com/mberto10/mberto-compound --skill optimization-controller

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, langfuse, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured, automated process for iteratively improving the performance of AI agents by systematically identifying, hypothesizing, experimenting with, and analyzing changes to their configuration or prompts.

Core Features & Use Cases

  • 5-Phase Execution Loop: Guides the optimization process through Diagnose, Hypothesize, Experiment, Analyze, and Compound phases.
  • Lever Tuning: Manages the application of changes to specific agent parameters (levers) in single or multi-lever modes.
  • Strict Evaluation: Enforces preflight checks and strict guardrails to prevent regressions.
  • Use Case: An agent is underperforming on a specific metric. This Skill can automatically test different prompt variations or configuration settings, evaluate their impact, and decide whether to keep or rollback the changes, all within a controlled loop.

Quick Start

Use the optimization-controller skill to begin optimizing the 'article-writer' agent.

Frequently Asked Questions about optimization-controller

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

FAQPage Schema
How do I iteratively improve AI agent performance without causing regressions?

Iterative agent performance improvement requires a structured optimization loop that systematically diagnoses issues, tests hypotheses, and enforces strict evaluation guardrails before applying changes. This approach prevents regressions while tuning prompts or configuration parameters.

What is a multi-phase evaluation loop for agent optimization?

A multi-phase evaluation loop for agent optimization is an automated process that guides through Diagnose, Hypothesize, Experiment, Analyze, and Compound phases. It manages controlled experimentation and data-driven decision-making to systematically enhance agent capabilities.

How do I run controlled experimentation on LLM prompts and configuration settings?

Controlled experimentation on LLM prompts and configuration settings is managed through single or multi-lever tuning strategies. The process applies changes to specific agent parameters, evaluates their impact, and automatically decides whether to keep or rollback the modifications.

Do I need Langfuse to run automated agent tuning and evaluation?

You need Langfuse integration to run automated agent tuning and evaluation because the optimization process requires external evaluation infrastructure for metric collection and analysis. Langfuse serves as the dependency for persistent journal logging and data tracking.

What is the best way to test different prompt variations against specific metrics?

The best way to test different prompt variations against specific metrics is using a data-driven optimization loop with preflight checks. This method automatically evaluates the impact of each variation and rolls back changes that fail to meet strict performance guardrails.

When should I not use an automated optimization loop for my agents?

You should not use an automated optimization loop when you lack evaluation infrastructure for metric collection, or when your agent tuning requires unstructured ad-hoc changes rather than systematic, data-driven decision-making with persistent journal logging.