stacks-wizard

Generates interactive bash wizards that walk humans through manual credential and configuration procedures.

625|19|Updated Apr 26, 2022
One-click install
npx skills add https://github.com/stacksjs/stacks --skill stacks-wizard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacks-wizard
Source: https://github.com/stacksjs/stacks/tree/main/storage/framework/defaults/ai/skills/stacks-wizard
Command: npx skills add https://github.com/stacksjs/stacks --skill stacks-wizard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Some setup steps in a Stacks project cannot be automated by an agent: provisioning AWS credentials, verifying SES sending domains, changing registrar nameservers, or setting GitHub Actions secrets. 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 into .env files and GitHub secrets.

Core Features & Use Cases

  • Guided Stage-Based Wizards: Builds bash scripts with stage progress, confirmation gates, cross-platform URL opening (including WSL), hidden input for secrets, and idempotent .env upserts using a fixed template library.
  • Credential and Secret Capture: Writes captured values to .env via write_env and pushes CI-needed values to GitHub with gh secret set and gh variable set.
  • Stacks-Aware Scoping: Reads .env, config/services.ts, config/cloud.ts, and .github/workflows/* to determine exactly which values the wizard must produce, then finishes with buddy env:encrypt for credential encryption.
  • Use Case: You need AWS access keys, SES domain verification, and CI secrets configured before running buddy deploy. The Skill authors a wizard script that walks a human through each console, captures every value, and verifies the result with buddy env:check.

Quick Start

Ask the agent to create a wizard that walks me through setting up AWS credentials and GitHub secrets for deployment.

Frequently Asked Questions about stacks-wizard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate manual setup steps like AWS credentials and GitHub secrets?

Generate an interactive bash wizard that opens each console URL, prompts for each value with hidden input for secrets, and writes results to .env and GitHub secrets via the gh CLI. The wizard shows stage progress and confirms before irreversible actions.

What is the stacks-wizard skill used for?

It authors step-by-step bash wizards for procedures requiring a human in the loop, such as provisioning AWS access keys, verifying SES domains, changing registrar nameservers, and setting CI secrets referenced in .github/workflows files.

Does the wizard script work on WSL and macOS?

Yes. The template's open_url helper detects wslview, explorer.exe, xdg-open, and open in that order, so URLs open correctly on WSL, Linux, and macOS. It falls back to printing the URL if no browser opener is available.

How does the wizard store secrets securely?

Secret values are read with hidden terminal input via ask_secret, upserted into .env with write_env, and pushed to GitHub Actions with gh secret set. The final stage runs buddy env:encrypt so plaintext credentials are not left in .env.production.

When should I not use a wizard for setup tasks?

Do not use a wizard when the agent can perform the step itself through the Stacks CLI, such as buddy deploy or buddy cloud operations. Wizards are only for steps that genuinely require human action in a browser or third-party dashboard.