wizard

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

10|3|Updated Jul 18, 2019
One-click install
npx skills add https://github.com/tanqimin/MyFavsORM --skill wizard-tanqimin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/tanqimin/MyFavsORM/tree/main/.agents/skills/wizard
Command: npx skills add https://github.com/tanqimin/MyFavsORM --skill wizard-tanqimin

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 turns those procedures into a guided, step-by-step bash wizard that captures values and writes them where they belong. ## Core Features & Use Cases - Guided Stage-by-Stage Scripts: Generates a bash wizard from a proven template with progress indicators, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and idempotent .env upserts. - Credential and Secret Capture: Walks the human through dashboards to copy API keys, then writes them to .env files and GitHub Actions secrets or variables via gh. - Use Case: When setting up Stripe for a project, the wizard opens the Stripe dashboard, tells the user exactly which keys to copy, stores them in .env, and pushes the secret key to GitHub Actions for CI. ## Quick Start Ask the agent to create a wizard that walks you through setting up your third-party API credentials and GitHub CI 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 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 to guide the user and capture values.

How to automate GitHub Actions secrets setup from a script?

The wizard's set_secret helper pipes a value to gh secret set, and set_var sets repository variables via gh variable set. If the gh CLI is unavailable or unauthenticated, the script records a skip warning so the user can set the secret manually later.

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. Color output also degrades gracefully when the terminal does not support tput colors.

Can I re-run the wizard if I stop halfway through?

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.

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 procedures only a human can do, like clicking through a third-party dashboard or approving an irreversible action.