wizard

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Some setup work — provisioning infrastructure, creating credentials, configuring CI secrets, navigating third-party dashboards, running one-off migrations — can only be done by a human, and re-explaining the steps every time is tedious and error-prone. This Skill turns those procedures into a guided, step-by-step bash script. ## Core Features & Use Cases - Guided stage-by-stage scripts: Generates a bash wizard from a reusable template with progress indicators, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and a closing summary. - Automatic value capture: Writes collected values idempotently to .env files and pushes CI secrets and variables to GitHub via gh secret/gh variable. - Repo-aware scoping: Reads .env.example, README, docker-compose, and GitHub workflows to enumerate every secrets.* and vars.* reference the wizard must produce. - Use Case: You need a new teammate to set up Stripe keys, a database URL, and three GitHub Actions secrets. The Skill authors a wizard that opens each dashboard, tells them exactly what to copy, stores the values, and confirms each stage. ## Quick Start Ask the agent to create a wizard that walks a human through setting up all credentials 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 create an interactive setup script for manual configuration steps?

Use this Skill to generate a bash wizard from its template: define one stage per manual step, and the built-in library handles screen clearing, progress display, URL opening, prompts, and a final summary. You only author the stages below the STAGES marker.

How to automate GitHub Actions secrets setup from a script?

The wizard template includes set_secret and set_var helpers that call the GitHub CLI (gh secret set / gh variable set). If gh is missing or unauthenticated, the wizard records a skip warning so the human can set the value manually later.

Does the wizard script work on WSL and macOS?

Yes. The open_url helper detects wslview, explorer.exe, xdg-open, and macOS open in that order, so URLs open in the user's browser across WSL, Linux, and macOS. Color output also degrades gracefully when the terminal lacks tput support.

Can the wizard handle re-runs without losing existing values?

Yes. The ask and ask_secret helpers read the current value from the .env file and offer it as a default, so pressing Enter keeps it. write_env performs an idempotent upsert, replacing only the matching KEY line.

When should I not use a setup wizard script?

Do not use it for steps the agent can perform itself, such as editing files or running commands directly. Wizards are for human-only actions like clicking through a third-party dashboard, accepting terms, or copying credentials from a browser.