SKILL
evolution-agent✓ APPROVED

Turn feedback and outcomes into proposed skill fixes you approve.

Reads QA findings, feedback, and outcomes, then proposes concrete changes to your skills and scoring. You approve, nothing self-edits.

Inside: The feedback streams, the four change types, and an approval gate on every merge.

01 / HOW TO USE

Install it in one line, or paste it in.

1
In Claude Code (one command)
Copy the install line, paste it into your terminal, and restart Claude Code. The skill installs itself to ~/.claude/skills/ and runs automatically when it is relevant.
2
In Claude, ChatGPT, or a Project (no terminal)
Open the file, then upload it to your chat or paste its contents in. A skill is just a markdown file of instructions, so any capable AI can follow it.
New to skills? A skill is a plain-text file that teaches your AI a workflow. Point any capable assistant at it and it follows the steps, on your data.
02 / MAKE IT YOURS

Connect your context. Set it to your motion.

CONNECT YOUR CONTEXT · AND WHY IT HELPS
your feedback log

it reads reactions, click-through, and re-asks automatically instead of you summarizing them.

outcome data

cross-references what a skill predicted against what actually happened (did the AT_RISK deals slip, did the high-fit accounts convert).

a version-control connector

writes each proposed change as a reviewable diff you can approve in one click.

SET IT TO YOUR MOTION

This was built to evolve a suite of GTM skills. Set these to your stack:

Set thisWhat it isDefault / Example
FEEDBACK SOURCESwhere signal comes fromthumbs up/downreactionsclick-throughwritten notes
OUTCOME SOURCEhow you attribute resultsCRM outcomeswin/lossrenewal result
SKILL LIBRARYwhat it proposes changes toyour SKILL.md filesscoring rubricsworkflow specs
APPROVAL GATEwho signs offyoualways; nothing auto-merges
RETIRE_DAYSunused window before a deprecation proposal90
ACCURACY_FLOORprecision below which a skill gets flagged75%
03 / THE FULL SKILL

Everything the skill does, in full.

WHAT THIS DOES

Turns the signals your system is already producing (quality-check findings, feedback reactions, and real outcomes) into a short list of concrete proposed changes to your own skills, scores, and workflows. Each one arrives as a reviewable proposal with the data behind it. You approve; the system updates. It never edits itself. This is the layer that makes a library of skills improve over time instead of drifting.

THE METHOD
  1. 1
    Read both feedback streams

    Implicit signals (reactions, click-through, re-asks, outcome attribution) and explicit signals (thumbs plus structured reasons). Neither alone is enough. A single thumbs-down is noise; the same pattern across both streams is a signal worth acting on.

  2. 2
    Attribute outcomes honestly

    Cross-reference each skill's predictions to what actually happened, controlling for cohort confounds (window size, segment mix, sample size). Never claim a lift without accounting for what else moved. Small samples lie, and a self-improving system that believes its own inflated numbers gets worse, not better.

  3. 3
    Propose, never merge

    Every change ships as a reviewable proposal with a diff and a rationale tied to data. Four kinds:

    • Tighten a rubric: when two tiers converge on the same outcome, collapse or re-cut them.
    • Update a trigger or definition: when language in the field has shifted (a new tool named in calls, a new phrase reps use).
    • Propose a new workflow: when the same sequence of skills fires together often enough to bundle.
    • Retire a skill: when it is unused past RETIRE_DAYS or persistently below ACCURACY_FLOOR.
  4. 4
    Name the one thing to review first

    Every pass ends by surfacing the single highest-priority change, usually the skill whose accuracy dropped below the floor, with the specific cases to investigate.

QUALITY GATES
  • Every proposal has a rationale tied to data. Not "tighten this rubric" but "STRONG_FIT converted at 82% and FIT at 79%, too close to differentiate. Collapse to one tier plus an above-baseline override."
  • Nothing auto-merges. Every change is a reviewable proposal you approve before anything updates.
  • Outcome claims are honest. No "we improved win rate by 5%" without controlling for cohort confounds.
  • A skill is retired only on evidence: low invocation past the window, or precision below the floor, never a hunch.
OUTPUT (EXAMPLE)
EXAMPLE OUTPUT
EVOLUTION PASS - week of May 25
4 proposed changes ready for review

1. Tighten the fit rubric
   STRONG_FIT converted 82%, FIT 79% (too close). Collapse to one tier
   plus an "above-baseline" override.
2. Add a term to the tech-stack list
   A tool showed up in 12 calls this month vs 4 last quarter.
3. Propose a new workflow: renewal prep
   The same 3 skills fired in the same order 17 times. Bundle them.
4. Retire an unused skill
   Invoked twice in 180 days, both tests. Deprecate.

Accuracy (trailing 90 days):
  Fit scoring     82%
  Deal health     78%
  Churn predict   67%   <- below the 75% floor

Review first: churn prediction at 67%. Tighten it or lower its confidence.
WHERE THE NUMBERS COME FROM

RETIRE_DAYS (90), the 75% accuracy floor, and the trailing-90-day window are defaults from one team's cadence, not laws. A fast-moving library wants a shorter unused window; a high-stakes one wants a higher accuracy floor. Re-tune them to how much risk you carry. The loop (read both streams, attribute honestly, propose, approve) does not change. The thresholds are yours.

EXAMPLE CHAT
EXAMPLE CHAT
You
Pull together what we've learned this month across the skill library, what should we change?
CLAUDE
Ran the pass. Four proposals, one of them urgent. 1. Tighten the fit rubric: STRONG_FIT converted 82%, FIT 79%. Collapse to one tier. 2. Retire an unused skill: invoked twice in 180 days, both tests. 3. Add a term to the tech-stack list: a new tool named in 12 calls this month. 4. Propose a new workflow: same 3 skills fired together 17 times. Accuracy on churn prediction dropped to 67%, below the 75% floor. That's the one to review first, not the rubric tweak, even though the rubric tweak is the easier fix to ship. One sharpener: connect the outcome source (your CRM) so the accuracy numbers update automatically instead of me asking you to paste last month's results.
04 / GO FURTHER

Where an operator takes this next.

The manual pass proves the loop works. Here is what it looks like running continuously.

You still approve every merge. The pass just stops depending on someone remembering to run it.

01
Run the pass on a schedule

Put this on a monthly scheduled Claude task so drift gets caught before a quarter goes by, not after.

02
Feed it real reactions

Connect Slack reactions and Amplitude click-through so implicit and explicit feedback both flow in without anyone logging them by hand.

03
Ship proposals as diffs

Wire a GitHub connection so each proposed change lands as a pull request against the SKILL.md, ready for one-click review instead of a paragraph to re-type.

05 / PART OF A BIGGER PLAY

One skill is the on-ramp.

GET NEW SKILLS IN YOUR INBOX

One operator-built skill a week. Free.