optimize-anything

Design and run GEPA-based optimization loops for text artifacts.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/PoeAudits/yield-farming-gepa-example --skill optimize-anything-poeaudits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: optimize-anything
Source: https://github.com/PoeAudits/yield-farming-gepa-example/tree/main/skills/optimize-anything
Command: npx skills add https://github.com/PoeAudits/yield-farming-gepa-example --skill optimize-anything-poeaudits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill supports designing, running, and operationalizing optimization workflows for text artifacts using the GEPA optimize_anything API and the local optimize_anything Python library. It guides structuring artifacts as named sections, defining deterministic evaluators, configuring budgets, and managing transfer/generalization checks to avoid overfitting. It keeps decisions local to the workflow while pointing to deeper API guidance in the references directory for edge-case patterns and advanced configurations.

Core Features & Use Cases

  • Represent artifacts as named, semantically meaningful sections (e.g., "system_prompt", "policy", "format_rules") to preserve structure and enable targeted reflection.
  • Define an evaluator contract and ASI schema before spending budget, ensuring deterministic scoring and actionable diagnostics.
  • Run iterative optimization with a seed_candidate, dataset, optional valset, objective, and a GEPAConfig composed from EngineConfig and ReflectionConfig (plus optional MergeConfig, RefinerConfig, and TrackingConfig).
  • Support single-task, multi-task, and generalization workflows, including seedless modes and public preset factories, with emphasis on transfer-safe improvements.
  • Consult the provided references for API patterns, evaluator templates, and ASI payload design to extend implementations.

Quick Start

Provide a seed_candidate and evaluator, set up a dataset and objective, and run the optimizer with a preset.

Frequently Asked Questions about optimize-anything

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

FAQPage Schema
How do I optimize text artifacts using GEPA without overfitting to the evaluation dataset?

To optimize text artifacts without overfitting, you can use GEPA-based optimization loops with a dedicated validation set and transfer-aware evaluation strategies. Defining an evaluator contract and dataset alignment before spending budget helps ensure improvements are transfer-safe.

What is a seed_candidate in a GEPA optimization workflow?

A seed_candidate is the initial text artifact input required to start iterative optimization in a GEPA workflow. It should be formatted as named, semantically meaningful sections like system_prompt or format_rules to preserve structure and enable targeted reflection.

How do I structure an evaluator contract for text artifact optimization?

You structure an evaluator contract by defining an ASI schema and deterministic scoring logic before running the optimizer. This ensures the evaluator provides actionable diagnostics and consistent scoring across the dataset during the iterative optimization loop.

Can I run multi-task text artifact optimization with a single GEPA configuration?

Yes, you can run single-task, multi-task, and generalization workflows using a GEPAConfig composed from EngineConfig and ReflectionConfig. The configuration supports optional components like MergeConfig and RefinerConfig to handle complex multi-task optimization scenarios.

Do I need a validation set to run a GEPA optimization loop?

A validation set is optional but recommended for transfer-safe improvements during text artifact optimization. While you can run the optimizer with just a seed_candidate, dataset, and objective, providing a valset helps manage generalization checks and avoid overfitting.

What configurations are available for GEPA optimization beyond the default engine settings?

Beyond default engine settings, GEPA optimization supports optional MergeConfig, RefinerConfig, and TrackingConfig components. You can also use public preset factories and seedless modes, with deeper API patterns available in the references directory for advanced configurations.