repo-explainer SKILL.md skillA

repo-explainer from cyvid7-darus10/repo-explainer is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cyvid7-darus10/repo-explainer/repo-explainer@git:20261026.ca9a5de

Pins git:20261026.ca9a5de in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cyvid7-darus10/repo-explainer
Path
SKILL.md
Versions recorded
3
Latest version
git:20261026.ca9a5de, committed Oct 26, 2026
First version recorded
Oct 25, 2026
Size
8,954 bytes
Repository stars
4
License
Apache-2.0

Turn a codebase into a guided, interactive HTML tour: architecture map, step-through end-to-end flows with file:line citations, data model, and a "what changed and why" timeline of recent human and agent merges. Use when someone asks to explain, onboard onto, map, document, or catch up on a repository (backend, frontend, full-stack, mobile, library or CLI), or to show how a request flows end to end.

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

# Repo Explainer

You produce **one self-contained HTML file** that teaches a repo the way Brilliant teaches math: one idea at a time, with interactive diagrams and a big Continue button.

**You only write data.** The design, components, icons, animation and layout are finished and tested. Your job is to investigate the repo and fill `explainer.json` with true, cited facts. The CLI turns that into the page.

`SKILL_DIR` below means the folder this file is in. Run the CLI with `node "$SKILL_DIR/bin/repo-explainer.mjs" <command>` (Node 18.3+, no install step).

## Workflow

Copy this checklist into your todo list and work through it in order.

0. **(Optional) Check the cost.** `repo-explainer estimate <repo>` prints a rough per-model cost for this repo's size.
1. **Scan.** Run `repo-explainer scan <repo>`. It gives you facts to verify, not conclusions: stack, entry points, route handlers, data files, env var *names*, scripts, and a suggested preset.
2. **Pick a preset.** Run `repo-explainer presets` and take the suggestion unless it is clearly wrong. Each preset fixes the layers, the chapter order, the flows you must trace and the questions you must answer. See `presets/<id>.json`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cyvid7-darus10/repo-explainer/repo-explainer@sha256:24eb0449ae0c20f1

The line at the top of this page pins the label git:20261026.ca9a5de, 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_hwgbss5qew2z6iwh.svg)](https://markdownregistry.com/a/art_hwgbss5qew2z6iwh)

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

Versions

The registry has recorded 3 versions of this file, between Oct 25, 2026 and Oct 26, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261026.ca9a5de latest2026-10-26 ca9a5de 8,954 BA view · diff
git:20261025.4e0a8372026-10-25 4e0a837 8,952 BA view · diff
git:20261025.4637cdc2026-10-25 4637cdc 8,953 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 (8954 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

cyvid7-darus10/repo-explainer · 4 stars · license Apache-2.0 · pushed 2026-10-26 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hwgbss5qew2z6iwh
GET https://markdownregistry.com/api/v1/resolve?ref=cyvid7-darus10/repo-explainer/repo-explainer
GET https://markdownregistry.com/api/v1/blob/24eb0449ae0c20f1fddb1a91a2e6ef47f68788e656dd78f05d12e44feaa7c41e

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.

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