@orbweva/academy 0.2.0

package/docs/TROUBLESHOOTING.md

@@ -0,0 +1,108 @@
+# Installer Troubleshooting
+
+Issues specific to `@orbweva/academy`. For non-installer issues (a skill works but behaves unexpectedly, an MCP server won't connect, API key problems), see the [ORBWEVA program-level troubleshooting guide](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/TROUBLESHOOTING.md).
+
+## `npx @orbweva/academy` — command not found
+
+You probably don't have Node installed, or it's too old.
+
+```bash
+node --version
+```
+
+If this fails or shows v17 or lower, install Node LTS from [nodejs.org](https://nodejs.org/) or via `fnm`/`nvm`.
+
+## `npx` hangs on first use
+
+First-time `npx` has to download the package. On slow connections this can take 30–60 seconds before any output appears. If it's still silent after 2 minutes, try:
+
+```bash
+npm cache clean --force
+npx @orbweva/academy@latest
+```
+
+## `clone failed` for one or more repos
+
+Output shows:
+
+```
+[3/11] ORBWEVA/resume-skill ... clone failed
+```
+
+### Causes and fixes
+
+**Network / firewall** — corporate proxies sometimes block `github.com`. Test:
+
+```bash
+git clone --depth 1 https://github.com/ORBWEVA/resume-skill.git /tmp/test-clone
+```
+
+If that also fails, the issue is your network, not the installer. Try via a VPN or personal hotspot.
+
+**Rate-limited** — unauthenticated clone is subject to GitHub's IP-based limits. If you've cloned a lot in the last hour, wait 15 minutes or authenticate: `gh auth login` then re-run.
+
+**Repo renamed / made private** — unlikely but possible. Open an issue at https://github.com/ORBWEVA/academy/issues.
+
+## "Permission denied" writing to `~/.claude/skills`
+
+The install path has wrong ownership. Check:
+
+```bash
+ls -la ~/.claude/
+```
+
+If `~/.claude/` is owned by root (rare but happens when a tool was run with `sudo`), fix it:
+
+```bash
+sudo chown -R $(whoami) ~/.claude
+```
+
+Then re-run the installer.
+
+## `Unknown skill: discovery` in Claude Code after install
+
+The installer completed but Claude Code isn't seeing the skills.
+
+1. **Restart Claude Code.** Skills are loaded at startup. Close and reopen.
+2. **Confirm the install scope** — did you use `--local`? Local installs only show up when Claude Code is started *from that project directory*. Run `cd` to your project first, then `claude`.
+3. **Check the folder** — `ls ~/.claude/skills/discovery/SKILL.md` should exist. If not, the install silently skipped that skill. Re-run:
+   ```bash
+   npx @orbweva/academy@latest --track accelerator --yes --global
+   ```
+4. **Claude Code version** — very old versions of Claude Code may not autoload `~/.claude/skills/`. Update: `npm install -g @anthropic-ai/claude-code`.
+
+## `Unknown skill: X — Create a new one?` appears when you type `/discovery`
+
+This is Claude Code's built-in behavior when a command doesn't resolve. If you see this:
+
+- **Press `Esc`. Don't press Enter.** Pressing Enter creates a fake skill in `~/.claude/skills/X/` that masks future installs.
+- Check if you actually have the skill installed: `ls ~/.claude/skills/`.
+- If the skill directory exists but Claude still says Unknown, restart Claude Code.
+
+## "Planned" pack warnings
+
+Output shows:
+
+```
+⚠  Some pack repos are planned but not yet published:
+   • ORBWEVA/loka-pack (loka-integration)
+```
+
+This is expected. Pack repos are listed in `manifest.json` ahead of being published so the CLI's architecture stays stable. The installer skips planned repos gracefully. Once the repo is public, re-run the installer.
+
+## Installer crashes with a cryptic error
+
+Set the debug env var and re-run:
+
+```bash
+ORBWEVA_DEBUG=1 npx @orbweva/academy@latest
+```
+
+This prints a full stack trace. Include it when opening an issue at https://github.com/ORBWEVA/academy/issues.
+
+## Still stuck?
+
+- **Email:** support@orbweva.com
+- **GitHub issues:** https://github.com/ORBWEVA/academy/issues
+
+For non-installer program-level issues: https://github.com/ORBWEVA/accelerator-template/blob/main/docs/TROUBLESHOOTING.md

package/docs/USER-GUIDE.md

@@ -0,0 +1,188 @@
+# User Guide
+
+Long-form walkthrough of the `@orbweva/academy` installer.
+
+## Prerequisites
+
+Before running `npx @orbweva/academy`, you need:
+
+| Requirement | Verify with | If missing |
+|---|---|---|
+| **Node.js 18+** | `node --version` | Install LTS from [nodejs.org](https://nodejs.org/), or via `fnm`/`nvm` |
+| **git** | `git --version` | macOS: `xcode-select --install`; Windows: [git-scm.com](https://git-scm.com/download/win); Linux: `apt install git` |
+| **Claude Code** | `claude --version` | `npm install -g @anthropic-ai/claude-code` |
+
+That's it. The installer itself has **zero runtime dependencies** — everything else it needs, it shells out to.
+
+## The interactive flow
+
+Running `npx @orbweva/academy` (no flags) walks you through a short menu.
+
+### 1. Track selection
+
+```
+Which Academy track?:
+  1) Accelerator — 12-week cohort program — zero-to-one founders
+  2) Course — Self-paced founder fundamentals
+  3) Mentoring — 1:1 operator support for existing businesses
+  4) Founder — Lean founder base — for partner-delivered programs
+  5) Full Academy — All 11 ORBWEVA skill repos — no tradeoffs
+  Choice [1-5, default 1]: _
+```
+
+Press `Enter` for Accelerator, or type a number. One track per install.
+
+### 2. Specialization packs (stackable)
+
+```
+Add specialization packs? (optional, stackable)
+  Loka / LoLA — Build a business on the Loka living-textbook + LoLA avatar platform? [y/N]
+  Marketing Agency — Run a one-person (or small team) marketing agency? [y/N]
+  Web + Video Studio — Web design + video editing studio? [y/N]
+```
+
+Each prompt defaults to **N**. Answer `y` for the ones you want.
+
+### 3. Install scope
+
+```
+Install scope:
+  1) Global — ~/.claude/skills/ (recommended, all projects)
+  2) Local  — ./.claude/skills/ (current project only)
+  Choice [1-2, default 1]: _
+```
+
+**Global** is right for almost everyone. Use **Local** only if you want a specific project's Claude Code session to see different skills than your other projects.
+
+### 4. Required vs optional skills
+
+For every track, some skills are **required** (auto-installed) and some are **optional** (you're prompted).
+
+Required = always installed for that track. Optional = `Install <skill name> [Y/n]` per skill.
+
+### 5. Confirmation
+
+```
+Ready to install: 15 skills from 11 repos → ~/.claude/skills/
+Proceed? [Y/n] _
+```
+
+Press `Enter`.
+
+### 6. Clone + copy
+
+```
+[1/11] ORBWEVA/secure-setup ... ✓ 1 skill
+[2/11] ORBWEVA/orbweva-method ... ✓ 1 skill
+...
+[11/11] ORBWEVA/solo-agents ... ✓ 1 skill
+
+✓ Installed to /Users/you/.claude/skills
+```
+
+### 7. CLI tools
+
+The installer lists the CLI tools for your OS (brew on macOS, winget+scoop on Windows, apt on Linux) and prompts `Run now? [Y/n]` per command. Approved commands execute live in your terminal with full output; interactive commands like `gh auth login` work because child processes inherit your terminal.
+
+Use `--yes` to auto-approve every CLI command. Use `--no-run` to print them without executing, then run them yourself. Use `--skills-only` to skip CLI + MCP entirely.
+
+See [CLI-TOOLS.md](CLI-TOOLS.md) for per-OS detail and gotchas (Windows admin/non-admin PowerShell, EBADENGINE warnings, etc).
+
+### 8. MCP servers
+
+Same pattern — prompt per `claude mcp add <name> <command>`, run the approved ones. Servers needing env vars (e.g. Supabase's `SUPABASE_ACCESS_TOKEN`) register fine without the variable; you set the env var later in whatever shell you launch Claude Code from.
+
+See [MCP-SERVERS.md](MCP-SERVERS.md) for full reference.
+
+## Non-interactive mode
+
+Chain `--track`, `--pack`, `--yes`, `--global` to skip every prompt:
+
+```bash
+npx @orbweva/academy@latest --track accelerator --yes --global
+```
+
+Full examples:
+
+```bash
+# Accelerator, everything, global
+npx @orbweva/academy@latest --track accelerator --yes --global
+
+# Accelerator + Loka, everything, global
+npx @orbweva/academy@latest --track accelerator --pack loka --yes --global
+
+# Stack multiple packs
+npx @orbweva/academy@latest --track accelerator --pack marketing --pack web-video --yes --global
+
+# Partner-delivered, project-local
+npx @orbweva/academy@latest --track founder --yes --local
+
+# See what would happen without touching disk
+npx @orbweva/academy@latest --track full --dry-run --yes --global
+
+# Skip the post-install guidance prints (for CI / scripts)
+npx @orbweva/academy@latest --track accelerator --yes --global --skills-only
+```
+
+## All flags
+
+| Flag | Meaning |
+|---|---|
+| `-t, --track <name>` | Track: `accelerator`, `course`, `mentoring`, `founder`, `full` |
+| `-p, --pack <name>` | Pack: `loka`, `marketing`, `web-video` (repeatable) |
+| `-g, --global` | Install to `~/.claude/skills/` (all Claude Code projects) |
+| `-l, --local` | Install to `./.claude/skills/` (this project only) |
+| `-y, --yes` | Non-interactive: accept all defaults and install every optional skill |
+| `--skills-only` | Skip post-install CLI / MCP guidance prints |
+| `--dry-run` | Show the plan, touch nothing on disk |
+| `-h, --help` | Show help + list of available tracks and packs |
+
+## Verify your install
+
+```bash
+ls ~/.claude/skills/
+```
+
+You should see directories: `secure-setup/`, `core/`, `discovery/`, `design-thinking/`, `pitch/`, etc.
+
+In Claude Code:
+
+```
+/discovery:help
+```
+
+If this prints the customer-discovery command menu, you're done.
+
+If Claude says `Unknown skill` — see [TROUBLESHOOTING.md](TROUBLESHOOTING.md).
+
+## Update cycle
+
+Skills change. To refresh:
+
+```bash
+npx @orbweva/academy@latest
+```
+
+Same command. It re-clones each repo and overwrites existing `~/.claude/skills/<name>/` folders. Your per-project skills (in `./.claude/skills/`) are untouched unless you re-run with `--local`.
+
+## What the installer does NOT do
+
+- **Does not install Node, Git, or Claude Code.** You need those first.
+- **Does not run the CLI-tool `brew`/`winget`/`scoop` commands.** It prints them; you copy them.
+- **Does not run `claude mcp add` for you.** Same deal — prints, doesn't execute.
+- **Does not edit `~/.claude.json`** (the Claude Code config). Skills are read from `~/.claude/skills/` at the filesystem level — no config changes needed.
+- **Does not send any telemetry.**
+
+## Uninstall
+
+The installer doesn't provide an uninstall command. Skills are just directories — delete the ones you don't want:
+
+```bash
+rm -rf ~/.claude/skills/discovery
+```
+
+To remove everything the installer added:
+
+```bash
+rm -rf ~/.claude/skills/{secure-setup,core,resume,discovery,design-thinking,startup-metrics,pitch,hiring,legal-essentials,retention,geo,gtm-launch,seo-toolkit,solo,agents}
+```

package/docs/manual-update.md

@@ -0,0 +1,88 @@
+# Manual Install / Update
+
+If you can't run `npx @orbweva/academy` — air-gapped machine, npm blocked by corporate proxy, offline laptop — you can install the skills by hand. It's just `git clone` + copy.
+
+## Prerequisites
+
+- `git`
+- A shell (bash, zsh, or PowerShell)
+
+## One-time setup
+
+```bash
+mkdir -p ~/.claude/skills
+```
+
+On Windows: `~/.claude/skills` resolves to `%USERPROFILE%\.claude\skills\`.
+
+## Install all 11 public ORBWEVA skill repos
+
+Paste this whole block into your shell:
+
+```bash
+cd /tmp
+for repo in secure-setup orbweva-method resume-skill founder-discovery dt-skill founder-metrics founder-pitch founder-ops gtm-skills solo-skills solo-agents; do
+  git clone --depth 1 "https://github.com/ORBWEVA/$repo.git" "/tmp/orbweva-$repo"
+  # Each repo may contain one or more skills under skills/
+  for skill_dir in /tmp/orbweva-$repo/skills/*/; do
+    skill_name=$(basename "$skill_dir")
+    rm -rf ~/.claude/skills/$skill_name
+    cp -r "$skill_dir" ~/.claude/skills/$skill_name
+    echo "installed: $skill_name"
+  done
+  rm -rf "/tmp/orbweva-$repo"
+done
+```
+
+PowerShell equivalent:
+
+```powershell
+cd $env:TEMP
+$repos = @('secure-setup','orbweva-method','resume-skill','founder-discovery','dt-skill','founder-metrics','founder-pitch','founder-ops','gtm-skills','solo-skills','solo-agents')
+foreach ($repo in $repos) {
+  git clone --depth 1 "https://github.com/ORBWEVA/$repo.git" "$env:TEMP\orbweva-$repo"
+  Get-ChildItem "$env:TEMP\orbweva-$repo\skills" -Directory | ForEach-Object {
+    $dst = "$env:USERPROFILE\.claude\skills\$($_.Name)"
+    if (Test-Path $dst) { Remove-Item $dst -Recurse -Force }
+    Copy-Item $_.FullName $dst -Recurse
+    Write-Host "installed: $($_.Name)"
+  }
+  Remove-Item "$env:TEMP\orbweva-$repo" -Recurse -Force
+}
+```
+
+## Update
+
+The manual install command is idempotent — re-run it. It overwrites each skill directory with the latest clone.
+
+## Uninstall a specific skill
+
+```bash
+rm -rf ~/.claude/skills/<skill-name>
+```
+
+## Install only specific repos
+
+Trim the `repos` array to what you want. For the Accelerator track specifically:
+
+```bash
+# Accelerator required + optional (skip founder-ops if you don't need hiring/legal/retention)
+secure-setup orbweva-method resume-skill founder-discovery dt-skill \
+  founder-metrics gtm-skills founder-pitch founder-ops solo-skills solo-agents
+```
+
+For per-track skill lists, see [TRACKS.md](TRACKS.md).
+
+## Verify
+
+```bash
+ls ~/.claude/skills/
+```
+
+In Claude Code:
+
+```
+/discovery:help
+```
+
+Should show the customer-discovery command menu.

package/manifest.json

@@ -0,0 +1,78 @@
+{
+  "version": 1,
+  "skillRepos": {
+    "secure-setup":      { "repo": "ORBWEVA/secure-setup",      "skills": ["secure-setup"] },
+    "orbweva-method":    { "repo": "ORBWEVA/orbweva-method",    "skills": ["core"] },
+    "resume-skill":      { "repo": "ORBWEVA/resume-skill",      "skills": ["resume"] },
+    "founder-discovery": { "repo": "ORBWEVA/founder-discovery", "skills": ["discovery"] },
+    "dt-skill":          { "repo": "ORBWEVA/dt-skill",          "skills": ["design-thinking"] },
+    "founder-metrics":   { "repo": "ORBWEVA/founder-metrics",   "skills": ["startup-metrics"] },
+    "founder-pitch":     { "repo": "ORBWEVA/founder-pitch",     "skills": ["pitch"] },
+    "founder-ops":       { "repo": "ORBWEVA/founder-ops",       "skills": ["hiring", "legal-essentials", "retention"] },
+    "gtm-skills":        { "repo": "ORBWEVA/gtm-skills",        "skills": ["geo", "gtm-launch", "seo-toolkit"] },
+    "solo-skills":       { "repo": "ORBWEVA/solo-skills",       "skills": ["solo"] },
+    "solo-agents":       { "repo": "ORBWEVA/solo-agents",       "skills": ["agents"] },
+
+    "loka-pack":         { "repo": "ORBWEVA/loka-pack",         "skills": ["loka-integration"],             "status": "planned" },
+    "marketing-pack":    { "repo": "ORBWEVA/marketing-pack",    "skills": ["marketing-agency"],             "status": "planned" },
+    "web-video-pack":    { "repo": "ORBWEVA/web-video-pack",    "skills": ["web-design", "video-editing"],  "status": "planned" }
+  },
+  "tracks": {
+    "accelerator": {
+      "label": "Accelerator",
+      "tagline": "12-week cohort program — zero-to-one founders",
+      "required": ["secure-setup", "orbweva-method", "resume-skill", "founder-discovery", "dt-skill", "founder-metrics", "gtm-skills"],
+      "optional": ["founder-pitch", "founder-ops", "solo-skills", "solo-agents"]
+    },
+    "course": {
+      "label": "Course",
+      "tagline": "Self-paced founder fundamentals",
+      "required": ["secure-setup", "orbweva-method", "resume-skill", "founder-discovery", "dt-skill"],
+      "optional": ["founder-metrics", "gtm-skills"]
+    },
+    "mentoring": {
+      "label": "Mentoring",
+      "tagline": "1:1 operator support for existing businesses",
+      "required": ["secure-setup", "orbweva-method", "resume-skill", "founder-metrics", "founder-ops"],
+      "optional": ["founder-pitch", "gtm-skills", "solo-skills", "solo-agents"]
+    },
+    "founder": {
+      "label": "Founder",
+      "tagline": "Lean founder base — for partner-delivered programs (e.g. Headswitch)",
+      "required": ["secure-setup", "orbweva-method", "resume-skill", "founder-discovery", "dt-skill"],
+      "optional": ["founder-metrics", "founder-pitch", "gtm-skills"]
+    },
+    "full": {
+      "label": "Full Academy",
+      "tagline": "All 11 ORBWEVA skill repos — no tradeoffs",
+      "required": ["secure-setup", "orbweva-method", "resume-skill", "founder-discovery", "dt-skill", "founder-metrics", "founder-pitch", "founder-ops", "gtm-skills", "solo-skills", "solo-agents"],
+      "optional": []
+    }
+  },
+  "packs": {
+    "loka": {
+      "label": "Loka / LoLA",
+      "tagline": "Build a business on the Loka living-textbook + LoLA avatar platform",
+      "required": ["loka-pack"],
+      "optional": []
+    },
+    "marketing": {
+      "label": "Marketing Agency",
+      "tagline": "Run a one-person (or small team) marketing agency",
+      "required": ["marketing-pack"],
+      "optional": ["solo-skills", "solo-agents"]
+    },
+    "web-video": {
+      "label": "Web + Video Studio",
+      "tagline": "Web design + video editing studio",
+      "required": ["web-video-pack"],
+      "optional": ["solo-skills"]
+    }
+  },
+  "mcpServers": {
+    "supabase":   { "cmd": "npx -y @supabase/mcp-server-supabase",       "envKey": "SUPABASE_ACCESS_TOKEN", "required": true },
+    "context7":   { "cmd": "npx -y @upstash/context7-mcp",               "envKey": null,                    "required": true },
+    "playwright": { "cmd": "npx -y @playwright/mcp",                     "envKey": null,                    "required": false },
+    "memory":     { "cmd": "npx -y @modelcontextprotocol/server-memory", "envKey": null,                    "required": false }
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@orbweva/academy",
+  "version": "0.2.0",
+  "description": "One-command installer for ORBWEVA Academy — skills, MCP configs, and CLI tool guidance for Claude Code.",
+  "type": "module",
+  "bin": {
+    "orbweva-academy": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "docs",
+    "manifest.json",
+    "README.md",
+    "README.ja-JP.md",
+    "README.ko-KR.md",
+    "LICENSE",
+    "LICENSE-DOCS",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md"
+  ],
+  "homepage": "https://github.com/ORBWEVA/academy#readme",
+  "bugs": {
+    "url": "https://github.com/ORBWEVA/academy/issues"
+  },
+  "keywords": ["orbweva", "academy", "claude-code", "skills"],
+  "author": "ORBWEVA",
+  "license": "(MIT AND CC-BY-NC-SA-4.0)",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ORBWEVA/academy.git"
+  }
+}

package/src/banner.js

@@ -0,0 +1,13 @@
+import { c } from './color.js';
+
+export function banner() {
+  const art = [
+    '█████ ████  ████  █   █ █████ █   █  ███ ',
+    '█   █ █   █ █   █ █   █ █     █   █ █   █',
+    '█   █ ████  ████  █ █ █ ████  █   █ █████',
+    '█   █ █  █  █   █ ██ ██ █      █ █  █   █',
+    '█████ █   █ ████  █   █ █████   █   █   █',
+  ].join('\n');
+
+  return `\n${c.cyan(art)}\n\n${c.bold('ORBWEVA Academy')} — Claude Code skills installer\n`;
+}

package/src/cli-tools.js

@@ -0,0 +1,68 @@
+import { c } from './color.js';
+import { promptAndRun, summary } from './exec.js';
+
+const MAC = {
+  label: 'macOS',
+  steps: [
+    { cmd: 'brew install fnm gh supabase/tap/supabase', desc: 'Node manager + GitHub CLI + Supabase CLI (brew)' },
+    { cmd: 'fnm install --lts && fnm default lts-latest', desc: 'Install and default to LTS Node' },
+    { cmd: 'npm install -g pnpm vercel', desc: 'Install pnpm + Vercel CLI globally' },
+    { cmd: 'gh auth login', desc: 'Sign in to GitHub (interactive)', note: 'This is interactive — follow the browser prompts.' },
+  ],
+};
+
+const WIN = {
+  label: 'Windows',
+  intro: [
+    `${c.yellow('⚠ Read before running:')}`,
+    '  1. These commands assume you are in PowerShell.',
+    '  2. winget commands need Admin PowerShell. If a winget step fails, re-run in an Admin PowerShell window.',
+    '  3. scoop commands need regular (non-Admin) PowerShell.',
+    '  4. After each install, PATH may be stale — restart the window if you see "command not recognized".',
+    '  5. EBADENGINE warnings on "npm install -g" are harmless; ignore them.',
+  ].join('\n'),
+  steps: [
+    { cmd: 'winget install --id Schniz.fnm -e',         desc: 'Install fnm (Node version manager)', note: 'Needs Admin PowerShell.' },
+    { cmd: 'winget install --id GitHub.cli -e',         desc: 'Install GitHub CLI',                 note: 'Needs Admin PowerShell.' },
+    { cmd: 'fnm install --lts; fnm default lts-latest', desc: 'Install and default to LTS Node' },
+    { cmd: 'Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex', desc: 'Install Scoop package manager' },
+    { cmd: 'scoop install supabase',                    desc: 'Install Supabase CLI via Scoop' },
+    { cmd: 'npm install -g pnpm vercel',                desc: 'Install pnpm + Vercel CLI globally' },
+    { cmd: 'gh auth login',                             desc: 'Sign in to GitHub (interactive)', note: 'This is interactive — follow the browser prompts.' },
+  ],
+};
+
+const LINUX = {
+  label: 'Linux',
+  steps: [
+    { cmd: 'curl -fsSL https://fnm.vercel.app/install | bash', desc: 'Install fnm (Node version manager)' },
+    { cmd: 'fnm install --lts && fnm default lts-latest',      desc: 'Install and default to LTS Node' },
+    { cmd: 'sudo apt install -y gh',                           desc: 'Install GitHub CLI (Debian/Ubuntu)', note: 'If not Debian-based, see https://cli.github.com/manual/installation' },
+    { cmd: 'npm install -g pnpm vercel',                       desc: 'Install pnpm + Vercel CLI globally' },
+    { cmd: 'gh auth login',                                    desc: 'Sign in to GitHub (interactive)', note: 'This is interactive — follow the browser prompts.' },
+  ],
+};
+
+function profileFor(os) {
+  if (os.platform === 'darwin') return MAC;
+  if (os.platform === 'win32')  return WIN;
+  return LINUX;
+}
+
+export async function runCliSetup(os, { assumeYes, interactive }) {
+  const profile = profileFor(os);
+  console.log(`\n${c.bold('─── CLI tools')} ${c.dim(`(${profile.label})`)}`);
+  if (profile.intro) console.log(profile.intro);
+
+  if (!interactive) {
+    // Fallback to print-only mode (for --skills-only-ish callers).
+    for (const s of profile.steps) console.log(`  ${c.cyan('$')} ${s.cmd}`);
+    console.log(c.dim(`\n  Full reference: https://orbweva.com/en/accelerator/skills`));
+    return null;
+  }
+
+  const result = await promptAndRun(profile.steps, { assumeYes });
+  console.log(`\n  ${c.bold('CLI tools:')} ${summary(result)}`);
+  console.log(c.dim(`  Full reference: https://orbweva.com/en/accelerator/skills`));
+  return result;
+}