Skip to content
SkillMixed901 tokens in use

wizard

Generate an interactive bash wizard that walks a human through setup and migration steps only they can do.

328,764 stars on the repository MIT Licensemattpocock/skills · skills/engineering/wizard
claude plugin install mattpocock-skills@claude-plugins-official
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing wizard costs

60tokens idle
901tokens in use

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Counts are approximate, made offline with cl100k_base.

Model dependence Mixed

Script-ledMixedModel-led

Scripts do part of the work and the model's judgement does the rest.

This describes the skill's structure, how much of it is scripts. It does not say how well it works. Scripts: template.sh.

Touches

shelldetectedwrites filesdetectedcredentialsdetected

Declared tags come from the skill's frontmatter; detected ones from its scripts and code blocks. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure17/25
  • Examples6/15
  • Output15/15
  • Size15/15
  • Resources7/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Good
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    template.sh, line 9
  • Writes files−8

    does this on the machine, and the frontmatter does not say so

    template.sh, line 142
  • Reads credentials−15

    does this on the machine, and the frontmatter does not say so

    template.sh, line 186

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Excellent
  • Development activity96
  • Maintenance100
  • Community56
  • Maturity32
  • Momentum40

Wizard scopes a manual procedure, maps each stage’s journey, and authors a bash script from a fixed template. The script opens each URL, says what to click and copy, captures values, writes them to .env or GitHub secrets, confirms at every stage and shows how many stages remain.

It is meant for provisioning, credentials, CI secrets, unfamiliar dashboards and one-off migrations, and not for steps the agent can perform itself.

What You Get

  • A runnable bash script with stage-by-stage progress and confirmation gates
  • Hidden entry for secrets and idempotent .env upserts
  • GitHub secret and variable writes through gh
  • A closing summary of what was captured and where it went

Common Use Cases

  • Walk a teammate through setting up third-party service credentials
  • Set up CI secrets that every workflow reference needs
  • Run a one-off migration or cutover with confirmation before each irreversible action

What Makes It Unique

The interaction design is solved once in the template, so every wizard behaves the same way and the agent only authors stages. It requires a procedure scoped from the repo’s env files and workflows, instructs the agent to say so when it does not know a dashboard path, and verifies the script statically since it cannot be run end to end without a human.

Under The Hood

A SKILL.md plus template.sh, a bash library with helpers such as stage, ask_secret, open_url, write_env, set_secret and confirm. The agent copies the template, reads the repo’s env files, docker-compose files and GitHub workflows, writes stages, then runs bash -n and shellcheck and sets the executable bit. The finished script opens browsers, writes .env and calls gh secret and gh variable.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers