wizard

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual procedures like third-party service setup, one-off migrations, and state transitions are tedious to perform by hand and tedious to re-explain to an AI every time. This Skill generates a step-by-step bash wizard that opens the right URLs, tells the human exactly what to click and copy, captures values, and writes them to .env files and GitHub Actions secrets. ## Core Features & Use Cases - Guided Stage Authoring: Scopes every manual step and captured value by reading the repo (.env files, README, docker-compose, GitHub workflows) before writing the wizard. - Reusable Wizard Library: template.sh provides progress with time-remaining, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, idempotent .env upserts, and gh secret/variable writes. - Use Case: A project needs Stripe keys configured for local dev and CI. The wizard opens the Stripe dashboard, prompts for the publishable and secret keys, writes them to .env, and sets STRIPE_SECRET_KEY as a GitHub Actions secret matching the CI workflow reference. ## Quick Start Ask the AI to use the wizard skill to generate a setup wizard that configures Stripe API keys into .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 bash setup wizard?▼

Copy template.sh to the target path, replace the example stage with one stage per manual step, and set TOTAL_STAGES and TOTAL_MINUTES. Use the built-in helpers like stage, open_url, ask, ask_secret, write_env, and set_secret without editing the library above the STAGES marker.

How do I write values to .env files from a bash script?▼

Use the write_env helper, which upserts KEY=VALUE into the .env file idempotently by removing any existing line for that key and appending the new value. It creates the file if it does not exist and tracks written keys for the closing summary.

Can a bash script set GitHub Actions secrets automatically?▼

Yes, the set_secret helper pipes a value to gh secret set when the gh CLI is installed and authenticated. If gh is unavailable, it records a skip warning so the user can set the secret manually later.

Does the wizard open URLs on WSL or headless systems?▼

The open_url helper tries wslview, explorer.exe, xdg-open, and open in order, covering WSL, Linux, and macOS. If no browser opener is available, it prints a warning with the URL so the user can visit it manually.

When should I commit a generated wizard to the repository?▼

Wizards are ephemeral by default and meant for a single run from a scratch or scripts path. Commit one only when it represents a repeatable setup path that future team members should run instead of asking an AI.