wizard

Generate interactive bash wizards that walk humans through manual setup and migration procedures.

3|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/MaxWolf-01/agents --skill wizard-maxwolf-01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/MaxWolf-01/agents/tree/main/mx/skills/wizard
Command: npx skills add https://github.com/MaxWolf-01/agents --skill wizard-maxwolf-01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Some tasks—provisioning infrastructure, creating API credentials, configuring CI secrets, navigating third-party dashboards—can only be done by a human, and re-explaining them every time is tedious and error-prone. This Skill turns those procedures into a guided bash script that opens each URL, gives exact click-by-click instructions, captures the values, and writes them to .env files or GitHub secrets. ## Core Features & Use Cases - Guided Stage-Based Scripts: Authors one stage per manual step using a fixed library with progress display, confirmation gates, cross-platform URL opening (including WSL), and hidden secret entry. - Automatic Value Persistence: Captured values are upserted idempotently into .env files and pushed to GitHub Actions secrets and variables via gh, with a closing summary of everything configured. - Use Case: Setting up Stripe for a project—the wizard opens the Stripe dashboard, tells the human exactly where to find the publishable and secret keys, stores them in .env, and sets the secret key as a CI secret matching the workflow's secrets.* references. ## Quick Start Ask the agent to create a wizard that walks you through setting up the API keys and CI secrets required by this repository.

Frequently Asked Questions about wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate manual setup steps that require a human?

Create a bash wizard script that walks the human through each step: it opens the relevant URL, gives exact click instructions, captures pasted values, and writes them to .env files or GitHub secrets. Each stage shows progress and confirms before continuing.

How to set GitHub Actions secrets from a setup script?

Use the gh CLI with gh secret set NAME to push values as repository secrets. The wizard's set_secret helper does this automatically and falls back to a warning with manual instructions if gh is unavailable or unauthenticated.

Does the wizard script work on WSL and macOS?

Yes, the open_url helper detects the platform and uses wslview or explorer.exe on WSL, xdg-open on Linux, and open on macOS. If no browser opener is found, it prints the URL for manual visiting.

When should I not use a wizard script?

Do not use a wizard for steps the agent can perform itself, such as editing files or running commands. Wizards are only for procedures requiring human action, like clicking through a third-party dashboard or accepting terms in a browser.

Can a wizard script be reused across projects?

One-off wizards are saved to ~/Downloads and deleted after use. If the procedure is repeatable, such as a common setup other maintainers will run, commit it to the repository's scripts/ directory and link it from the README.