wizard

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

Updated Jan 19, 2023
One-click install
npx skills add https://github.com/inkfin/dotfiles --skill wizard-inkfin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/inkfin/dotfiles/tree/main/dot_agents/skills/exact_wizard
Command: npx skills add https://github.com/inkfin/dotfiles --skill wizard-inkfin

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 step-by-step interactive bash wizard that opens the right URLs, tells the human exactly what to click and copy, captures the values, and writes them where they belong. ## Core Features & Use Cases - Guided stage-by-stage flow: Each stage clears the screen, shows progress (e.g. Stage 2/5), opens the relevant URL cross-platform (including WSL), and gates on human confirmation. - Value capture and persistence: Hidden entry for secrets, idempotent .env upserts, and gh secret/gh variable writes for GitHub Actions CI, with a closing summary of everything configured. - Use Case: Setting up Stripe for a project — the wizard opens the Stripe dashboard API keys page, prompts for the publishable and secret keys, writes them to .env, and sets the secret key as a GitHub Actions secret referenced by CI workflows. ## Quick Start Ask the agent to generate a wizard that walks you through setting up the API keys and GitHub 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 automate a manual setup procedure with a bash script?

Generate a wizard script that breaks the procedure into stages: each stage opens the relevant URL, prints exact click-by-click instructions, prompts for the values to copy back, and writes them to .env or GitHub secrets. The template.sh library provides the stage, ask, write_env, and set_secret helpers.

How do I set GitHub Actions secrets from a script?

Use the gh CLI: pipe the value into gh secret set NAME, or use gh variable set for non-secret values. The wizard's set_secret helper does this automatically and falls back to a warning with manual instructions if gh is missing or unauthenticated.

Does the wizard work on WSL and macOS?

Yes. The open_url helper detects the platform and uses wslview or explorer.exe on WSL, xdg-open on Linux, and open on macOS. If no browser opener is found, it prints the URL for manual visiting.

Can I re-run a wizard after interrupting it?

Yes. The ask and ask_secret helpers read existing values from the .env file and offer them as defaults, so pressing Enter keeps previously captured values. The write_env helper upserts keys idempotently rather than duplicating lines.

When should I not use a setup wizard?

Do not use a wizard for steps the agent can perform itself, such as editing files or running local commands. Wizards are for steps only a human can do, like clicking through a third-party dashboard or approving an irreversible action.