how SKILL.md skillA

how from backnotprop/pstack is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add backnotprop/pstack/how@git:20261020.e44668c

Pins git:20261020.e44668c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
backnotprop/pstack
Path
skills/how/SKILL.md
Versions recorded
13
Latest version
git:20261020.e44668c, committed Oct 20, 2026
First version recorded
May 27, 2026
Size
3,258 bytes
Repository stars
3,337
License
MIT

Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions ("where should this live", "which package owns this", "is this the right layer"). Explains subsystem architecture, runtime flow, onboarding mental models. Use why for motivation.

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.

Every spawn is a Task subagent with `subagent_type: generalPurpose` and `readonly: true`. Explorers use the `how explorer` line in the pstack settings file (`~/.cursor/rules/pstack-models.mdc` in Cursor, `~/.claude/rules/pstack-models.md` in Claude Code, `~/.agents/pstack-models.md` in other harnesses) (default `grok-4.7-xhigh-fast`), and every explainer uses the `how explainer` line (default `claude-opus-5-5-xhigh`). Set `model` to that line's value, or to the default if the file or the line is missing. Leave `model` unset when the value is `auto` or `inherit-parent`. If your subagent tool rejects a slug, use the default and say so. If it rejects the default, use the closest valid slug of the same family from its error message or your harness's model list. Pick each subagent's reasoning level and fast or standard speed for the job, per the Subagents section of the **poteto-mode** skill.

## 1. Assess complexity
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add backnotprop/pstack/how@sha256:a63ac90597960cfd

The line at the top of this page pins the label git:20261020.e44668c, 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_t46bs6mtnxddxa23.svg)](https://markdownregistry.com/a/art_t46bs6mtnxddxa23)

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

Versions

The registry has recorded 13 versions of this file, between May 27, 2026 and Oct 20, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
git:20261020.e44668c latest2026-10-20 e44668c 3,258 BA view · diff
git:20261015.6f131f12026-10-15 6f131f1 3,207 BA view · diff
git:20261015.df856f42026-10-15 df856f4 2,651 BA view · diff
git:20261012.fce11a32026-10-12 fce11a3 3,074 BA view · diff
git:20261012.f3afb702026-10-12 f3afb70 2,518 BA view · diff
git:20261008.1edf0a52026-10-08 1edf0a5 3,637 BA view · diff
git:20261008.4aed5af2026-10-08 4aed5af 3,081 BA view · diff
git:20261004.124f6222026-10-04 124f622 3,633 BA view · diff
git:20261004.c0c3f132026-10-04 c0c3f13 3,077 BA view · diff
git:20260914.aa2db462026-09-14 aa2db46 3,380 BA view · diff
git:20260914.55bfdc22026-09-14 55bfdc2 2,738 BA view · diff
git:20260819.4b32d9d2026-08-19 4b32d9d 7,285 BA view · diff
git:20260527.b3eabf12026-05-27 b3eabf1 7,690 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 (3258 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

backnotprop/pstack · 3,337 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_t46bs6mtnxddxa23
GET https://markdownregistry.com/api/v1/resolve?ref=backnotprop/pstack/how
GET https://markdownregistry.com/api/v1/blob/a63ac90597960cfdc4d51ec88960b3bf0a05d44a7dff1d5a2b8639981c25ca54

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 backnotprop/pstack

reproduce-and-fix-issues SKILL.md skill
backnotprop/pstack · automations/benny/skills/reproduce-and-fix-issues/SKILL.md · Reproduce triaged Slack bugs through a configured app-control adapter, verify existing fixes, and open a bounded draft…
git:20260819.4b32d9d · audit A · 3,337 stars
setup-benny SKILL.md skill
backnotprop/pstack · automations/benny/skills/setup-benny/SKILL.md · Configure Benny and prepare its triage and repro automations. Use when installing Benny or changing its Slack, tracker…
git:20260819.4b32d9d · audit A · 3,337 stars
triage-issue-reports SKILL.md skill
backnotprop/pstack · automations/benny/skills/triage-issue-reports/SKILL.md · Triage Slack issue reports with one thread-only verdict, evidence review, cause-aware routing, tracker dedupe, and…
git:20260819.4b32d9d · audit A · 3,337 stars
architect SKILL.md skill
backnotprop/pstack · skills/architect/SKILL.md · Sketch types, signatures, and module structure before code, then stay in the loop while implementation fills in. Use…
git:20261020.e44668c · audit A · 3,337 stars
arena SKILL.md skill
backnotprop/pstack · skills/arena/SKILL.md · Spawn N parallel candidates at the same task, pick a base, graft the strongest parts of the losers into it. Use for…
git:20261028.23ef874 · audit A · 3,337 stars
automate-me SKILL.md skill
backnotprop/pstack · skills/automate-me/SKILL.md · Use for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a…
git:20261015.6f131f1 · audit A · 3,337 stars
benchmark-checklist SKILL.md skill
backnotprop/pstack · skills/benchmark-checklist/SKILL.md · Vet a perf measurement (limiter, tuning, limits, errors, repeatability, relevance, and whether the work happened)…
git:20261012.f3afb70 · audit A · 3,337 stars
blast-radius SKILL.md skill
backnotprop/pstack · skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove the one fact it's safe…
git:20261008.4aed5af · audit A · 3,337 stars
bro SKILL.md skill
backnotprop/pstack · skills/bro/SKILL.md · Restate the last message in plain human language, with no jargon.
git:20260819.4b32d9d · audit A · 3,337 stars
correct SKILL.md skill
backnotprop/pstack · skills/correct/SKILL.md · Find the mistakes agents keep repeating in this repo and make each one impossible. Try architecture first, then types…
git:20261015.df856f4 · audit A · 3,337 stars
create-formal-verification-skill SKILL.md skill
backnotprop/pstack · skills/create-formal-verification-skill/SKILL.md · Generate a project-local skill that formally verifies the code where a bug costs the most and tests reach the least, in…
git:20261027.0410d4b · audit A · 3,337 stars
create-verification-skill SKILL.md skill
backnotprop/pstack · skills/create-verification-skill/SKILL.md · Generate a project-local verification skill that drives your app the way a user does — any language, framework, or…
git:20261012.fce11a3 · audit A · 3,337 stars

Every file in backnotprop/pstack

Other files named how

how SKILL.md skill
cursor/plugins · pstack/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
git:20261014.ce649c0 · audit A · 15,125 stars
how SKILL.md skill
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…
git:20261016.182f2ce · audit A · 15,125 stars
how SKILL.md skill
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…
git:20261013.9e6954c · audit A · 5,267 stars
how SKILL.md skill
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…
git:20261030.bfaf03e · audit A · 3,776 stars
how SKILL.md skill
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…
git:20260823.166e8d7 · audit A · 874 stars
how SKILL.md skill
iap/pstack-hermes · skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
git:20261006.f7c5841 · audit A · 32 stars
how SKILL.md skill
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…
git:20260821.1b830a3 · audit A · 26 stars
how SKILL.md skill
barbieri/local-openfinance · .agents/skills/how/SKILL.md · Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions…
git:20261005.32edae5 · audit A · 24 stars

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