wizard

Generate interactive bash wizards that walk humans through manual setup procedures and capture configuration values.

Updated Sep 20, 2024
One-click install
npx skills add https://github.com/AnasIsmai1/dotfiles --skill wizard-anasismai1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/AnasIsmai1/dotfiles/tree/main/agents/.agents/skills/wizard
Command: npx skills add https://github.com/AnasIsmai1/dotfiles --skill wizard-anasismai1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual setup procedures — third-party service configuration, one-off migrations, A-to-B state transitions — are tedious to perform by hand and tedious to re-explain every time. This Skill turns them into a guided bash script that opens each URL, tells the human exactly what to click and copy, captures the values, and writes them to .env files and GitHub Actions secrets. ## Core Features & Use Cases - Guided stage-by-stage UX: A reusable bash library provides progress with time-remaining estimates, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and a closing summary. - Value capture and persistence: Idempotent .env upserts plus gh secret/gh variable writes, with graceful fallback warnings when the GitHub CLI is unavailable. - Scoped authoring workflow: The Skill reads the repo first (.env files, README, docker-compose, CI workflows) to enumerate every required value, then maps each stage's exact click path before authoring the script. - Use Case: A project needs Stripe keys, a database URL, and three CI secrets configured. The wizard opens each dashboard page in order, captures each value with hidden input where appropriate, writes them to .env, sets the GitHub secrets CI references, and prints a summary of anything left to do by hand. ## Quick Start Ask the AI to use the wizard skill to build a setup script that walks a new developer through configuring all third-party services and environment variables for 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 my project?▼

Use the wizard skill to scope every manual step and captured value from your repo's .env files, README, and CI workflows, then author one stage per step using the provided template.sh library. The result is a bash script that opens URLs, prompts for values, and writes them to .env and GitHub secrets.

How do I automate GitHub Actions secrets setup from a script?▼

The wizard's set_secret helper pipes values to gh secret set, and set_var calls gh variable set for non-secret values. If the gh CLI is missing or unauthenticated, the script records a skip warning and tells the user the exact manual command to run later.

Does the wizard script work on WSL and macOS?▼

Yes, the open_url helper detects the platform and tries wslview, explorer.exe, xdg-open, and open in order, covering WSL, Linux, and macOS. If no browser opener is available, it prints the URL for manual visiting instead of failing.

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

Yes, the ask and ask_secret helpers read existing values from the .env file and offer them as defaults, so pressing Enter keeps previously saved values. The write_env helper is idempotent, replacing existing keys rather than duplicating them.

When should I commit a wizard script to the repository?▼

Wizards are ephemeral by default and meant for one run, then deletion. Commit the script only when it represents a repeatable setup path that future team members should run, and link it from the README so it replaces ad-hoc instructions.