recursive-improvement
Skill179 starsChanged 9 months agoMITView on GitHub
A pattern for generating higher-quality output by iterating against explicit scoring criteria. Use for headlines, CTAs, landing page copy, social content, ad copy — anything where quality matters. Generate → Evaluate → Diagnose → Improve → Repeat.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- appstore-intelSkill
- creative-directionSkill
- design-tokensSkill
- hn-searchSkill
- motion-design-patternsSkill
- privacy-cardsSkill
- producthuntSkill
- trademark-searchSkill
- visual-qaSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Never ship first-draft output for important content: Run the loop.
- Distinctive: line 23
Create the initial output as you normally would.
- Distinctive: line 44
After passing criteria, attack the output from a hostile perspective:
- Distinctive: line 49
If it survives, ship it. If not, iterate.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Recursive Self-Improvement Loop
A pattern for generating higher-quality output by iterating against explicit scoring criteria.
The Pattern
generate → evaluate → diagnose → improve → repeat (until passing)Never ship first-draft output for important content. Run the loop.
How It Works
1. Generate
Create the initial output as you normally would.
2. Evaluate
Score the output against each criterion (1-10). Be brutally honest.
3. Diagnose
For any criterion scoring below threshold:
- What specifically is weak?
- Why does it fail?
- What would "passing" look like?
4. Improve
Rewrite addressing each diagnosed weakness. Don't patch — rebuild the weak sections.
5. Repeat
Re-evaluate. Keep looping until all criteria pass threshold (usually 8/10 minimum).
Adversarial Pressure (Optional but Powerful)
After passing criteria, attack the output from a hostile perspective:
- Skeptical customer: "Why should I believe this? What's the catch?"
- Distracted scroller: "Would I stop for this? In 2 seconds?"
- Competitor: "How would a rival tear this apart?"
If it survives, ship it. If not, iterate.
Example Criteria by Use Case
Social Content
| Criterion | What to evaluate |
| Hook strength | First line grabs attention? Pattern interrupt? |
| Curiosity gap | Creates urge to keep reading? |
| Clarity | One clear idea? No confusion? |
| Voice match | Sounds like the target voice/brand? |
| Engagement potential | People will reply/share/save? |
| Thumb-stop power | Scroller would pause? |
| Value density | Every line earns its place? |
| CTA clarity | Clear what reader should do next? |
Adversarial test: Would a distracted, skeptical user at 11pm engage with this?
Landing Page / Web Copy
| Criterion | What to evaluate |
| Headline clarity | Instantly clear what this business does? |
| Value prop strength | Why choose them over competitors? |
| Benefit focus | Features translated to customer benefits? |
| CTA effectiveness | Clear, compelling action? Low friction? |
| Trust signals | Credibility established? Social proof? |
| Readability | Scannable? Short paragraphs? Clear hierarchy? |
| Objection handling | Common concerns addressed? |
| Specificity | Concrete details vs vague claims? |
Adversarial test: Would someone searching on their phone take action within 30 seconds?
Email Copy
| Criterion | What to evaluate |
| Subject line | Would this get opened? Stands out in inbox? |
| Opening hook | First sentence earns the second? |
| Single focus | One clear ask per email? |
| Skimmability | Can get the gist in 5 seconds? |
| CTA prominence | Action is obvious and easy? |
| Voice consistency | Matches brand/sender personality? |
| Length appropriate | No fluff, nothing missing? |
| Mobile friendly | Works on small screens? |
Adversarial test: Would a busy person with 200 unread emails act on this?
Ad Copy
| Criterion | What to evaluate |
| Thumb-stop power | Pattern interrupt in first 2 seconds? |
| Curiosity gap | Creates need to know more? |
| Emotional trigger | Hits a real pain point or desire? |
| Credibility | Believable? Not too good to be true? |
| CTA strength | Clear next step with low friction? |
| Persona match | Speaks directly to target audience? |
| Differentiation | Stands out from competitor ads? |
| Platform native | Fits the platform's style/format? |
Adversarial test: Would this stop YOUR scroll? Would you click?
When to Use
Always use for:
- Headlines and hooks
- CTAs and value props
- Key landing page sections
- Social posts (especially threads)
- Ad copy
- Important emails
Can skip for:
- Internal notes
- First-pass brainstorming
- Technical documentation
- Boilerplate content
Building Your Own Criteria
- Pick one task you do repeatedly
- Write down how YOU evaluate that output — what makes "good" vs "mid"?
- Turn each into a pass/fail threshold — be specific ("9/10 minimum" not "make it good")
- Add adversarial pressure — who would attack this? What would they say?
- Save and reuse — now you have a system, not just a prompt
Quick Loop Template
## Output v1
[Initial generation]
## Evaluation v1
- Hook strength: 6/10 — Opens weak, no pattern interrupt
- Clarity: 8/10 — Clear enough
- Voice match: 7/10 — Too formal
[... score all criteria]
## Diagnosis
1. Hook needs a surprising stat or contrarian take
2. Voice should be more casual, shorter sentences
3. [...]
## Output v2
[Revised version addressing weaknesses]
## Evaluation v2
[Re-score — continue until all pass]The loop typically adds 2-3 iterations. Worth it for anything that matters.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

