evolve SKILL.md skillA

evolve from tonygorb/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add tonygorb/skills/evolve@git:20261013.bc9e437

Pins git:20261013.bc9e437 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tonygorb/skills
Path
skills/evolve/SKILL.md
Versions recorded
1
Latest version
git:20261013.bc9e437, committed Oct 13, 2026
Size
1,604 bytes
Repository stars
2
License
MIT

Audit one part of the code and rank what to improve. Changes nothing. Use when the user asks "is this outdated" or "how could X be better".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Evolve

Propose upgrades; **never apply them in the same run**. The output is a ranked list the user picks from.

## Scope

One area per run (UI, data layer, auth, testing, caching, one flow). Asked to evolve "everything":
ask which area first.

## Process

1. **Baseline.** Read the project's own rules for that area (AGENTS.md, a design doc, an ADR) and
   the actual code. The current way is intentional: an upgrade has to beat it, not just differ.
2. **Current practice.** Check the docs of the versions actually installed (your training data
   may be older than the code), and the codebase's own newest screens: often the best idea
   already exists in one place and should spread.
3. **Disqualify** anything that breaks a hard rule of the project. Breaking an invariant isn't an
   upgrade.

## Output: always this table, ranked by value for cost

| # | Upgrade | Benefit | Cost (S/M/L) | Risk | Files touched |
|---|---|---|---|---|---|

Under it, at most three sentences per row: what changes, why it beats the current way, what could
break. End with your recommended pick and what you'd do first once it's approved.

## After approval (a separate run)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tonygorb/skills/evolve@sha256:78941870afbb1dd1

The line at the top of this page pins the label git:20261013.bc9e437, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jkyahlmy3kvwblt2.svg)](https://markdownregistry.com/a/art_jkyahlmy3kvwblt2)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 13, 2026.

versioncommittedcommitsizeaudit
git:20261013.bc9e437 latest2026-10-13 bc9e437 1,604 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1604 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

tonygorb/skills · 2 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jkyahlmy3kvwblt2
GET https://markdownregistry.com/api/v1/resolve?ref=tonygorb/skills/evolve
GET https://markdownregistry.com/api/v1/blob/78941870afbb1dd1126e51af0d9561f218eda5285977fb08f57c76e068895447

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from tonygorb/skills

concept-lab SKILL.md skill
tonygorb/skills · skills/concept-lab/SKILL.md · Build 3-5 real concepts side by side and let the user pick one. Use when the user says "show me options", "explore some…
git:20261013.8f735ab · audit A · 2 stars
design-within-what-exists SKILL.md skill
tonygorb/skills · skills/design-within-what-exists/SKILL.md · Change a screen with the patterns it already has, not new ones. Use when the user says "redesign this", "restyle this…
git:20261013.8f735ab · audit A · 2 stars
polish-design-system SKILL.md skill
tonygorb/skills · skills/polish-design-system/SKILL.md · Find hard-coded colours, propose tokens, apply them once approved. Use when the user says "polish the design system"…
git:20261013.8f735ab · audit A · 2 stars
review-a-screen SKILL.md skill
tonygorb/skills · skills/review-a-screen/SKILL.md · Check a screen in the browser at real sizes, like a designer would. Use when the user says "review this screen", "check…
git:20261013.bc9e437 · audit A · 2 stars
token-foundations SKILL.md skill
tonygorb/skills · skills/token-foundations/SKILL.md · Build or audit semantic design tokens in OKLCH, light and dark. Use when the user says "set up design tokens", "audit…
git:20261013.8f735ab · audit A · 2 stars
tokens-to-figma SKILL.md skill
tonygorb/skills · skills/tokens-to-figma/SKILL.md · Push a codebase's design tokens into Figma as variables and modes. Use when the user says "sync tokens to Figma"…
git:20261013.8f735ab · audit A · 2 stars
unugly SKILL.md skill
tonygorb/skills · skills/unugly/SKILL.md · Find what makes AI-built UI look generic, fix it once approved. Use when the user says "this looks AI-generated", "make…
git:20261013.8f735ab · audit A · 2 stars
verify-work SKILL.md skill
tonygorb/skills · skills/verify-work/SKILL.md · Prove a change works with real checks before calling it done. Use before saying work is done, or when the user says…
git:20261013.bc9e437 · audit A · 2 stars
wrap-up SKILL.md skill
tonygorb/skills · skills/wrap-up/SKILL.md · Close a task: list the changes, fix stale docs, run checks, draft the commit. Use when the user says "wrap up" or…
git:20261013.8f735ab · audit A · 2 stars

Every file in tonygorb/skills

Other files named evolve

evolve SKILL.md skill
sethgammon/citadel · skills/evolve/SKILL.md · Research-driven multi-cycle improvement director. Forms causal hypotheses about why scores are low, validates them with…
git:20260611.0f3f8e7 · audit A · 925 stars
evolve SKILL.md skill
danmcinerney/orchflows · example-workflows/evolve/skills/evolve/SKILL.md · Iteratively improve any artifact and its improvement harness, inventing evaluation when needed; supports bounded runs…
git:20260923.9d51df1 · audit A · 124 stars
evolve SKILL.md skill
kanevry/session-orchestrator · skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20261021.728a583 · audit A · 53 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .cursor/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260916.3ebf0e9 · audit A · 53 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .agents/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260919.176b605 · audit A · 53 stars
evolve SKILL.md skill
kanevry/session-orchestrator · .codex-plugin/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260918.20a4cbf · audit A · 53 stars
evolve SKILL.md skill
mycelium-hq/ai-brain-starter · skills/evolve/SKILL.md · Use when many related hardened instincts (high-confidence feedback_*/discovery_* memories) have piled up in one domain…
git:20260722.7893e72 · audit A · 47 stars
evolve SKILL.md skill
lstr-1/skills · sex/skills/evolve/SKILL.md · Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session…
git:20260922.11fdbec · audit A · 2 stars

Browse by kind, by grade A, or by owner.