wizard

Generate interactive Bash wizards that guide humans through manual setup procedures.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill wizard-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/dev/skills/engineering/wizard
Command: npx skills add https://github.com/reddb-io/red-skills --skill wizard-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Some setup steps cannot be automated by an agent: creating credentials, adding CI secrets, configuring third-party dashboards, provisioning services, or performing migrations and cutovers. This Skill generates a guided Bash wizard that walks one human through those manual procedures step by step. ## Core Features & Use Cases - Stage-Based Wizard Generation: Authors ordered stages below a STAGES marker in a reusable Bash template, using helpers like say, step, open_url, ask, ask_secret, write_env, set_secret, set_var, pause, and confirm. - Secret and Environment Capture: Opens the correct pages, captures pasted values with hidden input for secrets, writes .env entries, and sets GitHub secrets and variables matching workflow secrets.* references. - Static Verification: Validates generated scripts with bash -n and ShellCheck, traces every captured value to its write target, and places disposable wizards in .red/tmp/scratch/ or maintained ones in scripts/setup-<slug>.sh. - Use Case: When onboarding a project requires creating API tokens in a third-party dashboard and adding them to GitHub Actions secrets, generate a wizard that opens each page, prompts for each value, and persists everything in one guided run. ## Quick Start Ask the agent to generate a wizard for the manual setup steps in this project, such as collecting credentials and configuring GitHub secrets.

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 human action?▼

Generate an interactive Bash wizard that opens the correct pages, explains each action, and captures pasted values. The wizard writes .env entries and GitHub secrets while reporting progress through ordered stages.

How to collect GitHub Actions secrets through a script?▼

Use the wizard's set_secret and set_var helpers to send CI inputs to GitHub. Match each set_secret name to the corresponding secrets.* reference in your workflow files, and use hidden input when prompting for secret values.

When should I use a wizard instead of a fully automated script?▼

Use a wizard for steps only a human can perform, such as creating credentials, configuring third-party dashboards, provisioning services, or approving irreversible migration actions. Fully automatable steps do not need a wizard.

Where should generated wizard scripts be stored?▼

Place one-run disposable wizards in .red/tmp/scratch/<slug>/wizard.sh and delete them after use. Commit a wizard as scripts/setup-<slug>.sh only when the procedure is a repeatable project setup path, and link it from the owning README.

How do I verify a generated Bash wizard before running it?▼

Run bash -n on the script to check syntax and run shellcheck when available. Trace every captured value to its write target and confirm each secret name matches a workflow reference before handing the run command to the user.