@orbweva/academy 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to `@orbweva/academy` will be documented here. Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] — 2026-04-14
+
+### Added
+- **Auto-install for CLI tools and MCP servers.** After skills land, the installer now prompts Y/n per CLI command (brew/winget/scoop/npm, `gh auth login`, etc.) and per `claude mcp add`, then actually runs the ones you approve. Previously it only printed the commands.
+- `--no-run` flag for users who want the old print-only behavior.
+- `--yes` now auto-approves every CLI and MCP command in addition to skill choices.
+
+### Changed
+- `--skills-only` now fully skips the CLI + MCP section (previously it printed guidance and stopped).
+- Re-licensed to dual MIT + CC BY-NC-SA 4.0 to match the broader ORBWEVA ecosystem. Code is MIT; docs and prose are CC BY-NC-SA 4.0. See `LICENSE` and `LICENSE-DOCS`.
+- Windows CLI steps now use explicit `winget install --id <pkg> -e` form and `Set-ExecutionPolicy … -Force` for the Scoop bootstrap.
+
+### Notes
+- Interactive commands (`gh auth login`) work because child processes inherit stdio — follow the browser prompts as usual.
+- Windows admin steps (`winget install …`) fail if Node was launched from non-Admin PowerShell. Re-run those from an Admin window, or use `--no-run` and run manually.
+
+## [0.1.0] — 2026-04-14
+
+### Added
+- Initial public release.
+- `npx @orbweva/academy` installer CLI with zero runtime dependencies (Node 18+, `git` required at install time).
+- **Tracks**: `accelerator` (12-week cohort, 15 skills), `course` (self-paced, 9 skills), `mentoring` (1:1, 13 skills), `founder` (partner-delivered, 10 skills), `full` (everything).
+- **Specialization packs** (architecture ready; repos planned): `loka`, `marketing`, `web-video`.
+- Bundle composition: track + stackable packs, auto-deduped across shared repos.
+- Interactive prompts with `--yes` non-interactive mode.
+- Flags: `--track`, `--pack` (repeatable), `--global`, `--local`, `--skills-only`, `--dry-run`, `--help`.
+- Post-install guidance: per-OS CLI tool commands (`brew`/`winget`/`scoop`) and `claude mcp add` suggestions.
+- Pulls 11 public ORBWEVA skill repos via shallow git clone into `~/.claude/skills/` (or project-local `./.claude/skills/`).
+- Graceful skip for `status: "planned"` repos that don't exist yet.
+
+### Known limitations
+- Prereqs (Node, Git, Claude Code) are not auto-installed — the script assumes they're present.
+- CLI tools and MCP servers are printed, not executed. Auto-run planned for a later release.
+- Pack repos (`ORBWEVA/loka-pack`, `ORBWEVA/marketing-pack`, `ORBWEVA/web-video-pack`) are referenced in `manifest.json` but not yet published.

package/CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing to @orbweva/academy
+
+This installer is deliberately small. Most changes are **one-line edits to `manifest.json`** — no code changes required.
+
+## Adding a new track
+
+A track is a base program (Accelerator, Course, Mentoring, etc.). To add one:
+
+1. Open `manifest.json`.
+2. Add an entry under `tracks`:
+   ```json
+   "your-track-key": {
+     "label": "Your Track Name",
+     "tagline": "One-line description shown in menus",
+     "required": ["secure-setup", "orbweva-method", "..."],
+     "optional": ["founder-pitch", "..."]
+   }
+   ```
+3. `required` and `optional` reference keys from `skillRepos` (existing entries). Don't invent new repo keys unless you also add them to `skillRepos`.
+4. Run `node bin/install.js --help` — your new track should appear in the help output.
+5. Dry-run: `node bin/install.js --track your-track-key --dry-run --yes --global`.
+
+## Adding a new specialization pack
+
+Packs are stackable add-ons to tracks (e.g., `--pack marketing`). Same pattern:
+
+1. Under `packs` in `manifest.json`:
+   ```json
+   "your-pack-key": {
+     "label": "Your Pack Name",
+     "tagline": "One-line description",
+     "required": ["..."],
+     "optional": ["..."]
+   }
+   ```
+2. If the pack references a repo that doesn't exist yet, add it to `skillRepos` with `"status": "planned"` so the installer skips it gracefully until the repo is published.
+
+## Adding a new skill repo
+
+If a new skill lives in a brand-new ORBWEVA repo:
+
+1. Make sure the repo is **public** and has this layout:
+   ```
+   skills/<skill-name>/SKILL.md
+   ```
+2. Add to `skillRepos` in `manifest.json`:
+   ```json
+   "your-repo-key": {
+     "repo": "ORBWEVA/your-repo-name",
+     "skills": ["skill-name-1", "skill-name-2"]
+   }
+   ```
+3. Reference it from one or more `tracks` or `packs`.
+
+## Testing locally
+
+```bash
+# Verify parsing + help renders
+node bin/install.js --help
+
+# Dry-run the flow
+node bin/install.js --track accelerator --dry-run --yes --global
+
+# Full install into a sandboxed HOME (won't touch your real ~/.claude/)
+HOME=/tmp/academy-test node bin/install.js --yes --global --skills-only --track accelerator
+ls /tmp/academy-test/.claude/skills/
+```
+
+## PR guidelines
+
+- **One change per PR** where possible (new track + new pack should be two PRs).
+- **Update `CHANGELOG.md`** under `[Unreleased]` with the change.
+- **Commit style**: imperative mood, explain *why* not *what* in the body.
+
+## Questions
+
+Open an issue at https://github.com/ORBWEVA/academy/issues or ping @orbweva on X.

