wizard

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

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/CYRUS-pinto/pi-bot --skill wizard-cyrus-pinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/CYRUS-pinto/pi-bot/tree/main/.agents/skills/wizard
Command: npx skills add https://github.com/CYRUS-pinto/pi-bot --skill wizard-cyrus-pinto

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 to an AI every time. This Skill generates a bash wizard that walks a human through each step, captures values, and writes them where they belong. ## Core Features & Use Cases - Guided Stage-by-Stage Scripts: Generates a bash script from a fixed template with progress indicators, confirmation gates, cross-platform URL opening (including WSL), and hidden secret entry. - Value Capture and Persistence: Writes captured values to .env files idempotently and sets GitHub Actions secrets and variables via the gh CLI. - Use Case: When setting up a new project that needs Stripe API keys in .env and GitHub CI secrets, the wizard opens the Stripe dashboard, tells the human exactly what to click and copy, stores the keys, and confirms every stage. ## Quick Start Ask the agent to create a wizard that walks you through setting up your project's environment variables 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 automate manual setup steps for a new project?

Generate a bash wizard script that walks a human through each manual step: opening the right URLs, explaining what to click and copy, capturing values, and writing them to .env files or GitHub secrets. The wizard shows stage progress and confirms before irreversible actions.

How to set GitHub Actions secrets from a setup script?

Use the gh CLI with gh secret set to write repository secrets from a script. The wizard template wraps this in a set_secret helper that falls back to a warning with manual instructions if gh is unavailable or unauthenticated.

Does the wizard script work on WSL and macOS?

Yes, the template's open_url helper detects the platform and uses wslview, explorer.exe, xdg-open, or open as appropriate. Color output also degrades gracefully when the terminal lacks tput color support.

When should I not use a setup wizard script?

Do not use a wizard 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 credentials.

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.