explainme SKILL.md skillA

explainme from jdanigo/hydraia is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jdanigo/hydraia/explainme@v0.1 (hydraia)

Pins v0.1 (hydraia) in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jdanigo/hydraia
Path
skills/explainme/SKILL.md
Versions recorded
1
Latest version
v0.1 (hydraia), committed Sep 12, 2026
Size
18,362 bytes
Repository stars
8
License
MIT

Explain a codebase, subsystem, or PR to a human — visually and verifiably. Turns real code structure into a polished, validated, explorable standalone HTML map (architecture, workflow, sequence, data-flow, or lifecycle/state) with inline SVG, dark/light themes, guided walkthrough chapters, source-pinned nodes, and PNG/SVG/WebM export. Use for onboarding, "how does this system work / how does this flow work", visual PR/architecture review, or converting/beautifying Mermaid. In Hydraia it is…

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

# Explainme — visual, verifiable code explanation

Explain a codebase to a human as a **self-contained, interactive HTML map** compiled from a small typed JSON specification. The deterministic CLI validates every artifact before delivery and refuses to ship one that is not geometrically clean and semantically faithful — so the diagram never invents topology. Static output is the default; enable motion only for a demo or presentation.

**This is a vendored + rebranded build of [Archify](https://github.com/tt-a1i/archify) (MIT).** The MIT `LICENSE`, `THIRD_PARTY_NOTICES.md`, and the upstream attribution above are kept as required. The engine (schemas, renderers, viewer, validator) is upstream's; Hydraia adds the codegraph grounding and the onboarding framing below.

## Hydraia grounding — codegraph is the topology source (read first)

Do NOT hand-guess the system's structure. In Hydraia the topology comes from **codegraph** (the verified code knowledge graph), and Explainme renders it:

1. Query codegraph for the subsystem in scope — components/modules, call edges, entry points, storage/transports, blast radius (`codegraph_explore`, callers/callees/impact). That is the ground truth.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jdanigo/hydraia/explainme@sha256:66748ffd1cd017a4

The line at the top of this page pins the label v0.1 (hydraia), 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_i6fo6cj3fspm5kji.svg)](https://markdownregistry.com/a/art_i6fo6cj3fspm5kji)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 12, 2026.

versioncommittedcommitsizeaudit
v0.1 (hydraia) latest2026-09-12 30e881b 18,362 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 (18362 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

jdanigo/hydraia · 8 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_i6fo6cj3fspm5kji
GET https://markdownregistry.com/api/v1/resolve?ref=jdanigo/hydraia/explainme
GET https://markdownregistry.com/api/v1/blob/66748ffd1cd017a455a4ff55780a118cc3cb7fdd599b9bb8a9ea11fe39e941c8

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 jdanigo/hydraia

hydraia SKILL.md skill
jdanigo/hydraia · codex/skills/hydraia/SKILL.md · Codex-native hydraia pipeline. Use when the user asks to build, add, implement, or change a feature, brings a…
git:20260912.9f5add4 · audit A · 8 stars
adr SKILL.md skill
jdanigo/hydraia · skills/adr/SKILL.md · Use when a design decision is made that is expensive to reverse, affects multiple components, or rejects a plausible…
git:20260703.c5a2b92 · audit A · 8 stars
agency-tier-ui SKILL.md skill
jdanigo/hydraia · skills/agency-tier-ui/SKILL.md · Teaches the AI to design like a high-end agency. Defines the exact fonts, spacing, shadows, card structures, and…
git:20260819.5575aa5 · audit A · 8 stars
api-design SKILL.md skill
jdanigo/hydraia · skills/api-design/SKILL.md · Use when designing or reviewing an API surface — REST, GraphQL, or gRPC. Contract-first methodology: the contract…
git:20260703.c5a2b92 · audit A · 8 stars
banner-design SKILL.md skill
jdanigo/hydraia · skills/banner-design/SKILL.md · Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with…
v1.0.0 · audit A · 8 stars
brainstorming SKILL.md skill
jdanigo/hydraia · skills/brainstorming/SKILL.md · You MUST use this before any creative work - creating features, building components, adding functionality, or modifying…
git:20260911.13e2dcf · audit A · 8 stars
brand SKILL.md skill
jdanigo/hydraia · skills/brand/SKILL.md · Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content…
v1.0.0 · audit A · 8 stars
caveman SKILL.md skill
jdanigo/hydraia · skills/caveman/SKILL.md · Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical…
git:20260702.9dc0119 · audit A · 8 stars
coding-standards SKILL.md skill
jdanigo/hydraia · skills/coding-standards/SKILL.md · Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed…
git:20260702.69ee5ed · audit A · 8 stars
db-optimization SKILL.md skill
jdanigo/hydraia · skills/db-optimization/SKILL.md · Use when the bottleneck is database-shaped — slow queries, lock timeouts, connection exhaustion, N+1 patterns, index…
git:20260703.44486a5 · audit A · 8 stars
design-system SKILL.md skill
jdanigo/hydraia · skills/design-system/SKILL.md · Token architecture, component specifications, and slide generation. Three-layer tokens (primitive→semantic→component)…
v1.0.0 · audit B · 8 stars
design-to-code SKILL.md skill
jdanigo/hydraia · skills/design-to-code/SKILL.md · Elite render-to-code skill. The user brings a finished website design render (jpg/png); this skill distills it into…
git:20260819.357915e · audit A · 8 stars

Every file in jdanigo/hydraia

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