gsd-pi 2.49.0 → 2.50.0-dev.d210a87

package/dist/resources/extensions/gsd/skill-catalog.js

@@ -0,0 +1,1026 @@
+/**
+ * GSD Skill Catalog — Curated skill packs mapped to tech stacks.
+ *
+ * Each pack maps a detected (or user-chosen) tech stack to a skills.sh
+ * repo + specific skill names.  The init wizard uses this catalog to
+ * install relevant skills during project onboarding.
+ *
+ * Installation is delegated entirely to the skills.sh CLI:
+ *   npx skills add <repo> --skill <name> --skill <name> -y
+ *
+ * Skills are installed into ~/.agents/skills/ (the industry-standard
+ * ecosystem directory shared across all agents).
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { showNextAction } from "../shared/tui.js";
+// ─── Curated Catalog ──────────────────────────────────────────────────────────
+export const SKILL_CATALOG = [
+    // ── Swift (language-level — any Swift project) ────────────────────────────
+    {
+        label: "SwiftUI",
+        description: "SwiftUI layout, navigation, animations, gestures, Liquid Glass",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "swiftui-animation",
+            "swiftui-gestures",
+            "swiftui-layout-components",
+            "swiftui-liquid-glass",
+            "swiftui-navigation",
+            "swiftui-patterns",
+            "swiftui-performance",
+            "swiftui-uikit-interop",
+        ],
+        matchLanguages: ["swift"],
+        matchFiles: ["Package.swift"],
+    },
+    {
+        label: "Swift Core",
+        description: "Swift language, concurrency, Codable, Charts, Testing, SwiftData",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "swift-codable",
+            "swift-charts",
+            "swift-concurrency",
+            "swift-language",
+            "swift-testing",
+            "swiftdata",
+        ],
+        matchLanguages: ["swift"],
+        matchFiles: ["Package.swift"],
+    },
+    // ── iOS (Xcode project targeting iphoneos required) ───────────────────────
+    {
+        label: "iOS App Frameworks",
+        description: "App Intents, Widgets, StoreKit, MapKit, Live Activities, push notifications",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "alarmkit",
+            "app-clips",
+            "app-intents",
+            "live-activities",
+            "mapkit-location",
+            "photos-camera-media",
+            "push-notifications",
+            "storekit",
+            "tipkit",
+            "widgetkit",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    {
+        label: "iOS Data Frameworks",
+        description: "CloudKit, HealthKit, MusicKit, WeatherKit, Contacts, Calendar",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "cloudkit-sync",
+            "contacts-framework",
+            "eventkit-calendar",
+            "healthkit",
+            "musickit-audio",
+            "passkit-wallet",
+            "weatherkit",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    {
+        label: "iOS AI & ML",
+        description: "Core ML, Vision, on-device AI, speech recognition, NLP",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "apple-on-device-ai",
+            "coreml",
+            "natural-language",
+            "speech-recognition",
+            "vision-framework",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    {
+        label: "iOS Engineering",
+        description: "Networking, security, accessibility, localization, Instruments, App Store review",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "app-store-review",
+            "authentication",
+            "background-processing",
+            "debugging-instruments",
+            "device-integrity",
+            "ios-accessibility",
+            "ios-localization",
+            "ios-networking",
+            "ios-security",
+            "metrickit-diagnostics",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    {
+        label: "iOS Hardware",
+        description: "Bluetooth, CoreMotion, NFC, PencilKit, RealityKit AR",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "core-bluetooth",
+            "core-motion",
+            "core-nfc",
+            "pencilkit-drawing",
+            "realitykit-ar",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    {
+        label: "iOS Platform",
+        description: "CallKit, EnergyKit, HomeKit, SharePlay, PermissionKit",
+        repo: "dpearson2699/swift-ios-skills",
+        skills: [
+            "callkit-voip",
+            "energykit",
+            "homekit-matter",
+            "permissionkit",
+            "shareplay-activities",
+        ],
+        matchXcodePlatforms: ["iphoneos"],
+    },
+    // ── React / Next.js ───────────────────────────────────────────────────────
+    {
+        label: "React & Web Frontend",
+        description: "React best practices and composition patterns",
+        repo: "vercel-labs/agent-skills",
+        skills: [
+            "vercel-react-best-practices",
+            "vercel-composition-patterns",
+        ],
+        matchLanguages: ["javascript/typescript"],
+    },
+    {
+        label: "shadcn/ui",
+        description: "shadcn/ui component library patterns and usage",
+        repo: "shadcn/ui",
+        skills: ["shadcn"],
+        matchLanguages: ["javascript/typescript"],
+    },
+    // ── React Native ──────────────────────────────────────────────────────────
+    {
+        label: "React Native",
+        description: "React Native and Expo best practices for performant mobile apps",
+        repo: "vercel-labs/agent-skills",
+        skills: ["vercel-react-native-skills"],
+        matchFiles: ["metro.config.js", "metro.config.ts", "react-native.config.js"],
+    },
+    {
+        label: "React Native Architecture",
+        description: "React Native app architecture, navigation, and cross-platform design patterns",
+        repo: "wshobson/agents",
+        skills: ["react-native-architecture", "react-native-design"],
+        matchFiles: ["metro.config.js", "metro.config.ts", "react-native.config.js"],
+    },
+    // ── TypeScript & JS Ecosystem (wshobson/agents — 41K combined installs) ──
+    {
+        label: "TypeScript & JS Development",
+        description: "Advanced TypeScript types, Node.js backend, testing, and modern JS patterns",
+        repo: "wshobson/agents",
+        skills: [
+            "typescript-advanced-types",
+            "nodejs-backend-patterns",
+            "javascript-testing-patterns",
+            "modern-javascript-patterns",
+        ],
+        matchLanguages: ["javascript/typescript"],
+    },
+    // ── React State (wshobson/agents — 8.1K combined installs) ─────────────
+    {
+        label: "React State & Patterns",
+        description: "State management with Zustand, Jotai, React Query, and React modernization",
+        repo: "wshobson/agents",
+        skills: ["react-state-management", "react-modernization"],
+        matchLanguages: ["javascript/typescript"],
+    },
+    // ── Tailwind CSS (wshobson/agents — 22.8K installs) ───────────────────
+    {
+        label: "Tailwind CSS",
+        description: "Tailwind v4 design system, CVA patterns, and utility-first CSS",
+        repo: "wshobson/agents",
+        skills: ["tailwind-design-system"],
+        matchFiles: [
+            "tailwind.config.js",
+            "tailwind.config.ts",
+            "tailwind.config.mjs",
+            "tailwind.config.cjs",
+        ],
+    },
+    // ── General Frontend ──────────────────────────────────────────────────────
+    {
+        label: "Frontend Design & UX",
+        description: "Frontend design, accessibility, and browser automation",
+        repo: "anthropics/skills",
+        skills: ["frontend-design"],
+        matchLanguages: ["javascript/typescript"],
+    },
+    // ── Angular ───────────────────────────────────────────────────────────────
+    {
+        label: "Angular",
+        description: "Angular components, signals, forms, routing, and testing",
+        repo: "analogjs/angular-skills",
+        skills: [
+            "angular-component",
+            "angular-signals",
+            "angular-forms",
+            "angular-routing",
+            "angular-testing",
+        ],
+        matchFiles: ["angular.json"],
+    },
+    {
+        label: "Angular Migration",
+        description: "Migrate from AngularJS to Angular with hybrid mode and incremental rewriting",
+        repo: "wshobson/agents",
+        skills: ["angular-migration"],
+        matchFiles: ["angular.json"],
+    },
+    // ── Vue.js / Nuxt ────────────────────────────────────────────────────────
+    {
+        label: "Vue.js",
+        description: "Vue best practices, Pinia state, Vue Router, and testing",
+        repo: "vuejs-ai/skills",
+        skills: [
+            "vue-best-practices",
+            "vue-pinia-best-practices",
+            "vue-router-best-practices",
+            "vue-testing-best-practices",
+        ],
+        matchFiles: ["nuxt.config.ts", "nuxt.config.js", "vue.config.js", "vue.config.ts", "*.vue"],
+    },
+    // ── Svelte / SvelteKit ────────────────────────────────────────────────────
+    {
+        label: "Svelte",
+        description: "Svelte code patterns and SvelteKit best practices",
+        repo: "sveltejs/ai-tools",
+        skills: ["svelte-code-writer", "svelte-core-bestpractices"],
+        matchFiles: ["svelte.config.js", "svelte.config.ts"],
+    },
+    // ── Next.js ───────────────────────────────────────────────────────────────
+    {
+        label: "Next.js",
+        description: "Next.js app router, server components, and deployment patterns",
+        repo: "vercel-labs/vercel-plugin",
+        skills: ["nextjs"],
+        matchFiles: ["next.config.js", "next.config.ts", "next.config.mjs"],
+    },
+    {
+        label: "Next.js App Router Patterns",
+        description: "Next.js 14+ App Router, React Server Components, and streaming",
+        repo: "wshobson/agents",
+        skills: ["nextjs-app-router-patterns"],
+        matchFiles: ["next.config.js", "next.config.ts", "next.config.mjs"],
+    },
+    // ── Java / Spring Boot ────────────────────────────────────────────────────
+    {
+        label: "Java & Spring Boot",
+        description: "Spring Boot best practices, DI, RESTful APIs, JPA, testing, and security",
+        repo: "github/awesome-copilot",
+        skills: ["java-springboot"],
+        matchFiles: ["dep:spring-boot"],
+    },
+    // ── .NET / C# ────────────────────────────────────────────────────────────
+    {
+        label: ".NET & C#",
+        description: ".NET best practices, design patterns, and upgrade guidance",
+        repo: "github/awesome-copilot",
+        skills: ["dotnet-best-practices", "dotnet-design-pattern-review"],
+        matchLanguages: ["csharp"],
+        matchFiles: ["*.csproj"],
+    },
+    {
+        label: ".NET Backend Patterns",
+        description: ".NET backend architecture, middleware, and production patterns",
+        repo: "wshobson/agents",
+        skills: ["dotnet-backend-patterns"],
+        matchFiles: ["*.csproj", "*.fsproj", "*.sln"],
+    },
+    // ── Flutter / Dart ────────────────────────────────────────────────────────
+    {
+        label: "Flutter",
+        description: "Flutter layouts, architecture, state management, and testing",
+        repo: "flutter/skills",
+        skills: [
+            "flutter-building-layouts",
+            "flutter-architecting-apps",
+            "flutter-managing-state",
+            "flutter-testing-apps",
+        ],
+        matchLanguages: ["dart/flutter"],
+        matchFiles: ["pubspec.yaml"],
+    },
+    // ── PHP / Laravel ─────────────────────────────────────────────────────────
+    {
+        label: "PHP & Laravel",
+        description: "Laravel patterns, PHP best practices, and testing",
+        repo: "jeffallan/claude-skills",
+        skills: ["laravel-specialist", "php-pro"],
+        matchLanguages: ["php"],
+        matchFiles: ["composer.json"],
+    },
+    // ── Django ────────────────────────────────────────────────────────────────
+    {
+        label: "Django",
+        description: "Django expert patterns, models, views, and middleware",
+        repo: "vintasoftware/django-ai-plugins",
+        skills: ["django-expert"],
+        matchFiles: ["manage.py"],
+    },
+    // ── Rust ──────────────────────────────────────────────────────────────────
+    {
+        label: "Rust",
+        description: "Rust language patterns and best practices",
+        repo: "anthropics/skills",
+        skills: ["rust-best-practices"],
+        matchLanguages: ["rust"],
+        matchFiles: ["Cargo.toml"],
+    },
+    {
+        label: "Rust Async Patterns",
+        description: "Async Rust with Tokio, futures, and proper error handling",
+        repo: "wshobson/agents",
+        skills: ["rust-async-patterns"],
+        matchLanguages: ["rust"],
+        matchFiles: ["Cargo.toml"],
+    },
+    // ── Python ────────────────────────────────────────────────────────────────
+    {
+        label: "Python",
+        description: "Python patterns and best practices",
+        repo: "anthropics/skills",
+        skills: ["python-best-practices"],
+        matchLanguages: ["python"],
+        matchFiles: ["pyproject.toml", "setup.py", "requirements.txt"],
+    },
+    {
+        label: "Python Advanced",
+        description: "Python performance, testing, async patterns, and uv package manager",
+        repo: "wshobson/agents",
+        skills: [
+            "python-performance-optimization",
+            "python-testing-patterns",
+            "async-python-patterns",
+            "uv-package-manager",
+        ],
+        matchLanguages: ["python"],
+        matchFiles: ["pyproject.toml", "setup.py", "requirements.txt"],
+    },
+    // FastAPI — detected by scanning requirements.txt / pyproject.toml for the
+    // "fastapi" dependency. Uses the "dep:fastapi" synthetic marker from detection.ts.
+    {
+        label: "FastAPI",
+        description: "Production-ready FastAPI projects with async patterns and error handling",
+        repo: "wshobson/agents",
+        skills: ["fastapi-templates"],
+        matchFiles: ["dep:fastapi"],
+    },
+    // ── Go ────────────────────────────────────────────────────────────────────
+    {
+        label: "Go",
+        description: "Go language patterns and best practices",
+        repo: "anthropics/skills",
+        skills: ["go-best-practices"],
+        matchLanguages: ["go"],
+        matchFiles: ["go.mod"],
+    },
+    {
+        label: "Go Concurrency Patterns",
+        description: "Go concurrency with channels, worker pools, and context cancellation",
+        repo: "wshobson/agents",
+        skills: ["go-concurrency-patterns"],
+        matchLanguages: ["go"],
+        matchFiles: ["go.mod"],
+    },
+    // ── Database / ORM ─────────────────────────────────────────────────────────
+    {
+        label: "Prisma",
+        description: "Prisma ORM setup, schema design, client API, and migrations",
+        repo: "prisma/skills",
+        skills: [
+            "prisma-database-setup",
+            "prisma-client-api",
+            "prisma-cli",
+        ],
+        matchFiles: ["prisma/schema.prisma"],
+    },
+    {
+        label: "Supabase & Postgres",
+        description: "Supabase project setup, auth, Postgres best practices, and Firestore",
+        repo: "supabase/agent-skills",
+        skills: ["supabase-postgres-best-practices"],
+        matchFiles: ["supabase/config.toml"],
+    },
+    {
+        label: "PostgreSQL Design",
+        description: "PostgreSQL table design, indexing strategies, and query optimization",
+        repo: "wshobson/agents",
+        skills: ["postgresql-table-design"],
+        matchFiles: ["supabase/config.toml", "*.sql"],
+    },
+    {
+        label: "SQL Optimization & Review",
+        description: "Universal SQL performance optimization, security (injection prevention), and code review",
+        repo: "github/awesome-copilot",
+        skills: ["sql-optimization", "sql-code-review"],
+        matchFiles: [
+            "*.sql",
+            "*.sqlite",
+            "prisma/schema.prisma",
+            "supabase/config.toml",
+            "drizzle.config.ts",
+            "drizzle.config.js",
+        ],
+    },
+    {
+        label: "Redis",
+        description: "Redis development patterns and best practices",
+        repo: "redis/agent-skills",
+        skills: ["redis-development"],
+        matchFiles: ["redis.conf"],
+    },
+    // ── Cloud Platforms ────────────────────────────────────────────────────────
+    {
+        label: "Firebase",
+        description: "Firebase setup, auth, Firestore, hosting, and AI Logic",
+        repo: "firebase/agent-skills",
+        skills: [
+            "firebase-basics",
+            "firebase-auth-basics",
+            "firebase-firestore-basics",
+            "firebase-hosting-basics",
+            "firebase-ai-logic",
+        ],
+        matchFiles: ["firebase.json"],
+    },
+    {
+        label: "Azure",
+        description: "Azure deployment, AI services, storage, cost optimization, and diagnostics",
+        repo: "microsoft/github-copilot-for-azure",
+        skills: [
+            "azure-deploy",
+            "azure-ai",
+            "azure-storage",
+            "azure-cost-optimization",
+            "azure-diagnostics",
+        ],
+        matchFiles: ["azure-pipelines.yml"],
+    },
+    {
+        label: "AWS",
+        description: "AWS deployment, Lambda, and serverless patterns",
+        repo: "awslabs/agent-plugins",
+        skills: ["deploy", "aws-lambda", "aws-serverless-deployment"],
+        matchFiles: ["cdk.json", "samconfig.toml", "serverless.yml", "serverless.yaml"],
+    },
+    // ── Container / DevOps ─────────────────────────────────────────────────────
+    {
+        label: "Docker",
+        description: "Multi-stage Dockerfiles, layer optimization, and security hardening",
+        repo: "github/awesome-copilot",
+        skills: ["multi-stage-dockerfile"],
+        matchFiles: ["Dockerfile", "docker-compose.yml", "docker-compose.yaml"],
+    },
+    // ── Infrastructure as Code ─────────────────────────────────────────────────
+    {
+        label: "Terraform",
+        description: "Terraform style guide, testing, and stack patterns",
+        repo: "hashicorp/agent-skills",
+        skills: ["terraform-style-guide", "terraform-test", "terraform-stacks"],
+        matchFiles: ["main.tf"],
+    },
+    // ── Android (wshobson/agents — 7K installs) ────────────────────────────────
+    {
+        label: "Android",
+        description: "Android app design following Material Design 3 guidelines",
+        repo: "wshobson/agents",
+        skills: ["mobile-android-design"],
+        matchFiles: ["app/build.gradle", "app/build.gradle.kts"],
+    },
+    // ── Kubernetes (wshobson/agents — 4 skills) ────────────────────────────────
+    {
+        label: "Kubernetes",
+        description: "K8s manifests, Helm charts, GitOps workflows, and security policies",
+        repo: "wshobson/agents",
+        skills: [
+            "k8s-manifest-generator",
+            "helm-chart-scaffolding",
+            "gitops-workflow",
+            "k8s-security-policies",
+        ],
+        matchFiles: ["Chart.yaml", "kustomization.yaml"],
+    },
+    // ── CI/CD (wshobson/agents — 3 skills) ─────────────────────────────────────
+    {
+        label: "CI/CD Automation",
+        description: "Pipeline design, GitHub Actions workflows, and secrets management",
+        repo: "wshobson/agents",
+        skills: [
+            "deployment-pipeline-design",
+            "github-actions-templates",
+            "secrets-management",
+        ],
+        matchFiles: [".github/workflows"],
+    },
+    // ── Blockchain / Web3 (wshobson/agents — 3 skills) ─────────────────────────
+    {
+        label: "Blockchain & Web3",
+        description: "Solidity security, DeFi protocols, and smart contract testing",
+        repo: "wshobson/agents",
+        skills: ["solidity-security", "defi-protocol-templates", "web3-testing"],
+        matchFiles: ["hardhat.config.js", "hardhat.config.ts", "foundry.toml"],
+    },
+    // ── Data Engineering (wshobson/agents — 4 skills) ──────────────────────────
+    {
+        label: "Data Engineering",
+        description: "dbt transformations, Airflow DAGs, Spark optimization, and data quality",
+        repo: "wshobson/agents",
+        skills: [
+            "dbt-transformation-patterns",
+            "airflow-dag-patterns",
+            "spark-optimization",
+            "data-quality-frameworks",
+        ],
+        matchFiles: ["dbt_project.yml", "airflow.cfg"],
+    },
+    // ── Game Development — Unity (wshobson/agents) ─────────────────────────────
+    {
+        label: "Unity",
+        description: "Unity ECS patterns for high-performance game systems",
+        repo: "wshobson/agents",
+        skills: ["unity-ecs-patterns"],
+        matchFiles: ["ProjectSettings/ProjectVersion.txt"],
+    },
+    // ── Game Development — Godot (wshobson/agents) ─────────────────────────────
+    {
+        label: "Godot",
+        description: "Godot GDScript best practices and scene composition",
+        repo: "wshobson/agents",
+        skills: ["godot-gdscript-patterns"],
+        matchFiles: ["project.godot"],
+    },
+    // ── Essential (all projects) ────────────────────────────────────────────
+    {
+        label: "Skill Discovery",
+        description: "Find and install new agent skills from the ecosystem",
+        repo: "vercel-labs/skills",
+        skills: ["find-skills"],
+        matchAlways: true,
+    },
+    {
+        label: "Skill Authoring",
+        description: "Create, audit, and refine SKILL.md files",
+        repo: "anthropics/skills",
+        skills: ["skill-creator"],
+        matchAlways: true,
+    },
+    {
+        label: "Browser Automation",
+        description: "Browser automation for web scraping, testing, and interaction",
+        repo: "vercel-labs/agent-browser",
+        skills: ["agent-browser"],
+        matchAlways: true,
+    },
+    // ── General Tooling ───────────────────────────────────────────────────────
+    {
+        label: "Document Handling",
+        description: "PDF, DOCX, XLSX, PPTX creation and manipulation",
+        repo: "anthropics/skills",
+        skills: ["pdf", "docx", "xlsx", "pptx"],
+        matchAlways: true,
+    },
+    // ── Code Quality (wshobson/agents — matchAlways) ──────────────────────────
+    {
+        label: "Code Review & Quality",
+        description: "Code review excellence and error handling patterns",
+        repo: "wshobson/agents",
+        skills: ["code-review-excellence", "error-handling-patterns"],
+        matchAlways: true,
+    },
+    {
+        label: "Git Advanced Workflows",
+        description: "Advanced Git rebasing, cherry-picking, bisect, worktrees, and reflog",
+        repo: "wshobson/agents",
+        skills: ["git-advanced-workflows"],
+        matchAlways: true,
+    },
+];
+// ─── Greenfield Tech Stack Choices ────────────────────────────────────────────
+/**
+ * Tech stack → pack mappings for programmatic use.
+ *
+ * NOT shown directly to users during init (greenfield installs essentials
+ * only and defers stack-specific skills).  These mappings are available for:
+ *   1. The LLM to install skills after establishing a design
+ *   2. The `/gsd skills` command (explicit user request)
+ *   3. Re-running brownfield detection after project files are created
+ */
+export const GREENFIELD_STACKS = [
+    {
+        id: "ios",
+        label: "iOS App",
+        description: "Full iOS development — SwiftUI, Swift, and all iOS frameworks",
+        packs: [
+            "SwiftUI",
+            "Swift Core",
+            "iOS App Frameworks",
+            "iOS Data Frameworks",
+            "iOS AI & ML",
+            "iOS Engineering",
+            "iOS Hardware",
+            "iOS Platform",
+        ],
+    },
+    {
+        id: "swift",
+        label: "Swift (non-iOS)",
+        description: "Swift packages, server-side Swift, CLI tools, SwiftUI without iOS",
+        packs: ["SwiftUI", "Swift Core"],
+    },
+    {
+        id: "react-web",
+        label: "React Web",
+        description: "React, Next.js, shadcn/ui, web frontend",
+        packs: ["React & Web Frontend", "TypeScript & JS Development", "React State & Patterns", "Tailwind CSS", "shadcn/ui", "Frontend Design & UX"],
+    },
+    {
+        id: "react-native",
+        label: "React Native",
+        description: "Cross-platform mobile with React Native",
+        packs: ["React Native", "React Native Architecture", "React & Web Frontend", "TypeScript & JS Development"],
+    },
+    {
+        id: "fullstack-js",
+        label: "Full-Stack JavaScript/TypeScript",
+        description: "Node.js backend + React frontend",
+        packs: ["React & Web Frontend", "TypeScript & JS Development", "React State & Patterns", "Tailwind CSS", "shadcn/ui", "Frontend Design & UX", "Prisma"],
+    },
+    {
+        id: "rust",
+        label: "Rust",
+        description: "Systems programming with Rust",
+        packs: ["Rust", "Rust Async Patterns"],
+    },
+    {
+        id: "python",
+        label: "Python",
+        description: "Python applications, scripts, or ML",
+        packs: ["Python", "Python Advanced"],
+    },
+    {
+        id: "go",
+        label: "Go",
+        description: "Go services and CLIs",
+        packs: ["Go", "Go Concurrency Patterns"],
+    },
+    {
+        id: "firebase",
+        label: "Firebase",
+        description: "Firebase backend — auth, Firestore, hosting, AI",
+        packs: ["Firebase"],
+    },
+    {
+        id: "aws",
+        label: "AWS",
+        description: "AWS deployment, Lambda, serverless",
+        packs: ["AWS"],
+    },
+    {
+        id: "azure",
+        label: "Azure",
+        description: "Azure deployment, AI, storage, diagnostics",
+        packs: ["Azure"],
+    },
+    {
+        id: "angular",
+        label: "Angular",
+        description: "Angular components, signals, forms, routing",
+        packs: ["Angular", "Angular Migration", "Frontend Design & UX"],
+    },
+    {
+        id: "vue",
+        label: "Vue.js / Nuxt",
+        description: "Vue.js with Pinia, Vue Router, and testing",
+        packs: ["Vue.js", "Frontend Design & UX"],
+    },
+    {
+        id: "svelte",
+        label: "Svelte / SvelteKit",
+        description: "Svelte 5 and SvelteKit patterns",
+        packs: ["Svelte", "Tailwind CSS", "Frontend Design & UX"],
+    },
+    {
+        id: "nextjs",
+        label: "Next.js",
+        description: "Next.js app router, React, and Vercel deployment",
+        packs: ["Next.js", "Next.js App Router Patterns", "React & Web Frontend", "TypeScript & JS Development", "Tailwind CSS", "shadcn/ui"],
+    },
+    {
+        id: "flutter",
+        label: "Flutter",
+        description: "Cross-platform Flutter/Dart development",
+        packs: ["Flutter"],
+    },
+    {
+        id: "java",
+        label: "Java / Spring Boot",
+        description: "Spring Boot APIs, JPA, and testing",
+        packs: ["Java & Spring Boot"],
+    },
+    {
+        id: "dotnet",
+        label: ".NET / C#",
+        description: "ASP.NET Core, Entity Framework, and design patterns",
+        packs: [".NET & C#", ".NET Backend Patterns"],
+    },
+    {
+        id: "php",
+        label: "PHP / Laravel",
+        description: "Laravel patterns and PHP best practices",
+        packs: ["PHP & Laravel"],
+    },
+    {
+        id: "django",
+        label: "Django",
+        description: "Django models, views, middleware, and Celery",
+        packs: ["Django", "Python", "Python Advanced"],
+    },
+    {
+        id: "fastapi",
+        label: "FastAPI",
+        description: "FastAPI web APIs with async patterns",
+        packs: ["FastAPI", "Python", "Python Advanced"],
+    },
+    {
+        id: "android",
+        label: "Android / Kotlin",
+        description: "Android app development with Material Design 3",
+        packs: ["Android"],
+    },
+    {
+        id: "kubernetes",
+        label: "Kubernetes",
+        description: "Kubernetes manifests, Helm charts, and GitOps",
+        packs: ["Kubernetes", "Docker"],
+    },
+    {
+        id: "blockchain",
+        label: "Blockchain / Web3",
+        description: "Solidity, DeFi protocols, and smart contract testing",
+        packs: ["Blockchain & Web3"],
+    },
+    {
+        id: "data-engineering",
+        label: "Data Engineering",
+        description: "dbt, Airflow, Spark, and data quality",
+        packs: ["Data Engineering", "Python", "Python Advanced"],
+    },
+    {
+        id: "unity",
+        label: "Unity",
+        description: "Unity game development with ECS patterns",
+        packs: ["Unity"],
+    },
+    {
+        id: "godot",
+        label: "Godot",
+        description: "Godot game development with GDScript",
+        packs: ["Godot"],
+    },
+    {
+        id: "other",
+        label: "Other / Skip",
+        description: "Install skills later with npx skills add",
+        packs: [],
+    },
+];
+// ─── Detection → Pack Matching ────────────────────────────────────────────────
+/**
+ * Match project signals to relevant skill packs.
+ * Returns packs in catalog order (not sorted by match type).
+ */
+export function matchPacksForProject(signals) {
+    const matched = new Set();
+    for (const pack of SKILL_CATALOG) {
+        // Language match
+        if (pack.matchLanguages && signals.primaryLanguage) {
+            if (pack.matchLanguages.includes(signals.primaryLanguage)) {
+                matched.add(pack);
+                continue;
+            }
+        }
+        // File match
+        if (pack.matchFiles) {
+            for (const file of pack.matchFiles) {
+                if (signals.detectedFiles.includes(file)) {
+                    matched.add(pack);
+                    break;
+                }
+            }
+        }
+        // Xcode platform match (e.g. iOS packs only when SDKROOT = iphoneos)
+        if (pack.matchXcodePlatforms && signals.xcodePlatforms.length > 0) {
+            const hasMatch = pack.matchXcodePlatforms.some((p) => signals.xcodePlatforms.includes(p));
+            if (hasMatch)
+                matched.add(pack);
+        }
+        // Always-include packs (essentials)
+        if (pack.matchAlways) {
+            matched.add(pack);
+        }
+    }
+    return [...matched];
+}
+// ─── Installation ─────────────────────────────────────────────────────────────
+/**
+ * Install a skill pack via the skills.sh CLI.
+ * Runs: npx skills add <repo> --skill <name> ... -y
+ *
+ * Returns true if installation succeeded.
+ */
+export function installSkillPack(pack) {
+    return new Promise((resolve) => {
+        // --yes = npx auto-install, -y = skills.sh non-interactive
+        const args = ["--yes", "skills", "add", pack.repo];
+        for (const skill of pack.skills) {
+            args.push("--skill", skill);
+        }
+        args.push("-y");
+        execFile("npx", args, { timeout: 120_000 }, (error) => {
+            resolve(!error);
+        });
+    });
+}
+/**
+ * Install multiple packs, batching by repo to minimize npx invocations.
+ * Returns the labels of successfully installed packs.
+ */
+export async function installPacksBatched(packs, onProgress) {
+    // Group packs by repo
+    const byRepo = new Map();
+    for (const pack of packs) {
+        const entry = byRepo.get(pack.repo) ?? { skills: [], labels: [] };
+        entry.skills.push(...pack.skills);
+        entry.labels.push(pack.label);
+        byRepo.set(pack.repo, entry);
+    }
+    const installed = [];
+    for (const [repo, { skills, labels }] of byRepo) {
+        onProgress?.(labels.join(", "));
+        const ok = await new Promise((resolve) => {
+            // --yes = npx auto-install, -y = skills.sh non-interactive
+            const args = ["--yes", "skills", "add", repo];
+            for (const skill of skills) {
+                args.push("--skill", skill);
+            }
+            args.push("-y");
+            execFile("npx", args, { timeout: 120_000 }, (error) => {
+                resolve(!error);
+            });
+        });
+        if (ok)
+            installed.push(...labels);
+    }
+    return installed;
+}
+/**
+ * Check if any skills from a pack are already installed.
+ */
+export function isPackInstalled(pack) {
+    const skillsDir = join(homedir(), ".agents", "skills");
+    if (!existsSync(skillsDir))
+        return false;
+    return pack.skills.every((name) => existsSync(join(skillsDir, name, "SKILL.md")));
+}
+// ─── Init Wizard Integration ──────────────────────────────────────────────────
+/**
+ * Run skill installation step during project init.
+ *
+ * Brownfield (signals.detectedFiles.length > 0):
+ *   Auto-detects tech stack → shows matched packs → installs accepted ones.
+ *
+ * Greenfield (no files detected):
+ *   Installs essential packs only (find-skills, skill-creator, etc.).
+ *   Stack-specific skills are deferred — once the LLM establishes a design
+ *   and creates project files (package.json, firebase.json, etc.), brownfield
+ *   detection will pick them up on the next `gsd init` or via auto-mode
+ *   skill discovery.
+ *
+ * Returns the list of installed pack labels.
+ */
+export async function runSkillInstallStep(ctx, signals) {
+    const installed = [];
+    const isBrownfield = signals.detectedFiles.length > 0;
+    if (isBrownfield) {
+        // ── Brownfield: auto-detect and confirm ─────────────────────────────────
+        const matched = matchPacksForProject(signals);
+        if (matched.length === 0)
+            return installed;
+        // Filter out already-installed packs
+        const toInstall = matched.filter((p) => !isPackInstalled(p));
+        if (toInstall.length === 0)
+            return installed;
+        // Group for display: Swift packs vs iOS packs vs other
+        const swiftPacks = toInstall.filter((p) => p.matchLanguages?.includes("swift"));
+        const iosPacks = toInstall.filter((p) => p.matchXcodePlatforms?.includes("iphoneos"));
+        const otherPacks = toInstall.filter((p) => !swiftPacks.includes(p) && !iosPacks.includes(p));
+        const summaryLines = [];
+        const hasIOS = signals.xcodePlatforms.includes("iphoneos");
+        if (hasIOS) {
+            summaryLines.push(`Detected: iOS project (${signals.primaryLanguage ?? "swift"})`);
+        }
+        else if (signals.xcodePlatforms.length > 0) {
+            summaryLines.push(`Detected: ${signals.xcodePlatforms.join(", ")} Xcode project (${signals.primaryLanguage ?? "swift"})`);
+        }
+        else {
+            summaryLines.push(`Detected: ${signals.primaryLanguage ?? "unknown"} project`);
+        }
+        summaryLines.push("");
+        summaryLines.push("Recommended skill packs:");
+        if (swiftPacks.length > 0) {
+            summaryLines.push(`  Swift: ${swiftPacks.map((p) => p.label).join(", ")}`);
+        }
+        if (iosPacks.length > 0) {
+            summaryLines.push(`  iOS: ${iosPacks.map((p) => p.label).join(", ")}`);
+        }
+        for (const p of otherPacks) {
+            summaryLines.push(`  • ${p.label}: ${p.description}`);
+        }
+        const totalSkills = toInstall.reduce((n, p) => n + p.skills.length, 0);
+        const choice = await showNextAction(ctx, {
+            title: "GSD — Install Skills",
+            summary: summaryLines,
+            actions: [
+                {
+                    id: "install",
+                    label: "Install recommended skills",
+                    description: `Install ${totalSkills} skills from ${toInstall.length} pack${toInstall.length > 1 ? "s" : ""} via skills.sh`,
+                    recommended: true,
+                },
+                {
+                    id: "skip",
+                    label: "Skip",
+                    description: "Install skills later with npx skills add",
+                },
+            ],
+            notYetMessage: "Run /gsd init when ready.",
+        });
+        if (choice === "install") {
+            const labels = await installPacksBatched(toInstall, (label) => {
+                ctx.ui.notify(`Installing ${label} skills...`, "info");
+            });
+            installed.push(...labels);
+            const failed = toInstall.filter((p) => !installed.includes(p.label));
+            for (const pack of failed) {
+                ctx.ui.notify(`Failed to install ${pack.label} — try manually: npx skills add ${pack.repo}`, "info");
+            }
+        }
+    }
+    else {
+        // ── Greenfield: install essentials only ─────────────────────────────────
+        // Don't ask the user what tech stack they're building — they may not know
+        // yet, especially non-technical users. Install essential packs (discovery,
+        // authoring, browser, docs) and let stack-specific skills auto-detect later
+        // once the LLM establishes the design and creates project files.
+        const essentials = SKILL_CATALOG.filter((p) => p.matchAlways && !isPackInstalled(p));
+        if (essentials.length === 0)
+            return installed;
+        const totalSkills = essentials.reduce((n, p) => n + p.skills.length, 0);
+        const choice = await showNextAction(ctx, {
+            title: "GSD — Install Essential Skills",
+            summary: [
+                "GSD will install essential agent skills (skill discovery, authoring,",
+                "browser automation, document handling).",
+                "",
+                "Stack-specific skills (React, Swift, Python, etc.) will be recommended",
+                "automatically once your project files are in place.",
+            ],
+            actions: [
+                {
+                    id: "install",
+                    label: "Install essentials",
+                    description: `Install ${totalSkills} essential skills via skills.sh`,
+                    recommended: true,
+                },
+                {
+                    id: "skip",
+                    label: "Skip",
+                    description: "Install skills later with npx skills add",
+                },
+            ],
+            notYetMessage: "Run /gsd init when ready.",
+        });
+        if (choice === "install") {
+            const labels = await installPacksBatched(essentials, (label) => {
+                ctx.ui.notify(`Installing ${label} skills...`, "info");
+            });
+            installed.push(...labels);
+        }
+    }
+    if (installed.length > 0) {
+        ctx.ui.notify(`Installed: ${installed.join(", ")}`, "info");
+    }
+    return installed;
+}