wizard

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

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/gmackie/agent-skills --skill wizard-gmackie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/gmackie/agent-skills/tree/main/skills/wizard
Command: npx skills add https://github.com/gmackie/agent-skills --skill wizard-gmackie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Some setup work—provisioning infrastructure, creating credentials, configuring CI secrets, navigating third-party dashboards—can only be done by a human, and re-explaining those steps every time is tedious and error-prone. This Skill turns any manual procedure into a step-by-step interactive bash wizard that opens the right URLs, captures values, and writes them where they belong. ## Core Features & Use Cases - Guided Stage-by-Stage Flow: A reusable bash library handles progress display, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and a closing summary. - Automatic Value Persistence: Captured values are upserted idempotently into .env files and pushed to GitHub Actions secrets and variables via gh. - Use Case: You need to onboard a project to Stripe. The wizard opens the Stripe dashboard API keys page, prompts for the publishable and secret keys, writes both to .env, and sets the secret key as a GitHub Actions secret for CI. ## Quick Start Ask the agent to generate a wizard that walks a human through setting up Stripe API keys and storing them in .env and GitHub secrets.

Frequently Asked Questions about wizard

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

FAQPage Schema
How do I create an interactive setup wizard in bash?▼

Copy the provided template.sh, replace the example stage with one stage block per manual step, and set TOTAL_STAGES to match. Use helpers like stage, open_url, ask, ask_secret, write_env, and set_secret to build the flow without editing the library code above the STAGES marker.

How to automate GitHub Actions secrets setup from a script?▼

Use the set_secret helper, which pipes a value to gh secret set when the gh CLI is installed and authenticated. If gh is unavailable, the wizard records the secret as skipped and warns the user to set it manually later.

When should I use a wizard instead of letting the agent do the setup?▼

Use a wizard only for steps a human must perform, such as clicking through a third-party dashboard, revealing API keys, or approving irreversible actions. Do not invoke it for steps the agent can execute itself, since the wizard blocks on human input and opens browser windows.

Does the wizard script work on WSL and macOS?▼

Yes, the open_url helper detects the platform and uses wslview, explorer.exe, xdg-open, or open as available. If no browser opener exists, it prints a warning with the URL so the user can visit it manually.

Can I re-run a wizard script after stopping halfway?▼

Yes, the ask and ask_secret helpers read existing values from the .env file and offer them as defaults, so pressing Enter keeps previously saved values. The write_env helper upserts keys idempotently, making re-runs safe.