darwin_skill

Overview

This skill is an ecosystem self-evolution orchestrator that senses project state, assesses agent fitness, and proposes targeted evolution actions. It integrates existing scores and agent journals to compute an Ecosystem Fitness Score (EFS) and per-agent Relevance Scores (RS). The skill aims to guide incremental improvements, surface sunset candidates, and persist ecosystem intelligence for continuous adaptation.

How this skill works

Darwin collects signals from git metrics, file structure, activity logs, agent journals, and existing scores to detect the project lifecycle and compute EFS. It evaluates each agent’s Relevance Score, runs trigger checks (ET-01…ET-08), and proposes evolution actions like affinity overrides, journal synthesis, discovery propagation, and sunset recommendations. All observations and actions are written to .agents/ECOSYSTEM.md for verification and trend tracking.

When to use it

• You need a holistic health check of an AI agent ecosystem
• You want prioritized proposals to improve agent collaboration or coverage
• You suspect agents are stale or should be retired
• A lifecycle phase shift may require routing or priority changes
• You need cross-agent patterns extracted from journals

Best practices

• Run full cycle regularly and after major repo changes to keep EFS current
• Prefer proposals over automatic changes; require Void confirmation before sunset
• Correlate RS changes with actual invocation data before acting
• Use confidence thresholds (≥0.60) to report single-phase lifecycle vs mixed state
• Limit simultaneous affinity overrides and ask stakeholders for large changes

Example use cases

• Run /Darwin to produce a DARWIN_REPORT showing phase, EFS, and evolution proposals
• Invoke /Darwin lifecycle after a release to confirm phase and trigger affinity updates
• Use /Darwin journals to synthesize reusable patterns from agent notes into Pattern Cards
• Trigger /Darwin staleness to identify dormant agents and flag sunset candidates for Void verification
• Run /Darwin fitness to produce a dimensioned EFS dashboard for stakeholder review