agentdescent SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

agentdescent from birfy/agentdescent is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add birfy/agentdescent/agentdescent@git:20261103.2ab6326

Pins git:20261103.2ab6326 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
birfy/agentdescent
Path
integrations/claude-code/skills/agentdescent/SKILL.md
Versions recorded
5
Latest version
git:20261103.2ab6326, committed Nov 3, 2026
First version recorded
Nov 3, 2026
Size
23,320 bytes
Repository stars
205
License
MIT

Improve a SKILL.md, agent definition, system prompt, small codebase or host plugin by measuring it against examples and evolving it, rather than rewriting it by hand and hoping. Use whenever the user asks to improve, fix, tune, optimise, "train" or get better results out of one of those -- including when they have no test cases yet, because drafting cases for them to check is step one of the procedure, not a prerequisite for it. AgentDescent runs the edits in parallel and keeps only those that…

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

# AgentDescent

You have tools (MCP server `agentdescent`) or, without MCP, the `agentdescent`
command with the same verbs. A run is an evolution: N workers propose edits in
parallel, a merger keeps the ones that improve held-out reward, and nothing is
written back until the user says so.

## The procedure

1. **`doctor` first.** Report what is missing (worker agent CLI, provider key,
   container engine). Stop if there is no worker agent for a directory kind.
   It also reports the AgentDescent `version` and the interpreter
   (`executable`) this server runs. When results differ from the user's shell
   (a verb missing, a different key set), compare it with `agentdescent doctor`
   there: your host may have started a different install.
2. **Establish the four things a spec needs**: `target`, `data`, `score`, `agent`.
   Write every path **absolute**. A relative one is resolved against whatever
   directory read the spec -- the host started its MCP server somewhere you
   cannot see -- so the same spec finds the file from one host and not another.
   - `kind`: `text` (a prompt or instruction), `skill_dir` (a SKILL.md folder),
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add birfy/agentdescent/agentdescent@sha256:98af6e7b51c80137

The line at the top of this page pins the label git:20261103.2ab6326, 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_u5driaits7vyutso.svg)](https://markdownregistry.com/a/art_u5driaits7vyutso)

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

Versions

The registry has recorded 5 versions of this file, all committed on Nov 3, 2026.

versioncommittedcommitsizeaudit
git:20261103.2ab6326 latest2026-11-03 2ab6326 23,320 BA view · diff
git:20261103.98383c12026-11-03 98383c1 22,970 BA view · diff
git:20261103.2ae8ae32026-11-03 2ae8ae3 22,619 BA view · diff
git:20261103.ae666fe2026-11-03 ae666fe 22,316 BA view · diff
git:20261103.616ce6a2026-11-03 616ce6a 22,116 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 (23320 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

birfy/agentdescent · 205 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_u5driaits7vyutso
GET https://markdownregistry.com/api/v1/resolve?ref=birfy/agentdescent/agentdescent
GET https://markdownregistry.com/api/v1/blob/98af6e7b51c801370c4a282dc6132d1d0160700bdd2737a6526823985193ed2d

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 birfy/agentdescent

fix-issue SKILL.md skill
birfy/agentdescent · .claude/skills/fix-issue/SKILL.md · Fix one AgentDescent issue end to end - claim, fresh clone, a test that fails on main, gates, PR, self-review at the…
git:20261019.28fb504 · audit A · 205 stars
review-pr SKILL.md skill
birfy/agentdescent · .claude/skills/review-pr/SKILL.md · Review an AgentDescent PR (or local change) at a tip SHA and write a Verifier report with Tip SHA / Ran / Not run /…
git:20261019.28fb504 · audit A · 205 stars
AGENTS.md AGENTS.md file
birfy/agentdescent · AGENTS.md
git:20261019.28fb504 · audit A · 205 stars
agentdescent SKILL.md skill
birfy/agentdescent · agentdescent/integrations/SKILL.md · Improve a SKILL.md, agent definition, system prompt, small codebase or host plugin by measuring it against examples and…
git:20261103.2ab6326 · audit A · 205 stars

Every file in birfy/agentdescent

Other files named agentdescent

agentdescent SKILL.md skill
birfy/agentdescent · agentdescent/integrations/SKILL.md · Improve a SKILL.md, agent definition, system prompt, small codebase or host plugin by measuring it against examples and…
git:20261103.2ab6326 · audit A · 205 stars

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