wizardlisted

> Source: [mattpocock/skills - engineering/wizard](https://github.com/mattpocock/skills/tree/main/skills/engineering/wizard) # Wizard A **wizard** is a bash script that walks a human through a manual procedure, step by step. It opens each URL and says exactly what to click and copy. It captures the values and writes them where they belong (`.env`, GitHub secrets). It confirms at every stage and shows how many stages are left. Typical jobs: configure third-party services, run a one-off migration, move the project from one state to another. The UX is already solved by [template.sh](template.sh): - stage-by-stage progress and a closing summary - confirmation gates - cross-platform URL opening (including WSL) - hidden secret entry - idempotent `.env` upserts and `gh secret` / `gh variable` writes Your job is only to scope the procedure and author its stages. The library above the `STAGES` marker is identical in every wizard. That consistency is the point: never hand-edit it. A wizard is ephemeral by default: built for one run, saved to a scratch or `scripts/` path, deleted when the job is done. Commit it only when the user wants a repeatable setup path in the repo. ## Process ### 1. Scope the procedure Work out every manual step the human must take and every value captured along the way. Read the repo first, do not ask cold: - For setup: `.env.example`, `README`, `docker-compose*`, framework config, and `.github/workflows/*`. Every `secrets.*` or `vars.*` reference is a