sw-plan SKILL.md skillA

sw-plan from mhmtsrfglu/superwiki is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mhmtsrfglu/superwiki/sw-plan@git:20261008.42c6752

Pins git:20261008.42c6752 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-plan/SKILL.md
Versions recorded
4
Latest version
git:20261008.42c6752, committed Oct 8, 2026
First version recorded
Oct 5, 2026
Size
10,258 bytes
Repository stars
30
License
MIT

Use when the user wants to plan a task or a piece of work in a Superwiki project before building it, asks what to work on next, or invokes sw-plan, with or without a task id.

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-plan

Produces `docs/plans/<ID>-plan.md` for one task. You clarify with the user and get approval; a planner subagent, running the model set in sw-config, reads the code and writes the plan file. You never read the code and never hold the plan text: that is what keeps planning cheap.

Needs the task module (`docs/tasks/`). If it is missing, say so and offer sw-init with `--tasks`. Run commands from the project root. `<skill-dir>` is the directory this SKILL.md is in; the planner's role file, `planner.md`, is `<skill-dir>/assets/planner.md`.

The plan is a file under `docs/plans/`, and a task is a file under `docs/tasks/`. When the host's plan mode, a memory tool or a rule of the host keeps this session from writing under `docs/` or from running the shell (a plan mode that holds its plan in the host's own memory or session folder is such a case), stop before the first write: name the obstacle to the user, ask them to lift it (leave plan mode, allow the writes, give the session a shell), and wait. A plan kept anywhere but `docs/plans/<ID>-plan.md` is not the plan: do not present it as one and do not record an approval of it.

## Steps

1. **Pick the task.**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mhmtsrfglu/superwiki/sw-plan@sha256:4cc1699704037458

The line at the top of this page pins the label git:20261008.42c6752, 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_zhbht4s7h5fg6efz.svg)](https://markdownregistry.com/a/art_zhbht4s7h5fg6efz)

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

Versions

The registry has recorded 4 versions of this file, between Oct 5, 2026 and Oct 8, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261008.42c6752 latest2026-10-08 42c6752 10,258 BA view · diff
git:20261007.79a0d6e2026-10-07 79a0d6e 8,212 BA view · diff
git:20261006.585c2262026-10-06 585c226 7,650 BA view · diff
git:20261005.2da6a5f2026-10-05 2da6a5f 7,441 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 (10258 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

mhmtsrfglu/superwiki · 30 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zhbht4s7h5fg6efz
GET https://markdownregistry.com/api/v1/resolve?ref=mhmtsrfglu/superwiki/sw-plan
GET https://markdownregistry.com/api/v1/blob/4cc16997040374587d53f3a9e466eae0f376695a4547cae85ab848274248c271

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 mhmtsrfglu/superwiki

AGENTS.md AGENTS.md file
mhmtsrfglu/superwiki · AGENTS.md
git:20261015.e65e6c7 · audit A · 30 stars
CLAUDE.md CLAUDE.md file
mhmtsrfglu/superwiki · CLAUDE.md
git:20261005.6c37eac · audit B · 30 stars
DESIGN.md DESIGN.md file
mhmtsrfglu/superwiki · DESIGN.md
git:20261015.9415b7c · audit A · 30 stars
AGENTS.md@evals/e2e/fixture AGENTS.md file
mhmtsrfglu/superwiki · evals/e2e/fixture/AGENTS.md
git:20261015.e65e6c7 · audit A · 30 stars
CLAUDE.md@evals/e2e/fixture CLAUDE.md file
mhmtsrfglu/superwiki · evals/e2e/fixture/CLAUDE.md
git:20261007.ceee12d · audit B · 30 stars
sw-autopilot SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-autopilot/SKILL.md · Use when the user wants several Superwiki tasks worked through one after another without being asked at each step (run…
git:20261015.9415b7c · audit A · 30 stars
sw-brainstorm SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-brainstorm/SKILL.md · Use when the user has an idea to think through before it is a task, is not sure what to build or what is in scope…
git:20261008.42c6752 · audit A · 30 stars
sw-config SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-config/SKILL.md · Use when the user wants to choose or change which model plans, implements or reviews Superwiki tasks (opus, sonnet, gpt…
git:20261015.f0d6795 · audit A · 30 stars
sw-doctor SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-doctor/SKILL.md · Use when the user wants to make agent sessions lighter or cheaper to start, asks what fills the context window before…
git:20261008.42c6752 · audit A · 30 stars
sw-explain SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-explain/SKILL.md · Use when the user asks what a Superwiki task is for, why it exists, what it depends on, what it blocks or what changes…
git:20261015.e65e6c7 · audit A · 30 stars
sw-implement SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-implement/SKILL.md · Use when the user wants to implement, build, execute, start or continue a Superwiki task or its plan, or invokes…
git:20261031.2a014e1 · audit A · 30 stars
sw-index SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-index/SKILL.md · Use when the user wants the task list in docs/index.md refreshed, updated or rebuilt, says the index is out of date…
git:20261008.42c6752 · audit A · 30 stars

Every file in mhmtsrfglu/superwiki

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