wizard

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

Updated May 31, 2026
One-click install
npx skills add https://github.com/AlexanderNarbaev/agi --skill wizard-alexandernarbaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/AlexanderNarbaev/agi/tree/main/.opencode/skills/matt-pocock/wizard
Command: npx skills add https://github.com/AlexanderNarbaev/agi --skill wizard-alexandernarbaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual procedures like provisioning infrastructure, configuring third-party dashboards, setting CI secrets, or running one-off migrations are tedious to perform by hand and tedious to re-explain to an AI every time. This Skill turns those procedures into a guided, step-by-step bash script that a human runs once. ## Core Features & Use Cases - Guided stage-by-stage scripts: Generates a bash wizard from a reusable template with progress indicators, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and a closing summary. - Credential and secret capture: Writes values idempotently to .env files and pushes CI secrets and variables to GitHub via gh secret/gh variable. - Use Case: When setting up Stripe for a project, the wizard opens the dashboard, tells the human exactly which keys to copy, stores them in .env, and sets the secret key as a GitHub Actions secret for CI. ## Quick Start Ask the agent to create a wizard that walks you through setting up the credentials and CI secrets required by 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 bash setup wizard for my project?

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 to automate GitHub Actions secrets setup from a script?

The wizard's set_secret helper pushes values to GitHub Actions via the gh CLI, falling back to a warning if gh is unavailable. Every set_secret name should exactly match a secrets.* reference found in your workflow files.

Can the wizard open browser URLs on WSL or 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.

When should I not use a setup wizard script?

Do not use it for steps the agent can perform itself, since wizards exist only for actions requiring a human. Also avoid committing one-off wizards; they are ephemeral unless the team wants a repeatable setup path.

How do I verify a generated wizard script before running it?

Run bash -n for syntax checking and shellcheck if available, then trace it statically to confirm every captured value lands where planned. Do not run it end-to-end yourself because it opens browsers and blocks on human input.