wizard

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

Updated Feb 22, 2024
One-click install
npx skills add https://github.com/tlipoca9/dotfiles --skill wizard-tlipoca9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wizard
Source: https://github.com/tlipoca9/dotfiles/tree/main/home/dot_agents/skills/wizard
Command: npx skills add https://github.com/tlipoca9/dotfiles --skill wizard-tlipoca9

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 each URL, 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: A reusable bash library provides progress indicators, confirmation gates, cross-platform URL opening (including WSL), hidden secret entry, and a closing summary. - Automatic Value Persistence: Captured values are upserted idempotently into .env files and pushed to GitHub Actions secrets and variables via gh. - Use Case: When setting up Stripe for a project, the wizard opens the Stripe dashboard, prompts for the publishable and secret keys, writes them to .env, and sets the secret key as a GitHub Actions secret for CI. ## Quick Start Ask the AI to generate a wizard that walks you through configuring the API keys 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 automate manual setup steps for a project?▼

Generate a bash wizard that walks a human through each manual step: it opens the relevant URL, instructs what to click and copy, captures the value, and writes it to .env or GitHub secrets. Each stage is confirmed before moving on.

How to set GitHub Actions secrets from a script?▼

The wizard's set_secret helper pipes a value to gh secret set when the gh CLI is installed and authenticated. If gh is unavailable, it records the secret as skipped and warns you 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 to launch URLs in the user's browser. If no opener is found, it prints the URL for manual visiting.

When should I not use a setup wizard?▼

Do not use a wizard for steps the agent can perform itself; it is meant only for actions requiring a human, such as dashboard clicks or credential retrieval. Wizards are ephemeral by default and committed only for repeatable setup paths.

Can I re-run a wizard after stopping it midway?▼

Yes, the wizard is idempotent: on re-runs it offers existing .env values as defaults that Enter keeps, and write_env upserts keys rather than duplicating them. You can stop with Ctrl-C and resume later.