gsd-pi 2.50.0 → 2.51.0-dev.ae8f7cb

package/src/resources/extensions/gsd/skill-catalog.ts

@@ -0,0 +1,1085 @@
+/**
+ * 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 type { ExtensionCommandContext } from "@gsd/pi-coding-agent";
+import { showNextAction } from "../shared/tui.js";
+import type { ProjectSignals, XcodePlatform } from "./detection.js";
+
+// ─── Catalog Types ────────────────────────────────────────────────────────────
+
+export interface SkillPack {
+  /** Human-readable name shown in the wizard */
+  label: string;
+  /** Short description */
+  description: string;
+  /** skills.sh repo identifier (owner/repo) */
+  repo: string;
+  /** Specific skill names to install from the repo */
+  skills: string[];
+  /** Which detected primaryLanguage values trigger this pack */
+  matchLanguages?: string[];
+  /** Which detected project files trigger this pack */
+  matchFiles?: string[];
+  /** Trigger when Xcode project targets one of these platforms */
+  matchXcodePlatforms?: XcodePlatform[];
+  /** Always include this pack in brownfield recommendations */
+  matchAlways?: boolean;
+}
+
+// ─── Curated Catalog ──────────────────────────────────────────────────────────
+
+export const SKILL_CATALOG: SkillPack[] = [
+  // ── 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: Array<{
+  id: string;
+  label: string;
+  description: string;
+  packs: string[];
+}> = [
+  {
+    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: ProjectSignals): SkillPack[] {
+  const matched = new Set<SkillPack>();
+
+  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: SkillPack): Promise<boolean> {
+  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: SkillPack[],
+  onProgress?: (label: string) => void,
+): Promise<string[]> {
+  // Group packs by repo
+  const byRepo = new Map<string, { skills: string[]; labels: string[] }>();
+  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: string[] = [];
+  for (const [repo, { skills, labels }] of byRepo) {
+    onProgress?.(labels.join(", "));
+    const ok = await new Promise<boolean>((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: SkillPack): boolean {
+  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: ExtensionCommandContext,
+  signals: ProjectSignals,
+): Promise<string[]> {
+  const installed: string[] = [];
+  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: string[] = [];
+    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;
+}