evolution-proposal

Converts audit anomaly entries into reviewable rule, skill, and plugin improvement proposals.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill evolution-proposal-ooooooooooooooooooop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evolution-proposal
Source: https://github.com/ooooooooooooooooooop/personal-ai/tree/main/skills/evolution-proposal
Command: npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill evolution-proposal-ooooooooooooooooooop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Audit scans of agent sessions surface recurring anti-patterns (polling loops, retry clusters, token hotspots, compaction storms), but without a controlled process these findings stay as raw inbox entries or get fixed ad hoc. This Skill turns those anomalies into evidence-backed, reviewable change proposals so improvements are analyzed systematically and never applied without approval. ## Core Features & Use Cases - Systematic Problem Analysis: Quantifies baselines from the evolution-inbox JSONL file, aggregates patterns by frequency and severity, classifies root causes (missing constraint, unenforced constraint, unenforceable constraint), and requires web research on known solutions before proposing anything. - Draft-Review-Approve Pipeline: Drafts minimal patches with a cheap model, runs local static prechecks (validate_repo, quality_report, dsh-config-sync), gets frontier-model review, then hands off to a human for approval. - Auditable Status Flow: Tracks inbox entries through new → processing → applied/rejected states and produces both an analysis summary and a proposal document with verification commands and rollback plans. - Use Case: After evolution_scan.js reports 26 polling anti-pattern entries out of 390 inbox items, use this Skill to aggregate the evidence, research event-driven alternatives, and produce a proposal to add a hard long-polling constraint to the supervision skill. ## Quick Start Process the new anomaly entries in my evolution-inbox and produce a reviewable improvement proposal with quantified evidence and root-cause analysis.

Frequently Asked Questions about evolution-proposal

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

FAQPage Schema
How do I turn agent audit findings into rule or skill improvements?

Feed the anomaly entries from your evolution-inbox into this Skill, which quantifies baselines, classifies root causes, drafts a minimal patch, and outputs a proposal document with verification commands. A human must approve before any change is applied.

How to fix recurring agent polling or retry anti-patterns permanently?

The Skill aggregates all related inbox entries, classifies whether the root cause is a missing constraint, an unenforced rule, or something unenforceable, then proposes a structural fix such as a hard check or system-level gate rather than a temporary workaround.

Can this Skill modify governance rules directly?

No. It only produces proposals and never applies changes itself. L0 governance rules in AGENTS.md can only be changed by a human-initiated process; the Skill at most suggests content for the user to decide on.

When should I not use the evolution proposal workflow?

Skip it for single-turn small fixes, which should go through minimal-implementation directly, and for everyday tasks with no evolution target. The full proposal pipeline is meant for recurring, evidence-backed problems only.

Why does the proposal require a web research comparison table?

The Skill mandates researching known solutions for the identified problem domain before drafting, so proposals borrow proven mechanisms instead of reinventing them. A proposal without a non-empty research comparison table is considered invalid.