c297fe2e34
QA12-1: Replace generic Gradle/POM matching for Java & Spring Boot with a real framework marker () detected by scanning pom.xml and Gradle files for Spring Boot plugins/dependencies. This restores nested Gradle service detection without reintroducing Android false positives. QA12-2: Prevent standard Android projects (root build.gradle + app/build.gradle) from matching the Spring Boot pack. Spring Boot now requires the synthetic dependency marker, not generic build files. QA12-3: Harden FastAPI detection: - strip comments before matching - scan each dependency file independently - continue on per-file read errors instead of failing the whole scan Also add regression tests for comment-only FastAPI mentions, nested Spring Boot Gradle services, Android non-Spring Gradle projects, and Spring Boot pack matching via dep:spring-boot.
1085 lines
39 KiB
TypeScript
1085 lines
39 KiB
TypeScript
/**
|
|
* 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;
|
|
}
|