skills.rest
shuff57
shuff57COMMUNITY
Explore all skills by this author →
GitHub

evolution

Analyze session metrics, classify divergences, and propose minimal agent changes.

Updated Mar 29, 2026
Search Tags:#data analysis#agent performance#agent evolution#safety rules#rollback mechanism
One-click install
npx skills add https://github.com/shuff57/agent-evo --skill evolution-shuff57
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: evolution
Source: https://github.com/shuff57/agent-evo/tree/main/skills/evolution
Command: npx skills add https://github.com/shuff57/agent-evo --skill evolution-shuff57

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates and optimizes the evolution of agents within the Claude Code framework, ensuring they remain efficient, relevant, and robust over time.

Core Features & Use Cases

  • Automated Evolution: Tracks and evaluates agent performance, automatically proposing improvements based on session metrics.
  • Data Collection & Analysis: Gathers and analyzes session data to identify areas for improvement, such as high rephrase rates, correction counts, and skill abandonment rates.
  • Divergence Classification: Categorizes identified issues into types like STALE, INCOMPLETE, MISLEADING, and more, using specific criteria.
  • Hypothesis Generation: Generates hypothesis based on observed signals and divergence types, detailing proposed changes and predicted outcomes.
  • Surgical Edit Protocol: Proposes and implements minimal changes to agent descriptions, skill configurations, and other elements, ensuring safety and model-agnosticity.
  • Prior Evolution Reconciliation: Reviews the effectiveness of past mutations, adjusting and refining the evolution protocol as needed.
  • Safety Rules & Rollback Awareness: Adheres to strict safety rules and provides a rollback mechanism for undoing changes, ensuring system integrity.
  • Use Case: When running agent/skill/routing/config evolution within Claude Code, load this skill to analyze session metrics and propose improvements.

Quick Start

Load the evolution skill during agent evolution to analyze session metrics and propose improvements.

Frequently Asked Questions about evolution

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

FAQPage Schema
How do I automate agent performance optimization using session metrics?▼

Agent performance optimization is automated by analyzing session metrics like rephrase rates and skill abandonment to classify divergences and generate hypotheses for minimal, safe configuration changes.

What is the best way to classify agent behavior divergences in Claude Code?▼

Classifying agent behavior divergences involves categorizing observed session issues into specific types such as STALE, INCOMPLETE, and MISLEADING based on tracked performance signals and correction counts.

How do I safely apply minimal changes to agent configurations?▼

Safely applying minimal changes requires a surgical edit protocol that proposes targeted adjustments to agent descriptions while adhering to strict safety rules and providing a rollback mechanism for system integrity.

Can I review and reconcile past agent evolution mutations?▼

Yes, past agent evolution mutations are reviewed through prior evolution reconciliation, which evaluates the effectiveness of previous changes and refines the ongoing evolution protocol based on outcomes.

When do I need to use a surgical edit protocol for agent evolution?▼

A surgical edit protocol is needed when proposing minimal, model-agnostic changes to agent descriptions and skill configurations to ensure system integrity and prevent unintended side effects during evolution.

Does agent evolution require a rollback mechanism for safety?▼

Yes, a rollback mechanism is required to undo applied changes and restore previous configurations, ensuring system integrity if proposed agent evolution mutations produce negative performance outcomes.

Related Skills

Explore More Software Engineering Skills→
mqzkimmqzkim

agent-debugger

Visualize execution flows, replay sessions, and detect loops in AI agent debugging.

Community
Advanced
TheCraigHewittTheCraigHewitt
7.3k

ab-test-setup

Plan A/B tests with hypotheses, sample sizes, and metrics documentation.

Community
Advanced
jac007xjac007x

skill-improver

Analyzes passive session signals to generate actionable improvement proposals for skill library health.

Community
Advanced
saschadudkin-sketchsaschadudkin-sketch

code-review

Automate code review for rezidence4/DomHub repository changes.

Community
Advanced