wizard

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

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/kashman001/ai-workspace-template --skill wizard-kashman001
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/kashman001/ai-workspace-template/tree/main/skills/wizard
Command: npx skills add https://github.com/kashman001/ai-workspace-template --skill wizard-kashman001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual setup tasks like provisioning infrastructure, configuring credentials, or setting CI secrets require humans to click through dashboards and copy values, and re-explaining these steps to an AI every time is tedious and error-prone. ## Core Features & Use Cases - Guided Stage-by-Stage Scripts: Generates a bash wizard from a template with progress indicators, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and idempotent .env upserts. - Secret and Variable Management: Writes captured values to .env files and pushes GitHub Actions secrets and variables via the gh CLI, with graceful fallbacks when gh is unavailable. - Use Case: When setting up Stripe for a project, the wizard opens the dashboard, prompts for the publishable and secret keys, writes them to .env, and sets the CI secret — all with a closing summary of what was configured. ## Quick Start Ask the agent to create a wizard that walks you through setting up your Stripe API keys 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 bash setup wizard?▼

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 do I set GitHub Actions secrets from a bash script?▼

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

When should I use a wizard instead of doing setup manually?▼

Use a wizard for steps only a human can perform, such as clicking through third-party dashboards, revealing API keys, or approving irreversible actions. Do not use it for steps the agent can execute itself, and commit the script only when it is a repeatable setup path.

Does the wizard 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 navigation instead of failing.

What happens if I re-run the wizard after stopping midway?▼

The wizard is idempotent: ask and ask_secret offer existing .env values as defaults on re-runs, and write_env upserts keys rather than duplicating them. You can stop with Ctrl-C and resume later without losing saved values.