sw-explain SKILL.md skillA
sw-explain from mhmtsrfglu/superwiki is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add mhmtsrfglu/superwiki/sw-explain@git:20261015.e65e6c7Pins git:20261015.e65e6c7 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- mhmtsrfglu/superwiki
- Path
skills/sw-explain/SKILL.md- Versions recorded
- 4
- Latest version
- git:20261015.e65e6c7, committed Oct 15, 2026
- First version recorded
- Oct 4, 2026
- Size
- 2,624 bytes
- Repository stars
- 30
- License
- MIT
Use when the user asks what a Superwiki task is for, why it exists, what it depends on, what it blocks or what changes once it is done, or invokes sw-explain with a task id. Not for what a task did or how it was verified; that is sw-verify.
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
# sw-explain Explains one task so that someone who has not followed the project understands it. Changes no file. Run commands from the project root. ## Steps 1. `node docs/.sw/sw.mjs explain <ID>`. It prints the task's state, what it depends on, what it blocks, what becomes ready when it is done, its plan and the wiki pages it links, each with a one-line summary. No id given: ask which task, offering the ones from `node docs/.sw/sw.mjs ready`. The state is derived: `ready` is a `todo` task whose dependencies are done, `blocked` is a `todo` task still waiting on one, `progress` is `in-progress`. Say it in words, not as a label. 2. Read `docs/tasks/<ID>.md`. 3. Read more only when the answer needs it: - the plan's `## Approach` section, if the user will want to know how it is to be done; - one linked page, if the task's "Goal" does not itself say why the task exists: a `decision` page if there is one, otherwise the page whose summary is closest to the goal; - nothing else. Summaries from step 1 stand in for the other pages. 4. **Answer in the user's language**, in this order, one to a few sentences each: …
Read the whole file at its exact version.
How to install
mdr add mhmtsrfglu/superwiki/sw-explain@sha256:4358c9c168c23dafThe line at the top of this page pins the label git:20261015.e65e6c7, 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.
[](https://markdownregistry.com/a/art_kdyqj2d5dx2m75a6)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Oct 4, 2026 and Oct 15, 2026, about one every 4 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261015.e65e6c7 latest | 2026-10-15 | e65e6c7 | 2,624 B | A | view · diff |
| git:20261008.42c6752 | 2026-10-08 | 42c6752 | 2,553 B | A | view · diff |
| git:20261007.79a0d6e | 2026-10-07 | 79a0d6e | 2,567 B | A | view · diff |
| git:20261004.2bcdaa8 | 2026-10-04 | 2bcdaa8 | 2,567 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2624 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
mhmtsrfglu/superwiki · 30 stars · license MIT · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kdyqj2d5dx2m75a6 GET https://markdownregistry.com/api/v1/resolve?ref=mhmtsrfglu/superwiki/sw-explain GET https://markdownregistry.com/api/v1/blob/4358c9c168c23daf3a38a8322fe0d8b491cf612b93f0f7aceab4c949d20082db
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.