darwinian-evolver

Optimizes LLM artifacts through evolutionary search against a user-defined fitness function.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill darwinian-evolver-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: darwinian-evolver
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/research/darwinian-evolver
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill darwinian-evolver-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, jinja2, pydantic, and includes scripts (resource) components.

What problem does it solve?

Darwinian Evolver helps you automatically improve an LLM-facing artifact—such as a prompt, regex, SQL query, or small code snippet—by running an evolutionary search loop guided by a fitness function.

Core Features & Use Cases

  • LLM-driven evolutionary optimization: Uses an upstream evolutionary search loop to propose and evaluate improved candidate artifacts.
  • Fitness-function based scoring: Optimizes against measurable signals like exact match, regex pass-rate, SQL correctness, unit tests, runtime metrics, or LLM-judge outputs.
  • Overfitting detection: Supports trainable vs holdout failure cases so improvements generalize instead of only matching the examples you expose.

Quick Start

Tell the skill to optimize your prompt by providing a starting prompt plus an evaluator that scores how closely outputs match your expected results for a small trainable set and a small holdout set.

Frequently Asked Questions about darwinian-evolver

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

FAQPage Schema
How do I optimize a prompt using an evolutionary search loop?

To optimize a prompt using an evolutionary search loop, provide a starting prompt and an evaluator that scores outputs against a trainable set and a holdout set. The LLM-driven loop iteratively proposes and evaluates improved candidate artifacts.

What is fitness function based LLM evaluation for artifact optimization?

Fitness function based LLM evaluation scores candidate artifacts against measurable signals like exact match, regex pass-rate, SQL correctness, unit tests, or LLM-judge outputs. This scoring guides the evolutionary search loop to iteratively improve the target artifact.

How can I detect overfitting when tuning SQL queries or regex automatically?

You detect overfitting when tuning SQL or regex by defining trainable and holdout failure cases within your evaluator. The evolutionary search loop checks improvements against both sets to ensure artifacts generalize instead of only matching exposed examples.

Do I need to install specific dependencies to run LLM-driven evolutionary optimization?

Yes, you need to install specific dependencies to run LLM-driven evolutionary optimization. The skill requires the openai, jinja2, and pydantic libraries, and operates by running the upstream darwinian_evolver via CLI or a subprocess driver.

Can I use an evolutionary search to improve small code snippets and unit tests?

Yes, you can use an evolutionary search to improve small code snippets and unit tests. The optimizer accepts small code as an LLM-facing artifact and uses your fitness function scoring, such as runtime metrics or pass/fail checks, to evaluate and mutate candidates.