evolution-engine

Analyzes accumulated feedback to propose rule graduations, skill optimizations, and new skills.

Updated Jun 29, 2026
One-click install
npx skills add https://github.com/iJosueeh/amauta --skill evolution-engine-ijosueeh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: evolution-engine
Source: https://github.com/iJosueeh/amauta/tree/main/.opencode/skills/evolution-engine
Command: npx skills add https://github.com/iJosueeh/amauta --skill evolution-engine-ijosueeh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It turns scattered feedback entries and execution traces into structured, data-backed improvement proposals for an agent's rules and skills, preventing premature or unsupported changes. ## Core Features & Use Cases - Signal Detection: Scans feedback files and forge-loop step traces to detect rule graduation candidates (3+ occurrences), skill optimization signals (low repeated scores), and new skill candidates (5+ uncovered patterns). - TDD-Style Proposals: Every proposal includes a RED observation, GREEN change, predicted effect, and a falsifiable verify-by criterion, with failure-class routing (skill-defect vs execution-lapse). - Quality Gates: Applies an 8-dimension scoring rubric, anti-rationalization checklist, and denominator awareness to filter out noise before presenting proposals. - Use Case: After several sessions accumulate feedback about a recurring agent mistake, run this skill to receive a structured proposal specifying the exact SKILL.md section to change and how to verify the fix. ## Quick Start Ask the agent to check if there are any rules to upgrade based on the accumulated feedback.

Frequently Asked Questions about evolution-engine

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

FAQPage Schema
How do I turn repeated agent feedback into permanent rules?▼

Run the evolution-engine skill, which scans the feedback directory for patterns occurring three or more times and generates rule graduation proposals. Each proposal specifies the exact target file and section, and is applied only after user confirmation.

How to detect when an agent skill needs optimization?▼

The skill groups feedback scores by source skill and triggers when a dimension scores 2 or lower three consecutive times, or the average over the last five entries falls to 3 or below. It also checks total usage counts to avoid acting on statistically insignificant samples.

What is the minimum feedback needed before proposing a rule change?▼

At least three feedback entries supporting the same pattern are required. A single entry is treated as an anecdote, not a signal, to prevent bloating rule files with one-off issues.

Does the evolution engine create new skills automatically?▼

No, it only proposes new skills when a pattern occurs five or more times without coverage by existing skills. Actual creation is delegated to the skill-builder skill after user confirmation.

Why was my evolution proposal rejected or not shown?▼

Proposals missing a RED observation or a verify-by criterion are dropped as incomplete signals. The skill also filters out false correlations by cross-referencing task history before presenting anything.