package/LICENSE

@@ -0,0 +1,43 @@
+ORBWEVA Academy CLI — Dual License
+===================================
+
+This repository is dual-licensed to match ORBWEVA's broader licensing posture:
+
+1. **Source code** — `bin/`, `src/`, `manifest.json`, and any other executable
+   or configuration files — is licensed under **the MIT License** (see below).
+
+2. **Documentation and prose** — `README.md`, `README.ja-JP.md`, `README.ko-KR.md`,
+   `CHANGELOG.md`, `CONTRIBUTING.md`, `SECURITY.md`, and everything under `docs/` —
+   is licensed under **Creative Commons Attribution-NonCommercial-ShareAlike 4.0
+   International (CC BY-NC-SA 4.0)**. See `LICENSE-DOCS` for full terms.
+
+The installed skills themselves live in separate ORBWEVA repositories, each
+carrying its own `LICENSE` (typically CC BY-NC-SA 4.0). This installer does not
+relicense them — it merely copies their files into your Claude Code skills
+directory.
+
+If you have questions about reuse or permissions, contact legal@orbweva.com.
+
+-------------------------------------------------------------------------------
+MIT License (applies to source code only)
+-------------------------------------------------------------------------------
+
+Copyright (c) 2026 ORBWEVA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated configuration files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE-DOCS

@@ -0,0 +1,35 @@
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
+
+Copyright (c) 2026 ORBWEVA
+
+This license applies to the **documentation and prose** in this repository:
+README.md, README.ja-JP.md, README.ko-KR.md, CHANGELOG.md, CONTRIBUTING.md,
+SECURITY.md, and everything under docs/. Source code (bin/, src/, manifest.json)
+is licensed separately under the MIT License — see LICENSE.
+
+You are free to:
+
+- **Share** — copy and redistribute the material in any medium or format
+- **Adapt** — remix, transform, and build upon the material
+
+Under the following terms:
+
+- **Attribution** — You must give appropriate credit to ORBWEVA, provide a
+  link to the license, and indicate if changes were made. You may do so in
+  any reasonable manner, but not in any way that suggests the licensor
+  endorses you or your use.
+
+- **NonCommercial** — You may not use the material for commercial purposes
+  without explicit written permission from ORBWEVA.
+
+- **ShareAlike** — If you remix, transform, or build upon the material,
+  you must distribute your contributions under the same license as the
+  original.
+
+- **No additional restrictions** — You may not apply legal terms or
+  technological measures that legally restrict others from doing anything
+  the license permits.
+
+Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
+
+For commercial licensing inquiries, contact legal@orbweva.com.

package/README.ja-JP.md

