Use for how-does-X-work walkthroughs, placement, ownership, and layering questions before changing code.
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
# How
Explore the codebase to answer "how does X work?" questions. Produce architectural explanations at the level of a senior engineer onboarding onto a subsystem, enough to build a working mental model, not so much that it reads like annotated source code.
Each spawn below names a role line in `workflow-profile` (how explorer / how explainer). Set `model` to that line's value. If the line is missing, omit `model` so the child uses the parent. Leave `model` unset when the value is `auto` or `inherit-parent`. If the Task tool rejects a slug, omit `model` and say so.
## Step 1. Assess Complexity
If the scope is ambiguous, state your interpretation and explore. The user can redirect.
- **Simple** (a single module, a small utility, a narrow question such as "how does function X work"): no explorers. One explainer explores and explains in a single pass. Go to Step 2b.
- **Complex** (a subsystem spanning multiple files or services, a cross-cutting feature, a full architectural overview): spawn parallel explorers first, then hand off to the explainer. Go to Step 2a.
When in doubt, take the simple path.
## Step 2a. Explore (complex questions only)
…
The line at the top of this page pins the label git:20261006.f349c21, 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.
GET https://markdownregistry.com/api/v1/artifacts/art_qqyebnj7mz4zdcyl
GET https://markdownregistry.com/api/v1/resolve?ref=kunanonj/ai-skills-hub/how
GET https://markdownregistry.com/api/v1/blob/60437496816eba371b7128c86297781e077979c597f5237f745968a446b883e8
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.
kunanonj/ai-skills-hub · plugins/superstacks/skills/code-review/SKILL.md · Use when reviewing a branch, PR, or WIP since a commit, tag, or merge-base. Two-axis Standards and Spec review via…
kunanonj/ai-skills-hub · plugins/superstacks/skills/diagnosing-bugs/SKILL.md · Use when the user says diagnose or debug this, or reports something broken, throwing, failing, or slow.
kunanonj/ai-skills-hub · plugins/superstacks/skills/domain-modeling/SKILL.md · Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
kunanonj/ai-skills-hub · plugins/superstacks/skills/gardening/SKILL.md · Use when finding small maintenance work. One concern per PR, each with a verify command and a small diff budget.
kunanonj/ai-skills-hub · plugins/superstacks/skills/grill-with-docs/SKILL.md · Use when grilling a plan or design that should also produce ADRs and a glossary as you go.
kunanonj/ai-skills-hub · plugins/superstacks/skills/grilling/SKILL.md · Use when the user wants to stress-test a plan, decision, or idea, or uses any grill trigger phrases.
kunanonj/ai-skills-hub · plugins/superstacks/skills/intake-triage/SKILL.md · Use when a coordinator has a batch of bug reports, feedback, or alerts. Deduplicate, group, score two-way vs one-way…
kunanonj/ai-skills-hub · plugins/superstacks/skills/interrogate/SKILL.md · Use for interrogate, adversarial review, multi-model review, challenge this, stress test this code, or find blind spots.
kunanonj/ai-skills-hub · plugins/superstacks/skills/mistake-to-constraint/SKILL.md · Use when a mistake repeats. Encode it as the strongest guard — type or runtime, lint, test, directory convention, then…
kunanonj/ai-skills-hub · plugins/superstacks/skills/sample-review/SKILL.md · Use when sampling recently merged PRs against repo standards and CONSTRAINTS.md. Propose environment tightenings, not…
cursor/plugins · pstack/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
cursor/plugins · harness/pstack/claude-code/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
nightly-labs/openbot · marketplace/production-catalog/bundles/pstack/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
michael-denyer/pstack-claude · plugins/pstack/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
backnotprop/pstack · skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
bastani-inc/atomic · packages/workflows/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
iap/pstack-hermes · skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
j-star-films-studios/vibecode-protocol-suite · assets/.agent/skills/code-intelligence/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
