wizard

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

Updated May 9, 2024
One-click install
npx skills add https://github.com/AceCodePt/dotfiles --skill wizard-acecodept
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/AceCodePt/dotfiles/tree/main/.config/opencode/skills/wizard
Command: npx skills add https://github.com/AceCodePt/dotfiles --skill wizard-acecodept

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual setup procedures like provisioning infrastructure, configuring third-party dashboards, or setting CI secrets are tedious to perform by hand and tedious to re-explain every time. This Skill generates a step-by-step interactive bash wizard that opens the right URLs, tells the human exactly what to click and copy, captures the values, and writes them where they belong. ## Core Features & Use Cases - Guided Stage-by-Stage Flow: A reusable bash library provides progress indicators, 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 via gh secret and gh variable. - Use Case: When setting up Stripe for a project, the wizard opens the Stripe dashboard, prompts for the publishable and secret keys, writes them 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 you through setting up the API keys and GitHub 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 wizard in bash?▼

Copy the provided template.sh, replace the example stage with one stage per manual step, and set TOTAL_STAGES to match. 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 to automate setting GitHub Actions secrets 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 reminds the user to set it manually at the end.

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.

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 the URL for manual visiting.

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

Yes, the wizard is idempotent. The ask and ask_secret helpers offer existing .env values as defaults on re-runs, and write_env upserts keys rather than duplicating them, so you can stop with Ctrl-C and resume later.