@@ -0,0 +1,156 @@
+<div align="center">
+
+# @orbweva/academy
+
+[English](README.md) · **日本語** · [한국어](README.ko-KR.md)
+
+ファウンダーに必要なORBWEVA Claude Codeスキルを、1つのコマンドでインストール。
+
+```
+npx @orbweva/academy@latest
+```
+
+**macOS、Windows、Linux**で動作。Node 18+、ランタイム依存ゼロ。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![ORBWEVA Academy](https://img.shields.io/badge/ORBWEVA-Academy-1f6feb.svg)](https://orbweva.com/ja/accelerator/skills)
+
+[なぜ存在するのか](#なぜ存在するのか) · [クイックスタート](#クイックスタート) · [トラック](#トラック) · [スペシャライゼーションパック](#スペシャライゼーションパック) · [関連ドキュメント](#関連ドキュメント)
+
+</div>
+
+---
+
+## なぜ存在するのか
+
+ORBWEVAの生徒が最初にやることは、22個のスラッシュコマンドを順番に入力することでした。`/plugin marketplace add …` の後に `/plugin install …` を11回。順番を間違えると `Unknown skill: discovery — Create a new one?` が表示され、反射的にEnterを押すと偽のスキルが作成され、エラーメッセージも出ません。Windowsでは、管理者権限の `winget` と非管理者権限の `scoop` のために2つのPowerShellウィンドウが必要で、`EBADENGINE` 警告は無害だが「'gh' が認識されない」はPATHが古いだけ、と気づくまで半分のインストールが失敗し続けます。
+
+誰も望まない通過儀礼でした。だからこれを作りました。
+
+**このツールができること** — 22個の `/plugin …` コマンドを1つの `npx` 呼び出しに置き換えます。公開されている11個のORBWEVAスキルリポジトリをシャロークローンし、`skills/<name>/` ディレクトリを `~/.claude/skills/` にコピー、その後まだ必要なプラットフォーム固有のCLIツールとMCPサーバーコマンドを表示します。ランタイム依存ゼロ。Node 18+と `git` のみが前提条件です。
+
+## 対象ユーザー
+
+- **ORBWEVA Acceleratorの受講生** — 12週間のコホートプログラム
+- **ファウンダートラックのパートナー** — クライアントに軽量なファウンダーベースを再販する代理店など
+- **メンタリングクライアント** — 1:1のオペレーターサポートを受けている既存ビジネス
+- **セルフペース学習者** — Courseトラック
+- **スペシャリスト** — トラックに垂直方向のスキルを重ねる人（Lokaエコシステム、マーケティング代理店、Web+ビデオスタジオ）
+
+どれにも当てはまらないがスキルは欲しい場合は、`--track full` を実行してください。
+
+## クイックスタート
+
+```bash
+# メニューからトラックを選択し、いくつかのプロンプトに答える
+npx @orbweva/academy@latest
+
+# 特定のトラックに直接行き、オプションスキルごとにプロンプト
+npx @orbweva/academy@latest --track accelerator
+
+# 完全に非対話モード（全デフォルト、全オプションスキル、グローバル）
+npx @orbweva/academy@latest --track accelerator --yes --global
+
+# トラックの上にスペシャライゼーションを重ねる
+npx @orbweva/academy@latest --track accelerator --pack loka
+npx @orbweva/academy@latest --track accelerator --pack marketing --pack web-video
+
+# パートナー提供型の軽量ファウンダーベース（Acceleratorのオーバーヘッドなし）
+npx @orbweva/academy@latest --track founder
+```
+
+## トラック
+
+1つのベースプログラムを選択。トラックごとの詳細は [docs/TRACKS.md](docs/TRACKS.md) を参照。
+
+| トラック | 対象 | スキル数 |
+|---|---|---|
+| `accelerator` | 12週間コホート — ゼロから一へのファウンダー | 15 |
+| `course` | セルフペースのファウンダー基礎 | 9 |
+| `mentoring` | 既存ビジネス向け1:1オペレーターサポート | 13 |
+| `founder` | パートナー提供型プログラムの軽量ベース（代理店、リセラー） | 10 |
+| `full` | すべて — トレードオフなし | 15 |
+
+## スペシャライゼーションパック
+
+どのトラックにも重ねて使用可能。[docs/PACKS.md](docs/PACKS.md) 参照。
+
+| パック | 対象 | ステータス |
+|---|---|---|
+| `loka` | Loka living-textbook + LoLAアバタープラットフォーム上のビジネス | 計画中 |
+| `marketing` | 1人（または小チーム）のマーケティング代理店 | 計画中 |
+| `web-video` | Webデザイン + ビデオ編集スタジオ | 計画中 |
+
+> パックリポジトリは `manifest.json` でステージングされていますが、まだ公開されていません。リポジトリが公開されるまで、インストーラーは計画中のパックを優雅にスキップします。
+
+## インストールされる内容
+
+インストーラーはトラック + 追加したパックからスキルセットを構成し、関連する公開ORBWEVAリポジトリをClaude Codeのスキルフォルダにクローンします。
+
+**すべてのスキルとコマンドのフェーズ別カタログ** — [ORBWEVA Accelerator Skills Reference](https://orbweva.com/ja/accelerator/skills) を参照してください。これが正式な情報源です。ここでは重複させません。
+
+## インストールの確認
+
+インストーラーが完了したら、Claude Codeを開いて実行:
+
+```
+/discovery:help
+```
+
+カスタマーディスカバリーのコマンドメニューが表示されるはずです。`Unknown skill` と表示される場合は [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) を参照。
+
+## 更新の維持
+
+ワンライナーを再実行:
+
+```bash
+npx @orbweva/academy@latest
+```
+
+各リポジトリを再クローンし、既存のスキルフォルダを上書きします。エアギャップまたはnpmなしの環境については [docs/manual-update.md](docs/manual-update.md) を参照。
+
+## すべてのフラグ
+
+| フラグ | 意味 |
+|---|---|
+| `-t, --track <name>` | トラック選択: `accelerator`, `course`, `mentoring`, `founder`, `full` |
+| `-p, --pack <name>` | スペシャライゼーションパックを追加（繰り返し可能） |
+| `-g, --global` | `~/.claude/skills/` にインストール |
+| `-l, --local` | `./.claude/skills/` にインストール |
+| `-y, --yes` | 全デフォルトを受け入れ、CLI/MCPコマンドも全て自動実行、プロンプトなし |
+| `--skills-only` | スキルのみインストール、CLI + MCPセットアップは完全にスキップ |
+| `--no-run` | CLI + MCPコマンドを表示するが実行しない。スキルはインストールされる。 |
+| `--dry-run` | 予定を表示、ディスクには触れない |
+| `-h, --help` | ヘルプを表示 |
+
+## 関連ドキュメント
+
+**このリポジトリ内:**
+- [docs/USER-GUIDE.md](docs/USER-GUIDE.md) — 全フラグの組み合わせを含む詳細ウォークスルー
+- [docs/TRACKS.md](docs/TRACKS.md) — トラックごとの詳細
+- [docs/PACKS.md](docs/PACKS.md) — スペシャライゼーションパックの構造 + 追加方法
+- [docs/CLI-TOOLS.md](docs/CLI-TOOLS.md) — OS別CLIインストールリファレンス（Windowsの落とし穴を含む）
+- [docs/MCP-SERVERS.md](docs/MCP-SERVERS.md) — トラック別MCPサーバー設定
+- [docs/manual-update.md](docs/manual-update.md) — npmなし環境向けフォールバックインストール
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — インストーラー固有の問題
+
+**ORBWEVAエコシステム内:**
+- [ORBWEVA Accelerator Skills Reference](https://orbweva.com/ja/accelerator/skills) — スキル + コマンドのフェーズ別正式カタログ
+- [Accelerator Curriculum Template](https://github.com/ORBWEVA/accelerator-template) — 12週間プログラムガイド
+- [プログラムトラブルシューティングガイド](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/TROUBLESHOOTING.md) — インストーラー以外の問題（セッション中のスキル失敗、APIキーなど）
+- [卒業基準](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/GRADUATION_CRITERIA.md) — Acceleratorの「完了」の定義
+
+## コントリビュート
+
+トラック、パック、スキルリポジトリの追加は [CONTRIBUTING.md](CONTRIBUTING.md) 参照。ほとんどの変更は `manifest.json` の1行編集です。
+
+## ライセンス
+
+ORBWEVAエコシステムに合わせてデュアルライセンス:
+
+- **ソースコード** (`bin/`, `src/`, `manifest.json`) — [MIT](LICENSE)
+- **ドキュメントとプロース** (READMEファイル、`docs/`、`CHANGELOG` など) — [CC BY-NC-SA 4.0](LICENSE-DOCS)
+
+インストールされるスキルは個別のORBWEVAリポジトリにあり、それぞれ独自のライセンス（通常CC BY-NC-SA 4.0）に従います。このインストーラーは再ライセンスしません。
+
+© 2026 ORBWEVA. 商用利用のお問い合わせ: legal@orbweva.com.

package/README.ko-KR.md

@@ -0,0 +1,156 @@
+<div align="center">
+
+# @orbweva/academy
+
+[English](README.md) · [日本語](README.ja-JP.md) · **한국어**
+
+파운더가 필요한 모든 ORBWEVA Claude Code 스킬을 명령어 하나로 설치.
+
+```
+npx @orbweva/academy@latest
+```
+
+**macOS, Windows, Linux**에서 작동. Node 18+, 런타임 의존성 없음.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![ORBWEVA Academy](https://img.shields.io/badge/ORBWEVA-Academy-1f6feb.svg)](https://orbweva.com/ko/accelerator/skills)
+
+[존재 이유](#존재-이유) · [빠른 시작](#빠른-시작) · [트랙](#트랙) · [스페셜라이제이션 팩](#스페셜라이제이션-팩) · [관련 문서](#관련-문서)
+
+</div>
+
+---
+
+## 존재 이유
+
+ORBWEVA 수강생이 제일 먼저 하는 일은 22개의 슬래시 명령어를 순서대로 입력하는 것이었습니다. `/plugin marketplace add …` 다음 `/plugin install …`, 11번 반복. 순서를 틀리면 `Unknown skill: discovery — Create a new one?`이 뜨고, 반사적으로 Enter를 누르면 가짜 스킬이 생성되며 오류 메시지도 없습니다. Windows에서는 관리자 권한 `winget`용과 비관리자 권한 `scoop`용 PowerShell 창 두 개가 동시에 필요하고, `EBADENGINE` 경고는 무해하지만 "'gh'를 인식할 수 없다"는 단순히 PATH가 갱신되지 않았다는 것을 깨닫기 전까지 절반이 조용히 실패합니다.
+
+아무도 원치 않는 통과 의례였습니다. 그래서 이걸 만들었습니다.
+
+**이 도구가 하는 일** — 22개의 `/plugin …` 명령어를 하나의 `npx` 호출로 대체합니다. 11개의 공개 ORBWEVA 스킬 저장소를 얕게 클론하고, `skills/<name>/` 디렉터리를 `~/.claude/skills/`로 복사한 뒤, 여전히 필요한 플랫폼별 CLI 도구와 MCP 서버 명령어를 출력합니다. 런타임 의존성 없음. Node 18+와 `git`만 있으면 됩니다.
+
+## 대상 사용자
+
+- **ORBWEVA Accelerator 수강생** — 12주 코호트 프로그램
+- **파운더 트랙 파트너** — 고객에게 경량 파운더 베이스를 재판매하는 에이전시 등
+- **멘토링 고객** — 1:1 운영자 지원을 받는 기존 비즈니스
+- **자율 학습자** — Course 트랙
+- **스페셜리스트** — 트랙 위에 수직 영역을 쌓는 사용자 (Loka 생태계, 마케팅 에이전시, 웹+비디오 스튜디오)
+
+위에 해당하지 않지만 스킬이 필요하면 `--track full`을 실행하세요.
+
+## 빠른 시작
+
+```bash
+# 메뉴에서 트랙 선택, 몇 가지 프롬프트에 답변
+npx @orbweva/academy@latest
+
+# 특정 트랙으로 직행, 옵션 스킬별 프롬프트
+npx @orbweva/academy@latest --track accelerator
+
+# 완전 비대화형 (모든 기본값, 모든 옵션 스킬, 글로벌)
+npx @orbweva/academy@latest --track accelerator --yes --global
+
+# 트랙 위에 스페셜라이제이션 쌓기
+npx @orbweva/academy@latest --track accelerator --pack loka
+npx @orbweva/academy@latest --track accelerator --pack marketing --pack web-video
+
+# 파트너 제공 경량 파운더 베이스 (Accelerator 오버헤드 없음)
+npx @orbweva/academy@latest --track founder
+```
+
+## 트랙
+
+베이스 프로그램 하나 선택. 트랙별 상세는 [docs/TRACKS.md](docs/TRACKS.md) 참조.
+
+| 트랙 | 대상 | 스킬 수 |
+|---|---|---|
+| `accelerator` | 12주 코호트 — 제로투원 파운더 | 15 |
+| `course` | 자율 학습 파운더 기본기 | 9 |
+| `mentoring` | 기존 비즈니스를 위한 1:1 운영자 지원 | 13 |
+| `founder` | 파트너 제공 프로그램용 경량 베이스 (에이전시, 리셀러) | 10 |
+| `full` | 전체 — 트레이드오프 없음 | 15 |
+
+## 스페셜라이제이션 팩
+
+어떤 트랙 위에도 쌓을 수 있습니다. [docs/PACKS.md](docs/PACKS.md) 참조.
+
+| 팩 | 대상 | 상태 |
+|---|---|---|
+| `loka` | Loka living-textbook + LoLA 아바타 플랫폼 위 비즈니스 | 계획 중 |
+| `marketing` | 1인 (또는 소규모 팀) 마케팅 에이전시 | 계획 중 |
+| `web-video` | 웹 디자인 + 비디오 편집 스튜디오 | 계획 중 |
+
+> 팩 저장소는 `manifest.json`에 스테이징되어 있지만 아직 공개되지 않았습니다. 저장소가 공개되기 전까지 설치 관리자는 계획 중인 팩을 우아하게 건너뜁니다.
+
+## 설치되는 것
+
+설치 관리자는 트랙 + 추가한 팩으로 스킬 세트를 구성하고 관련 공개 ORBWEVA 저장소를 Claude Code 스킬 폴더에 클론합니다.
+
+**모든 스킬과 명령어의 페이즈별 카탈로그**는 [ORBWEVA Accelerator Skills Reference](https://orbweva.com/ko/accelerator/skills)를 참조. 그게 공식 출처이며, 여기서는 중복하지 않습니다.
+
+## 설치 확인
+
+설치 관리자가 끝나면 Claude Code를 열고 실행:
+
+```
+/discovery:help
+```
+
+고객 발견 명령어 메뉴가 나타나야 합니다. Claude가 `Unknown skill`이라고 하면 [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) 참조.
+
+## 최신 상태 유지
+
+동일한 원라이너 재실행:
+
+```bash
+npx @orbweva/academy@latest
+```
+
+각 저장소를 다시 클론하고 기존 스킬 폴더를 덮어씁니다. 에어갭 또는 npm 없는 환경은 [docs/manual-update.md](docs/manual-update.md) 참조.
+
+## 모든 플래그
+
+| 플래그 | 의미 |
+|---|---|
+| `-t, --track <name>` | 트랙: `accelerator`, `course`, `mentoring`, `founder`, `full` |
+| `-p, --pack <name>` | 스페셜라이제이션 팩 추가 (반복 가능) |
+| `-g, --global` | `~/.claude/skills/`에 설치 |
+| `-l, --local` | `./.claude/skills/`에 설치 |
+| `-y, --yes` | 모든 기본값 수락 + CLI/MCP 명령어도 모두 자동 실행, 프롬프트 없음 |
+| `--skills-only` | 스킬만 설치, CLI + MCP 설정은 완전히 건너뛰기 |
+| `--no-run` | CLI + MCP 명령어를 출력만 하고 실행하지 않음. 스킬은 설치됨. |
+| `--dry-run` | 예정 표시, 디스크 변경 없음 |
+| `-h, --help` | 도움말 표시 |
+
+## 관련 문서
+
+**이 저장소 내:**
+- [docs/USER-GUIDE.md](docs/USER-GUIDE.md) — 모든 플래그 조합 포함 상세 워크스루
+- [docs/TRACKS.md](docs/TRACKS.md) — 트랙별 딥다이브
+- [docs/PACKS.md](docs/PACKS.md) — 스페셜라이제이션 팩 아키텍처 + 추가 방법
+- [docs/CLI-TOOLS.md](docs/CLI-TOOLS.md) — OS별 CLI 설치 레퍼런스 (Windows 함정 포함)
+- [docs/MCP-SERVERS.md](docs/MCP-SERVERS.md) — 트랙별 MCP 서버 설정
+- [docs/manual-update.md](docs/manual-update.md) — npm 없는 환경용 대체 설치
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — 설치 관리자 관련 문제
+
+**ORBWEVA 생태계 내:**
+- [ORBWEVA Accelerator Skills Reference](https://orbweva.com/ko/accelerator/skills) — 스킬 + 명령어의 페이즈별 공식 카탈로그
+- [Accelerator Curriculum Template](https://github.com/ORBWEVA/accelerator-template) — 12주 프로그램 가이드
+- [프로그램 트러블슈팅 가이드](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/TROUBLESHOOTING.md) — 설치 외 문제 (세션 중 스킬 실패, API 키 등)
+- [졸업 기준](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/GRADUATION_CRITERIA.md) — Accelerator "완료"의 의미
+
+## 기여
+
+트랙, 팩, 스킬 저장소 추가는 [CONTRIBUTING.md](CONTRIBUTING.md) 참조. 대부분의 변경은 `manifest.json`의 한 줄 편집입니다.
+
+## 라이선스
+
+ORBWEVA 생태계에 맞춘 듀얼 라이선스:
+
+- **소스 코드** (`bin/`, `src/`, `manifest.json`) — [MIT](LICENSE)
+- **문서 및 산문** (README 파일, `docs/`, `CHANGELOG` 등) — [CC BY-NC-SA 4.0](LICENSE-DOCS)
+
+설치되는 스킬은 별도의 ORBWEVA 저장소에 있으며 각자의 라이선스(일반적으로 CC BY-NC-SA 4.0)를 따릅니다. 이 설치 관리자는 재라이선스하지 않습니다.
+
+© 2026 ORBWEVA. 상업적 라이선스 문의: legal@orbweva.com.

package/README.md

@@ -0,0 +1,158 @@
+<div align="center">
+
+# @orbweva/academy
+
+**English** · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
+
+One command to install every ORBWEVA Claude Code skill a founder needs.
+
+```
+npx @orbweva/academy@latest
+```
+
+Works on **macOS, Windows, and Linux.** Node 18+, zero runtime dependencies.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![ORBWEVA Academy](https://img.shields.io/badge/ORBWEVA-Academy-1f6feb.svg)](https://orbweva.com/en/accelerator/skills)
+
+[Why this exists](#why-this-exists) · [Quick start](#quick-start) · [Tracks](#tracks) · [Specialization packs](#specialization-packs) · [Related docs](#related-docs)
+
+</div>
+
+---
+
+## Why this exists
+
+The first thing every ORBWEVA student used to do was type twenty-two slash commands in a row. `/plugin marketplace add …` then `/plugin install …`, eleven times. Get the order wrong, see `Unknown skill: discovery — Create a new one?` — hit Enter by reflex — now you have a fake skill and no error message. On Windows, half the installs fail silently until you discover you needed two PowerShell windows, one Admin for `winget` and one non-Admin for `scoop`, and that `EBADENGINE` warnings are fine but "recognize 'gh'" means your PATH is stale.
+
+It was a rite of passage nobody asked for. So we built this.
+
+**What it does** — replaces the 22 `/plugin …` commands with one `npx` invocation. Shallow-clones the 11 public ORBWEVA skill repos, copies the `skills/<name>/` directories into `~/.claude/skills/`, then prints the platform-specific CLI tool and MCP server commands you still need to run. Zero runtime dependencies. Node 18+ and `git` are the only prereqs.
+
+## Who this is for
+
+- **ORBWEVA Accelerator students** — the 12-week cohort program
+- **Founder-track partners** — e.g. agencies reselling a lean founder base to their clients
+- **Mentoring clients** — existing businesses getting 1:1 operator support
+- **Self-paced learners** — the Course track
+- **Specialists** — anyone layering a vertical on top of a track (Loka ecosystem, marketing agency, web+video studio)
+
+If you're none of those but still want the skills, run `--track full`.
+
+## Quick start
+
+```bash
+# Pick a track from the menu, answer a few prompts
+npx @orbweva/academy@latest
+
+# Go straight to a track, prompt per optional skill
+npx @orbweva/academy@latest --track accelerator
+
+# Fully non-interactive (all defaults, all optional skills, global)
+npx @orbweva/academy@latest --track accelerator --yes --global
+
+# Stack a specialization on top of a track
+npx @orbweva/academy@latest --track accelerator --pack loka
+npx @orbweva/academy@latest --track accelerator --pack marketing --pack web-video
+
+# Partner-delivered lean founder base (no Accelerator overhead)
+npx @orbweva/academy@latest --track founder
+```
+
+## Tracks
+
+Pick one base program. See [docs/TRACKS.md](docs/TRACKS.md) for full details per track.
+
+| Track | For | Skills |
+|---|---|---|
+| `accelerator` | 12-week cohort — zero-to-one founders | 15 |
+| `course` | Self-paced founder fundamentals | 9 |
+| `mentoring` | 1:1 operator support for existing businesses | 13 |
+| `founder` | Lean base for partner-delivered programs (agencies, resellers) | 10 |
+| `full` | Everything — no tradeoffs | 15 |
+
+## Specialization packs
+
+Stackable on top of any track. See [docs/PACKS.md](docs/PACKS.md).
+
+| Pack | For | Status |
+|---|---|---|
+| `loka` | Businesses on the Loka living-textbook + LoLA avatar platform | Planned |
+| `marketing` | One-person (or small team) marketing agencies | Planned |
+| `web-video` | Web design + video editing studios | Planned |
+
+> Pack repos are staged in `manifest.json` but not yet published. The installer skips planned packs gracefully until their repos go live.
+
+## What gets installed
+
+The installer composes a skill set from the track + any packs you add, then clones the relevant public ORBWEVA repos into your Claude Code skills folder.
+
+**For the full phase-by-phase catalog of every skill and command** — see the [ORBWEVA Accelerator Skills Reference](https://orbweva.com/en/accelerator/skills) (or [ACCELERATOR_SKILLS_REFERENCE.md](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/ACCELERATOR_SKILLS_REFERENCE.md)). That's the authoritative source; we don't duplicate it here.
+
+## Verify install
+
+After the installer finishes, open Claude Code and run:
+
+```
+/discovery:help
+```
+
+You should see the customer-discovery command menu. If Claude says `Unknown skill`, see [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md).
+
+## Staying updated
+
+Re-run the one-liner:
+
+```bash
+npx @orbweva/academy@latest
+```
+
+It re-clones each repo and overwrites existing skill folders. For air-gapped or npm-less environments, see [docs/manual-update.md](docs/manual-update.md).
+
+## All flags
+
+| Flag | Meaning |
+|---|---|
+| `-t, --track <name>` | Pick track: `accelerator`, `course`, `mentoring`, `founder`, `full` |
+| `-p, --pack <name>` | Add a specialization pack (repeatable) |
+| `-g, --global` | Install to `~/.claude/skills/` |
+| `-l, --local` | Install to `./.claude/skills/` |
+| `-y, --yes` | Accept all defaults AND auto-run every CLI/MCP command — no prompts |
+| `--skills-only` | Install skills only; skip CLI + MCP setup entirely |
+| `--no-run` | Print CLI + MCP commands (don't execute them). Skills still install. |
+| `--dry-run` | Show what would happen, touch nothing |
+| `-h, --help` | Show help |
+
+After skills install, the CLI prompts Y/n per CLI tool (brew/winget/scoop/npm/`gh auth login`) and per `claude mcp add` command, then runs the ones you approve. Use `--yes` to run them all silently; `--no-run` to see the commands without executing.
+
+## Related docs
+
+**In this repo:**
+- [docs/USER-GUIDE.md](docs/USER-GUIDE.md) — long-form walkthrough with every flag combo
+- [docs/TRACKS.md](docs/TRACKS.md) — per-track deep dive
+- [docs/PACKS.md](docs/PACKS.md) — specialization pack architecture + how to add one
+- [docs/CLI-TOOLS.md](docs/CLI-TOOLS.md) — full per-OS CLI install reference (with Windows gotchas)
+- [docs/MCP-SERVERS.md](docs/MCP-SERVERS.md) — MCP server setup per track
+- [docs/manual-update.md](docs/manual-update.md) — fallback install for no-npm environments
+- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) — installer-specific issues
+
+**In the ORBWEVA ecosystem:**
+- [ORBWEVA Accelerator Skills Reference](https://orbweva.com/en/accelerator/skills) — canonical skill + command catalog, phase-by-phase
+- [Accelerator Curriculum Template](https://github.com/ORBWEVA/accelerator-template) — 12-week program guide
+- [Program Troubleshooting Guide](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/TROUBLESHOOTING.md) — for non-installer issues (skills failing mid-session, API keys, etc.)
+- [Graduation Criteria](https://github.com/ORBWEVA/accelerator-template/blob/main/docs/GRADUATION_CRITERIA.md) — what "completing" the Accelerator means
+
+## Contributing
+
+To add a track, pack, or skill repo, see [CONTRIBUTING.md](CONTRIBUTING.md). Most changes are one-line edits to `manifest.json`.
+
+## License
+
+Dual-licensed to match the ORBWEVA ecosystem:
+
+- **Source code** (`bin/`, `src/`, `manifest.json`) — [MIT](LICENSE)
+- **Documentation and prose** (README files, `docs/`, `CHANGELOG`, etc.) — [CC BY-NC-SA 4.0](LICENSE-DOCS)
+
+Installed skills live in separate ORBWEVA repos, each under their own license (typically CC BY-NC-SA 4.0). This installer does not relicense them.
+
+© 2026 ORBWEVA. Commercial licensing inquiries: legal@orbweva.com.