wizard

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

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill wizard-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/j172/bid/tree/main/agent/skills/wizard
Command: npx skills add https://github.com/j172/bid --skill wizard-j172

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual procedures like third-party service setup, one-off migrations, and state transitions are tedious to perform by hand and tedious to re-explain to an AI every time, often resulting in missed steps, misplaced secrets, and inconsistent configuration. ## Core Features & Use Cases - Guided Procedure Authoring: Scopes every manual step and captured value by reading the repo (.env files, README, docker-compose, GitHub workflows) before writing anything. - Consistent Wizard UX: A fixed bash library provides progress with time-remaining, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, idempotent .env upserts, and gh secret/variable writes. - Use Case: A project needs Stripe configured for local dev and CI. The wizard opens the Stripe dashboard, tells the human exactly what to click and copy, captures the keys with hidden input, writes them to .env, and sets the GitHub Actions secret CI references. ## Quick Start Ask the AI to use the wizard skill to generate an interactive setup script that configures Stripe keys for local development and GitHub Actions.

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 third-party services?

Use the wizard skill to scope every manual step and captured value from your repo, then author one stage per step using the provided template.sh library. The generated bash script opens URLs, captures values, writes .env entries, and sets GitHub secrets.

How to automate GitHub Actions secrets setup from the command line?

The wizard's set_secret and set_var helpers use the gh CLI to set GitHub Actions secrets and variables. If gh is unavailable or unauthenticated, the script records the skipped item and tells the user to set it 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. If no browser opener exists, it prints the URL for manual visiting.

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 and replaces existing keys.

When should I commit a wizard script to the repository?

Wizards are ephemeral by default and meant for one run. Commit the script only when it represents a repeatable setup path, and link it from the README so future contributors run it instead of asking an AI.