@agents-inc/cli 0.32.1

package/config/skills-matrix.yaml

@@ -0,0 +1,926 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/claude-collective/cli/main/src/schemas/skills-matrix.schema.json
+# =============================================================================
+# skills-matrix.yaml
+# Full skills matrix for CLI data-driven architecture
+# =============================================================================
+# This is the production skills matrix containing all relationships and stacks.
+# For testing, use skills-matrix-mvp.yaml (minimal 10-skill dataset).
+# =============================================================================
+
+version: "1.0.0"
+
+# =============================================================================
+# Categories (What the user selects)
+# =============================================================================
+
+categories:
+  # ─────────────────────────────────────────────────────────────────
+  # Web categories
+  # ─────────────────────────────────────────────────────────────────
+  framework:
+    id: framework
+    displayName: Framework
+    description: Core UI framework (React, Vue, Angular, SolidJS)
+    domain: web
+    exclusive: true
+    required: true
+    order: 1
+
+  meta-framework:
+    id: meta-framework
+    displayName: Meta-Framework
+    description: Full-stack framework (Next.js, Remix, Nuxt)
+    domain: web
+    exclusive: true
+    required: false
+    order: 2
+
+  styling:
+    id: styling
+    displayName: Styling
+    description: CSS approach (SCSS Modules, Tailwind)
+    domain: web
+    exclusive: true
+    required: true
+    order: 3
+
+  client-state:
+    id: client-state
+    displayName: Client State Management
+    description: UI state, forms, local data (Zustand, Redux, MobX)
+    domain: web
+    exclusive: true
+    required: false
+    order: 4
+
+  server-state:
+    id: server-state
+    displayName: Server State / Data Fetching
+    description: API data caching (React Query, SWR)
+    domain: web
+    exclusive: true
+    required: false
+    order: 5
+
+  forms:
+    id: forms
+    displayName: Forms & Validation
+    description: Form handling and schema validation
+    domain: web
+    exclusive: false
+    required: false
+    order: 6
+
+  testing:
+    id: testing
+    displayName: Testing
+    description: Unit, integration, and E2E testing
+    domain: web
+    exclusive: false
+    required: false
+    order: 7
+
+  ui-components:
+    id: ui-components
+    displayName: UI Component Library
+    description: Pre-built component systems (Radix, shadcn)
+    domain: web
+    exclusive: false
+    required: false
+    order: 8
+
+  mocking:
+    id: mocking
+    displayName: API Mocking
+    description: Mock Service Worker for development and testing
+    domain: web
+    exclusive: false
+    required: false
+    order: 10
+
+  error-handling:
+    id: error-handling
+    displayName: Error Handling
+    description: Error boundaries, result types, and error patterns
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 11
+
+  i18n:
+    id: i18n
+    displayName: Internationalization
+    description: i18n libraries (next-intl, react-intl, vue-i18n)
+    domain: web
+    exclusive: true
+    required: false
+    order: 12
+
+  file-upload:
+    id: file-upload
+    displayName: File Upload
+    description: File upload patterns and handling
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 13
+
+  files:
+    id: files
+    displayName: Files & Images
+    description: Image handling and file processing
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 14
+
+  utilities:
+    id: utilities
+    displayName: Utilities
+    description: Utility libraries (date-fns, native JS patterns)
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 15
+
+  realtime:
+    id: realtime
+    displayName: Realtime
+    description: WebSockets, SSE, and real-time communication
+    domain: web-extras
+    parent_domain: web
+    exclusive: true
+    required: false
+    order: 16
+
+  animation:
+    id: animation
+    displayName: Animation
+    description: Animation libraries and CSS animations
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 17
+
+  pwa:
+    id: pwa
+    displayName: Progressive Web App
+    description: Service workers, offline-first patterns, and PWA features
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 18
+
+  accessibility:
+    id: accessibility
+    displayName: Accessibility
+    description: WCAG compliance, ARIA, and keyboard navigation
+    domain: web-extras
+    parent_domain: web
+    exclusive: false
+    required: false
+    order: 19
+
+  web-performance:
+    id: web-performance
+    displayName: Web Performance
+    description: Bundle optimization, render performance, and code splitting
+    domain: web
+    exclusive: false
+    required: false
+    order: 20
+
+  # ─────────────────────────────────────────────────────────────────
+  # API categories
+  # ─────────────────────────────────────────────────────────────────
+  api:
+    id: api
+    displayName: API Framework
+    description: Backend framework (Hono, Express, Fastify)
+    domain: api
+    exclusive: true
+    required: true
+    order: 1
+
+  database:
+    id: database
+    displayName: Database ORM
+    description: Database access layer (Drizzle, Prisma)
+    domain: api
+    exclusive: true
+    required: false
+    order: 2
+
+  auth:
+    id: auth
+    displayName: Authentication
+    description: Auth solution (Better Auth, Auth.js)
+    domain: api
+    exclusive: true
+    required: false
+    order: 3
+
+  observability:
+    id: observability
+    displayName: Observability
+    description: Logging, monitoring, error tracking
+    domain: api
+    exclusive: false
+    required: false
+    order: 4
+
+  analytics:
+    id: analytics
+    displayName: Analytics
+    description: Product analytics and tracking
+    domain: api
+    exclusive: false
+    required: false
+    order: 5
+
+  email:
+    id: email
+    displayName: Email
+    description: Transactional email (Resend, Sendgrid)
+    domain: api
+    exclusive: true
+    required: false
+    order: 6
+
+  performance:
+    id: performance
+    displayName: Performance
+    description: API performance patterns and optimization
+    domain: api
+    exclusive: false
+    required: false
+    order: 7
+
+  # ─────────────────────────────────────────────────────────────────
+  # Mobile categories
+  # ─────────────────────────────────────────────────────────────────
+  mobile-framework:
+    id: mobile-framework
+    displayName: Mobile Framework
+    description: Native mobile framework (React Native, Expo)
+    domain: mobile
+    exclusive: true
+    required: true
+    order: 1
+
+  # ─────────────────────────────────────────────────────────────────
+  # Shared / Infrastructure categories
+  # ─────────────────────────────────────────────────────────────────
+  monorepo:
+    id: monorepo
+    displayName: Monorepo
+    description: Monorepo tooling (Turborepo, Nx)
+    domain: shared
+    exclusive: true
+    required: false
+    order: 1
+
+  tooling:
+    id: tooling
+    displayName: Build Tooling
+    description: ESLint, Prettier, TypeScript, Vite
+    domain: shared
+    exclusive: false
+    required: false
+    order: 2
+
+  security:
+    id: security
+    displayName: Security
+    description: Authentication security patterns and best practices
+    domain: shared
+    exclusive: false
+    required: false
+    order: 3
+
+  methodology:
+    id: methodology
+    displayName: Methodology
+    description: Development methodology and engineering principles
+    domain: shared
+    exclusive: false
+    required: false
+    order: 4
+
+  research:
+    id: research
+    displayName: Research
+    description: Codebase investigation and research methodology
+    domain: shared
+    exclusive: false
+    required: false
+    order: 5
+
+  reviewing:
+    id: reviewing
+    displayName: Code Review
+    description: Code review patterns and guidance
+    domain: shared
+    exclusive: false
+    required: false
+    order: 6
+
+  ci-cd:
+    id: ci-cd
+    displayName: CI/CD
+    description: Continuous integration and deployment pipelines
+    domain: shared
+    exclusive: false
+    required: false
+    order: 7
+
+  # ─────────────────────────────────────────────────────────────────
+  # CLI categories
+  # ─────────────────────────────────────────────────────────────────
+  cli-framework:
+    id: cli-framework
+    displayName: CLI Framework
+    description: CLI application framework (Commander, oclif)
+    domain: cli
+    exclusive: true
+    required: true
+    order: 1
+
+  cli-prompts:
+    id: cli-prompts
+    displayName: CLI Prompts
+    description: Interactive prompts and UI
+    domain: cli
+    exclusive: true
+    required: false
+    order: 2
+
+  cli-testing:
+    id: cli-testing
+    displayName: CLI Testing
+    description: CLI testing utilities
+    domain: cli
+    exclusive: false
+    required: false
+    order: 3
+
+# =============================================================================
+# Relationships (The Intelligence)
+# =============================================================================
+
+relationships:
+  # ─────────────────────────────────────────────────────────────────
+  # CONFLICTS (Mutually exclusive - selecting A disables B)
+  # ─────────────────────────────────────────────────────────────────
+  conflicts:
+    # Framework conflicts (only one core framework)
+    - skills: [react, vue, angular, solidjs]
+      reason: "Core frameworks are mutually exclusive within a single application. Exception: micro-frontend architectures (Single-SPA, Module Federation) can combine frameworks in isolation."
+
+    # Meta-framework conflicts
+    - skills: [nextjs-app-router, remix, nuxt]
+      reason: "Meta-frameworks are mutually exclusive - choose one"
+
+    # NOTE: scss-modules/tailwind moved to discourages - they're technically compatible
+
+    # Client state management (Vue ecosystem)
+    # NOTE: zustand/redux-toolkit/mobx moved to discourages - can coexist for migrations
+    - skills: [pinia, zustand, redux-toolkit, mobx]
+      reason: "Pinia is Vue-only. Our zustand/redux-toolkit/mobx skills teach React patterns (though these libraries technically support other frameworks)."
+
+    # Client state management (Angular ecosystem)
+    - skills: [ngrx-signalstore, zustand, pinia, redux-toolkit, mobx]
+      reason: "NgRx SignalStore is Angular-only"
+
+    # Server state / data fetching conflicts
+    - skills: [react-query, swr]
+      reason: "Both solve server state caching - choose one"
+
+    # GraphQL client conflicts
+    - skills: [graphql-apollo, graphql-urql]
+      reason: "Both are GraphQL clients - choose one"
+
+    # E2E testing conflicts
+    - skills: [playwright-e2e, cypress-e2e]
+      reason: "Both are E2E frameworks - choose one"
+
+    # Form libraries by framework
+    - skills: [react-hook-form, vee-validate]
+      reason: "react-hook-form is React-only, vee-validate is Vue-only"
+
+    # Testing library conflicts
+    - skills: [react-testing-library, vue-test-utils]
+      reason: "Framework-specific testing libraries"
+
+    # Backend API framework conflicts
+    - skills: [hono, express, fastify]
+      reason: "API frameworks are mutually exclusive within a single service. Multiple frameworks can coexist in monorepo architectures."
+
+    # Database ORM conflicts
+    - skills: [drizzle, prisma]
+      reason: "Both are ORMs serving similar purposes. Choose one per service; migration scenarios and multi-service architectures may involve both."
+
+    # CLI framework conflicts
+    - skills: [commander, oclif]
+      reason: "CLI frameworks are mutually exclusive"
+
+    # CLI prompt library conflicts
+    # NOTE: clack, inquirer, ink skills not yet created
+
+  # ─────────────────────────────────────────────────────────────────
+  # DISCOURAGES (Soft warnings - selecting A shows warning for B but doesn't disable)
+  # ─────────────────────────────────────────────────────────────────
+  discourages:
+    # Styling paradigm mixing is unusual but technically compatible
+    - skills: [scss-modules, tailwind]
+      reason: "Mixing CSS paradigms causes slower builds (Tailwind runs per-module) and inconsistent patterns - pick one approach for new projects. Valid for gradual migrations."
+
+    # React state libraries - can coexist but adds complexity
+    - skills: [zustand, redux-toolkit, mobx]
+      reason: "Using multiple React state libraries adds complexity - choose one primary approach. Migration patterns exist for gradual transitions."
+
+    # Redux is heavy for small projects with Zustand available
+    - skills: [redux-toolkit, zustand]
+      reason: "Redux Toolkit adds more boilerplate than Zustand - consider if you need its features"
+
+    # SWR is simpler but less featured than React Query
+    - skills: [swr, react-query]
+      reason: "SWR is simpler but React Query has more features - consider your needs"
+
+    # Express is legacy compared to modern alternatives
+    - skills: [express, hono]
+      reason: "Express is mature but Hono offers better performance and edge support"
+
+    - skills: [express, fastify]
+      reason: "Express is mature but Fastify offers better performance"
+
+    # Cypress vs Playwright - different strengths
+    - skills: [cypress-e2e, playwright-e2e]
+      reason: "Cypress excels at interactive debugging and component testing; Playwright has better cross-browser support, parallelization, and CI/CD performance"
+
+  # ─────────────────────────────────────────────────────────────────
+  # RECOMMENDS (Soft suggestions - selecting A highlights B)
+  # ─────────────────────────────────────────────────────────────────
+  recommends:
+    # React ecosystem recommendations
+    - when: react
+      suggest: [zustand, react-query, vitest, react-hook-form, react-testing-library]
+      reason: "Best-in-class React libraries"
+
+    # Next.js recommendations
+    - when: nextjs-app-router
+      suggest: [react-query, zustand, shadcn-ui]
+      reason: "Next.js App Router ecosystem"
+
+    # Remix recommendations
+    - when: remix
+      suggest: [zustand, vitest, zod-validation]
+      reason: "Remix-compatible libraries"
+
+    # Vue ecosystem recommendations
+    - when: vue
+      suggest: [pinia, vee-validate, vue-test-utils]
+      reason: "Vue community standard libraries (Pinia is official, VeeValidate is community-maintained)"
+
+    # Angular ecosystem recommendations
+    - when: angular
+      suggest: [ngrx-signalstore]
+      reason: "Angular Signals-based state management"
+
+    # SolidJS recommendations
+    - when: solidjs
+      suggest: [vitest, tailwind]
+      reason: "SolidJS-compatible libraries"
+
+    # Backend recommendations
+    - when: hono
+      suggest: [drizzle, better-auth, zod-validation]
+      reason: "Hono + Drizzle + Better Auth is a powerful combo"
+
+    - when: drizzle
+      suggest: [zod-validation]
+      reason: "Drizzle types work great with Zod"
+
+    # Styling recommendations
+    - when: scss-modules
+      suggest: [radix-ui]
+      reason: "Radix primitives work well with any CSS approach"
+
+    - when: tailwind
+      suggest: [shadcn-ui]
+      reason: "shadcn/ui is built for Tailwind"
+
+    # UI component recommendations
+    - when: shadcn-ui
+      suggest: [radix-ui, tailwind]
+      reason: "shadcn/ui uses Radix primitives and Tailwind"
+
+    # Form recommendations
+    - when: react-hook-form
+      suggest: [zod-validation]
+      reason: "react-hook-form + Zod is the standard pattern"
+
+    - when: vee-validate
+      suggest: [zod-validation]
+      reason: "vee-validate supports Zod schemas"
+
+    # Testing recommendations
+    - when: vitest
+      suggest: [react-testing-library, msw]
+      reason: "Vitest + RTL + MSW is the modern testing stack"
+
+    - when: playwright-e2e
+      suggest: [vitest]
+      reason: "Playwright for E2E, Vitest for unit/integration"
+
+    # Server state recommendations
+    - when: react-query
+      suggest: [zod-validation]
+      reason: "Type-safe API responses with Zod"
+
+    # Mobile recommendations
+    - when: react-native
+      suggest: [zustand, react-query, react-hook-form, zod-validation]
+      reason: "React Native shares React ecosystem. Note: Use Jest for testing (Vitest doesn't support RN)."
+
+    # Observability recommendations
+    - when: axiom-pino-sentry
+      suggest: [posthog]
+      reason: "Complete observability with analytics"
+
+    # NOTE: Removed resend recommends [react] - Resend works with plain HTML/text, React Email is optional
+
+    # Fastify recommendations
+    - when: fastify
+      suggest: [drizzle, zod-validation]
+      reason: "Fastify + Drizzle + Zod is a solid backend stack"
+
+    # Express recommendations
+    - when: express
+      suggest: [prisma]
+      reason: "Express + Prisma is a classic combination"
+
+    # Nuxt recommendations
+    - when: nuxt
+      suggest: [pinia, tailwind, playwright-e2e]
+      reason: "Nuxt ecosystem libraries"
+
+    # MSW recommendations
+    - when: msw
+      suggest: [vitest, react-testing-library]
+      reason: "MSW + Vitest + RTL is the modern testing stack"
+
+    # Cypress recommendations
+    - when: cypress-e2e
+      suggest: [vitest]
+      reason: "Cypress for E2E, Vitest for unit tests"
+
+    # CLI recommendations
+    - when: oclif
+      suggest: [vitest]
+      reason: "oclif pairs well with Vitest for CLI testing"
+
+    - when: commander
+      suggest: [vitest]
+      reason: "Commander pairs well with Vitest for CLI testing"
+
+  # ─────────────────────────────────────────────────────────────────
+  # REQUIRES (Hard dependencies - A requires B to be selected first)
+  # ─────────────────────────────────────────────────────────────────
+  requires:
+    # React-specific libraries (note: these libraries have vanilla/other-framework options, but our skills teach React patterns)
+    - skill: zustand
+      needs: [react, react-native]
+      needs_any: true
+      reason: "Our Zustand skill covers React/React Native patterns (zustand/vanilla exists for other frameworks)"
+
+    - skill: redux-toolkit
+      needs: [react, react-native]
+      needs_any: true
+      reason: "Our Redux Toolkit skill covers React/React Native patterns (RTK core is framework-agnostic)"
+
+    - skill: mobx
+      needs: [react]
+      reason: "Our MobX skill teaches React patterns. Note: MobX core has official Vue (mobx-vue) and Angular (mobx-angular) bindings."
+
+    - skill: react-query
+      needs: [react, react-native]
+      needs_any: true
+      reason: "TanStack Query's React adapter. Note: TanStack Query also supports Vue, Solid, Svelte via separate adapters."
+
+    - skill: swr
+      needs: [react, react-native]
+      needs_any: true
+      reason: "SWR is a React Hooks library. For React Native, requires @nandorojo/swr-react-native wrapper."
+
+    - skill: react-hook-form
+      needs: [react, react-native]
+      needs_any: true
+      reason: "React Hook Form is React only"
+
+    - skill: react-testing-library
+      needs: [react]
+      reason: "React Testing Library is React only"
+
+    # Vue-specific libraries
+    - skill: pinia
+      needs: [vue]
+      reason: "Pinia is Vue only"
+
+    - skill: vee-validate
+      needs: [vue]
+      reason: "VeeValidate is Vue only"
+
+    - skill: vue-test-utils
+      needs: [vue]
+      reason: "Vue Test Utils is Vue only"
+
+    # Angular-specific libraries
+    - skill: ngrx-signalstore
+      needs: [angular]
+      reason: "NgRx SignalStore is Angular only"
+
+    # Next.js specific
+    - skill: nextjs-app-router
+      needs: [react]
+      reason: "Next.js is built on React"
+
+    # Remix specific
+    - skill: remix
+      needs: [react]
+      reason: "Remix is built on React"
+
+    # Backend dependencies
+    - skill: better-auth
+      needs: [drizzle, prisma]
+      needs_any: true
+      reason: "Better Auth supports multiple database adapters (Drizzle, Prisma, Kysely, MongoDB). Our skill uses Drizzle adapter."
+
+    # NOTE: Removed drizzle/prisma requires API framework - ORMs work standalone for scripts, CLI tools, workers, etc.
+
+    # UI component dependencies
+    - skill: shadcn-ui
+      needs: [react, tailwind]
+      reason: "shadcn/ui requires React and Tailwind"
+
+    # GraphQL clients need a framework
+    - skill: graphql-apollo
+      needs: [react, vue, angular]
+      needs_any: true
+      reason: "Apollo Client - first-party React support, community-maintained Vue/Angular integrations. Note: Svelte/Solid bindings exist but are stale (2020-2022)."
+
+    - skill: graphql-urql
+      needs: [react, vue, solidjs]
+      needs_any: true
+      reason: "URQL has first-party support for React, Vue, and Solid (no Angular support). Svelte support exists but skill not yet created."
+
+  # ─────────────────────────────────────────────────────────────────
+  # ALTERNATIVES (Interchangeable options for same purpose)
+  # ─────────────────────────────────────────────────────────────────
+  alternatives:
+    - purpose: "Frontend Framework"
+      skills: [react, vue, angular, solidjs]
+
+    - purpose: "React Meta-Framework"
+      skills: [nextjs-app-router, remix]
+
+    - purpose: "Styling"
+      skills: [scss-modules, tailwind]
+
+    - purpose: "Client State (React)"
+      skills: [zustand, redux-toolkit, mobx, jotai]
+
+    - purpose: "Client State (Vue)"
+      skills: [pinia]
+
+    - purpose: "Client State (Angular)"
+      skills: [ngrx-signalstore]
+
+    - purpose: "Server State / Data Fetching"
+      skills: [react-query, swr]
+
+    - purpose: "GraphQL Client"
+      skills: [graphql-apollo, graphql-urql]
+
+    - purpose: "API Framework"
+      skills: [hono, express, fastify]
+
+    - purpose: "Database ORM"
+      skills: [drizzle, prisma]
+
+    - purpose: "Forms (React)"
+      skills: [react-hook-form]
+
+    - purpose: "Forms (Vue)"
+      skills: [vee-validate]
+
+    - purpose: "Validation"
+      skills: [zod-validation]
+
+    - purpose: "Unit Testing"
+      skills: [vitest]
+
+    - purpose: "Component Testing (React)"
+      skills: [react-testing-library]
+
+    - purpose: "Component Testing (Vue)"
+      skills: [vue-test-utils]
+
+    - purpose: "E2E Testing"
+      skills: [playwright-e2e, cypress-e2e]
+
+    - purpose: "API Mocking"
+      skills: [msw]
+
+    - purpose: "UI Components (React + Tailwind)"
+      skills: [shadcn-ui]
+
+    - purpose: "Mobile"
+      skills: [react-native]
+
+    - purpose: "CLI Framework"
+      skills: [commander, oclif]
+
+    # CLI Prompts alternatives: clack, inquirer, ink skills not yet created
+
+# =============================================================================
+# Skill Aliases (Map short names to normalized skill IDs)
+# =============================================================================
+# Skill IDs are now in normalized kebab-case format:
+# - No author suffix (author is metadata only)
+# - Slashes replaced with dashes
+# - Plus signs replaced with dashes
+# - Lowercase
+# =============================================================================
+
+skill_aliases:
+  # ─────────────────────────────────────────────────────────────────
+  # Frameworks - normalized skill IDs
+  # ─────────────────────────────────────────────────────────────────
+  react: "web-framework-react"
+  vue: "web-framework-vue-composition-api"
+  angular: "web-framework-angular-standalone"
+  solidjs: "web-framework-solidjs"
+
+  # Meta-frameworks
+  nextjs-app-router: "web-framework-nextjs-app-router"
+  nextjs-server-actions: "web-framework-nextjs-server-actions"
+  remix: "web-framework-remix"
+  nuxt: "web-framework-nuxt"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Styling
+  # ─────────────────────────────────────────────────────────────────
+  scss-modules: "web-styling-scss-modules"
+  cva: "web-styling-cva"
+  tailwind: "web-styling-tailwind"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Client State
+  # ─────────────────────────────────────────────────────────────────
+  zustand: "web-state-zustand"
+  redux-toolkit: "web-state-redux-toolkit"
+  pinia: "web-state-pinia"
+  ngrx-signalstore: "web-state-ngrx-signalstore"
+  jotai: "web-state-jotai"
+  mobx: "web-state-mobx"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Server State / Data Fetching
+  # ─────────────────────────────────────────────────────────────────
+  react-query: "web-server-state-react-query"
+  swr: "web-data-fetching-swr"
+  graphql-apollo: "web-data-fetching-graphql-apollo"
+  graphql-urql: "web-data-fetching-graphql-urql"
+  trpc: "web-data-fetching-trpc"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Forms & Validation
+  # ─────────────────────────────────────────────────────────────────
+  react-hook-form: "web-forms-react-hook-form"
+  vee-validate: "web-forms-vee-validate"
+  zod-validation: "web-forms-zod-validation"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Testing
+  # ─────────────────────────────────────────────────────────────────
+  vitest: "web-testing-vitest"
+  playwright-e2e: "web-testing-playwright-e2e"
+  cypress-e2e: "web-testing-cypress-e2e"
+  react-testing-library: "web-testing-react-testing-library"
+  vue-test-utils: "web-testing-vue-test-utils"
+  msw: "web-mocks-msw"
+
+  # ─────────────────────────────────────────────────────────────────
+  # UI Components
+  # ─────────────────────────────────────────────────────────────────
+  shadcn-ui: "web-ui-shadcn-ui"
+  tanstack-table: "web-ui-tanstack-table"
+  radix-ui: "web-ui-radix-ui"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Backend - API Framework
+  # ─────────────────────────────────────────────────────────────────
+  hono: "api-framework-hono"
+  express: "api-framework-express"
+  fastify: "api-framework-fastify"
+
+  # Backend - Database
+  drizzle: "api-database-drizzle"
+  prisma: "api-database-prisma"
+
+  # Backend - Auth (composite skill)
+  better-auth: "api-auth-better-auth-drizzle-hono"
+
+  # Backend - Observability (composite skill)
+  axiom-pino-sentry: "api-observability-axiom-pino-sentry"
+
+  # Backend - Analytics
+  posthog: "api-analytics-posthog-analytics"
+  posthog-flags: "api-flags-posthog-flags"
+
+  # Backend - Email (composite skill)
+  resend: "api-email-resend-react-email"
+
+  # Backend - CI/CD
+  github-actions: "api-ci-cd-github-actions"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Mobile
+  # ─────────────────────────────────────────────────────────────────
+  react-native: "mobile-framework-react-native"
+  expo: "mobile-framework-expo"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Setup / Infrastructure
+  # ─────────────────────────────────────────────────────────────────
+  turborepo: "infra-monorepo-turborepo"
+  tooling: "infra-tooling-setup-tooling"
+  posthog-setup: "api-analytics-setup-posthog"
+  env: "infra-env-setup-env"
+  observability-setup: "api-observability-setup-axiom-pino-sentry"
+  email-setup: "api-email-setup-resend"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Additional Skills (Animation, PWA, Realtime, etc.)
+  # ─────────────────────────────────────────────────────────────────
+  framer-motion: "web-animation-framer-motion"
+  css-animations: "web-animation-css-animations"
+  view-transitions: "web-animation-view-transitions"
+  storybook: "web-tooling-storybook"
+  error-boundaries: "web-error-handling-error-boundaries"
+  accessibility: "web-accessibility-web-accessibility"
+  websockets: "web-realtime-websockets"
+  sse: "web-realtime-sse"
+  socket-io: "web-realtime-socket-io"
+  service-workers: "web-pwa-service-workers"
+  file-upload: "web-files-file-upload-patterns"
+  image-handling: "web-files-image-handling"
+  date-fns: "web-utilities-date-fns"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Backend-specific category skills
+  # ─────────────────────────────────────────────────────────────────
+  api-testing: "api-testing-api-testing"
+  api-performance: "api-performance-api-performance"
+  web-performance: "web-performance-web-performance"
+
+  # Security
+  security: "security-auth-security"
+
+  # ─────────────────────────────────────────────────────────────────
+  # CLI
+  # ─────────────────────────────────────────────────────────────────
+  # CLI Framework
+  commander: "cli-framework-cli-commander"
+  cli-commander: "cli-framework-cli-commander"
+  oclif: "cli-framework-oclif-ink"
+  # yargs: skill not yet created
+
+  # CLI Prompts
+  # clack: skill not yet created
+  # inquirer: skill not yet created
+  # ink: skill not yet created
+
+  # ─────────────────────────────────────────────────────────────────
+  # Reviewing / Meta
+  # ─────────────────────────────────────────────────────────────────
+  reviewing: "meta-reviewing-reviewing"
+  cli-reviewing: "meta-reviewing-cli-reviewing"
+  research-methodology: "meta-research-research-methodology"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Methodology (Universal principles + Implementation + Extended session)
+  # ─────────────────────────────────────────────────────────────────
+  investigation-requirements: "meta-methodology-investigation-requirements"
+  anti-over-engineering: "meta-methodology-anti-over-engineering"
+  success-criteria: "meta-methodology-success-criteria"
+  write-verification: "meta-methodology-write-verification"
+  improvement-protocol: "meta-methodology-improvement-protocol"
+  context-management: "meta-methodology-context-management"