explain SKILL.md skillA

explain from mickeyyaya/evolve-loop is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mickeyyaya/evolve-loop/explain@git:20261008.8a0662e

Pins git:20261008.8a0662e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
mickeyyaya/evolve-loop
Path
skills/explain/SKILL.md
Versions recorded
2
Latest version
git:20261008.8a0662e, committed Oct 8, 2026
First version recorded
Jul 13, 2026
Size
8,029 bytes
Repository stars
6
License
Apache-2.0

Use when the user asks to explain how a feature/subsystem works and how the loops built it, or what the concurrent loops/lanes/cycles did and why. Default output = per-FEATURE HTML explainer pages (two movements — how it works today, then how it got built, with verified file:line claims and drift callouts) under docs/explain/; per-batch/per-lane story pages are the fallback framing. Derived from geoffreylitt/explain-diff-html, customized for evolve-loop.

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

# /evo:explain — per-feature HTML explainer

Produce a rich, interactive HTML explanation of **how a feature/subsystem works and how the loops collectively built it**. The default unit of explanation is the **feature** (campaign/subsystem — e.g. token-telemetry, fleet-width, queue-integrity), aggregating ALL its contributing cycles across batches: one feature = many lanes/cycles = the complete idea. Per-lane or per-batch framing is the fallback when the user asks for a specific cycle range or batch story.

Each feature page has two movements: first **how it works today** (architecture, data flow end to end, with diagrams and real example data), then **how it got built** (the contributing cycles in order, what each added, which incident or root cause motivated it, including instructive failures). Output goes to `docs/explain/<feature-slug>.html` plus a shared `docs/explain/index.html` (feature table + contributing-cycle map + the deep pipeline background, written once). Repo writes land ONLY at batch/wave-safe boundaries via the gated commit path — stage in the session scratchpad until the landing window.

## Step 1 — Gather per-lane data (this repo's sources)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mickeyyaya/evolve-loop/explain@sha256:ce749f5d52e25e62

The line at the top of this page pins the label git:20261008.8a0662e, 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_x24yjjajnggfyy6i.svg)](https://markdownregistry.com/a/art_x24yjjajnggfyy6i)

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

Versions

The registry has recorded 2 versions of this file, between Jul 13, 2026 and Oct 8, 2026, about one every 87 days.

versioncommittedcommitsizeaudit
git:20261008.8a0662e latest2026-10-08 8a0662e 8,029 BA view · diff
git:20260713.5c51bbd2026-07-13 5c51bbd 7,870 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 (8029 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

mickeyyaya/evolve-loop · 6 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x24yjjajnggfyy6i
GET https://markdownregistry.com/api/v1/resolve?ref=mickeyyaya/evolve-loop/explain
GET https://markdownregistry.com/api/v1/blob/ce749f5d52e25e6201b6310523f38804251113995f9b228d3abf7a9fa620ace0

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 mickeyyaya/evolve-loop

AGENTS.md@.evolve/profiles AGENTS.md file
mickeyyaya/evolve-loop · .evolve/profiles/AGENTS.md
git:20261008.0936a73 · audit A · 6 stars
AGENTS.md AGENTS.md file
mickeyyaya/evolve-loop · AGENTS.md
git:20261106.54cad9b · audit A · 6 stars
CLAUDE.md CLAUDE.md file
mickeyyaya/evolve-loop · CLAUDE.md
git:20261106.54cad9b · audit A · 6 stars
AGENTS.md@agents AGENTS.md file
mickeyyaya/evolve-loop · agents/AGENTS.md
git:20260524.69626c6 · audit A · 6 stars
llms.txt@landing/shared llms.txt file
mickeyyaya/evolve-loop · landing/shared/llms.txt
git:20261106.88a0714 · audit B · 6 stars
adversarial-testing SKILL.md skill
mickeyyaya/evolve-loop · skills/adversarial-testing/SKILL.md · Use when authoring evals/predicates (Scout, TDD-Engineer), framing an audit (Auditor), or justifying which phases run…
git:20260914.80b348e · audit A · 6 stars
architecture-review SKILL.md skill
mickeyyaya/evolve-loop · skills/architecture-review/SKILL.md · Use when reviewing the structure of a code change read-only — single sources and duplicated beliefs, dependency…
git:20261007.f16bf48 · audit A · 6 stars
audit SKILL.md skill
mickeyyaya/evolve-loop · skills/audit/SKILL.md · Use after build has produced build-report.md. Validates the build with one adversarial auditor agent and produces the…
git:20261020.f4ba3ee · audit A · 6 stars
code-review-simplify SKILL.md skill
mickeyyaya/evolve-loop · skills/code-review-simplify/SKILL.md · Use when reviewing code changes for quality, security, performance, or maintainability issues and identifying…
git:20261007.e134ff4 · audit A · 6 stars
commit SKILL.md skill
mickeyyaya/evolve-loop · skills/commit/SKILL.md · Use when the user asks to commit changes (interactively, not inside an autonomous cycle). Runs code-simplifier + one…
git:20261105.2607b6e · audit A · 6 stars
diff-review SKILL.md skill
mickeyyaya/evolve-loop · skills/diff-review/SKILL.md · Budget-capped adversarial review + simplification pass over a STAGED DIFF only — one agent, two lenses, findings-first…
git:20261027.f0f1a5a · audit A · 6 stars
docs-review SKILL.md skill
mickeyyaya/evolve-loop · skills/docs-review/SKILL.md · Use when a change touches only documents (every changed path ends in .md) — research dossiers, plans, ADRs…
git:20261105.2607b6e · audit A · 6 stars

Every file in mickeyyaya/evolve-loop

Other files named explain

explain SKILL.md skill
dcouple/pane · main/src/services/paneChatBundle/skills/explain/SKILL.md · Use when the person wants to understand a concept or how something works today. Never plans.
git:20260924.17234b5 · audit A · 603 stars
explain SKILL.md skill
greenfield-inc/pane · main/src/services/paneChatBundle/skills/explain/SKILL.md · Use when the person wants to understand a concept or how something works today. Never plans.
git:20260924.17234b5 · audit A · 603 stars
explain SKILL.md skill
0xdarkmatter/claude-mods · skills/explain/SKILL.md · Deep explanation of complex code, files, or concepts. Dispatches skill-preloaded agents, uses structural search…
git:20261005.65b367f · audit A · 79 stars
explain SKILL.md skill
gkaria/vibe-learn · adapters/cursor/skills/explain/SKILL.md · Guided code tour of a file or subsystem this session touched — entry point, the load-bearing pieces, the edges, and…
git:20261017.a8c627f · audit A · 57 stars
explain SKILL.md skill
gkaria/vibe-learn · adapters/copilot-cli/skills/explain/SKILL.md · Guided code tour of a file or subsystem this session touched — entry point, the load-bearing pieces, the edges, and…
git:20261017.a8c627f · audit A · 57 stars
explain SKILL.md skill
anantys-oss/koan · koan/skills/core/explain/SKILL.md · Explain a PR's intent and changes in plain language (ex: /explain https://github.com/owner/repo/pull/42)
v1.0.0 · audit A · 48 stars
explain SKILL.md skill
jantichy/claude · skills/explain/SKILL.md · Skill se použije, když uživatel zadá "/explain" (volitelně s tím, co vysvětlit), nebo napíše, že nerozumí tomu, co mu…
git:20261105.fb301d4 · audit A · 45 stars
explain SKILL.md skill
saadshahd/moo.md · hope/skills/explain/SKILL.md · Show one settled thing so the user holds it. Use when the user does not hold something already settled.
git:20261031.143478c · audit A · 38 stars

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