evolution

Diagnoses, benchmarks, and improves SKILL.md skill files through automated evolution cycles.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill evolution-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolution
Source: https://github.com/yakeworld/Synthos/tree/main/skills/private/extended/meta/evolution
Command: npx skills add https://github.com/yakeworld/Synthos --skill evolution-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Maintaining a large library of SKILL.md skill files manually leads to structural drift, stale metadata, missing I/O contracts, and unverified quality claims. This Skill runs a self-evolution engine that continuously probes, benchmarks, diagnoses, and patches the skill tree while keeping every change auditable in Git. ## Core Features & Use Cases - Eight-dimension diagnosis: Scores structural integrity, benchmark coverage, constitutional compliance, content quality, reference coverage, absorption potential, gene-layer liveness, and behavioral execution traces via diagnose.py. - Automated improvement loops: auto-loop.py runs unattended multi-cycle evolution with hard convergence guardrails (edit budgets, rejected buffers, burnout protection) and Git-as-memory commits per cycle. - External absorption pipeline: Searches GitHub, Hermes skills, and papers for complementary projects, scores them on five dimensions, and generates approval-gated absorption proposals with methodology extraction. - Use Case: A research agent system with 150+ SKILL.md files runs a nightly evolution cycle that detects 12 skills missing IO_CONTRACT sections, batch-injects them, re-runs benchmarks, commits the changes, and logs the score delta from 0.86 to 0.95. ## Quick Start Run the evolution engine to diagnose all skills, fix structural issues, and record the results in evolution-state.json and evolution-log.md.

Frequently Asked Questions about evolution

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

FAQPage Schema
How do I run an automated skill evolution cycle?

Run python3 scripts/auto-loop.py from the evolution skill directory to start unattended multi-cycle evolution. It checks score and health thresholds, selects the highest-ROI improvement dimension, batch-edits SKILL.md files, commits to Git, and recurses until stop conditions trigger.

How is skill quality scored in the evolution engine?

Quality uses an eight-dimension weighted formula: structural, benchmark, constitutional, optimize, coverage, absorption, liveness, and behavior. Each dimension is computed independently by diagnose.py from actual file analysis, never reused from previous state values.

Can the evolution engine modify core skill logic automatically?

No. The engine only patches structural issues like missing frontmatter fields, IO contracts, and verification checklists. Atom core logic, I/O contract changes, new atom creation, and file deletion are reserved for human decisions per the boundary definition.

Why does the benchmark score differ from evolution-state.json?

State files can retain stale or inflated scores from declarative updates without re-measurement. The engine requires recomputing all sub-scores from scratch each cycle, and flags discrepancies over 5 percent as self-inflation traps.

What are the limitations of unattended auto-loop evolution?

Auto-loop stops when score drops below 0.85, status degrades, rejected proposals exist, or 20 consecutive healthy cycles trigger burnout protection. Cron mode also cannot use interactive tools requiring user approval or TTY-based CLIs.