@claude-collective/cli 0.13.0 → 0.13.2

package/config/skills-matrix.yaml

@@ -0,0 +1,858 @@
+# =============================================================================
+# 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:
+  # ─────────────────────────────────────────────────────────────────
+  # Top-level categories
+  # ─────────────────────────────────────────────────────────────────
+  frontend:
+    id: frontend
+    name: Frontend
+    description: UI and client-side development
+    exclusive: false
+    required: false
+    order: 1
+    icon: "⚛️"
+
+  backend:
+    id: backend
+    name: Backend
+    description: API and server-side development
+    exclusive: false
+    required: false
+    order: 2
+    icon: "🔌"
+
+  mobile:
+    id: mobile
+    name: Mobile
+    description: Native mobile development
+    exclusive: false
+    required: false
+    order: 3
+    icon: "📱"
+
+  setup:
+    id: setup
+    name: Setup & Infrastructure
+    description: Project setup, tooling, and configuration
+    exclusive: false
+    required: false
+    order: 4
+    icon: "🛠️"
+
+  reviewing:
+    id: reviewing
+    name: Reviewing & Code Quality
+    description: Code review patterns, feedback principles, quality assurance
+    exclusive: false
+    required: false
+    order: 5
+    icon: "👀"
+
+  cli:
+    id: cli
+    name: CLI
+    description: Command-line tool development
+    exclusive: false
+    required: false
+    order: 6
+    icon: ">"
+
+  # ─────────────────────────────────────────────────────────────────
+  # Frontend subcategories
+  # ─────────────────────────────────────────────────────────────────
+  framework:
+    id: framework
+    name: Framework
+    description: Core UI framework (React, Vue, Angular, SolidJS)
+    parent: frontend
+    domain: web
+    exclusive: true
+    required: true
+    order: 1
+
+  meta-framework:
+    id: meta-framework
+    name: Meta-Framework
+    description: Full-stack framework (Next.js, Remix, Nuxt)
+    parent: frontend
+    domain: web
+    exclusive: true
+    required: false
+    order: 2
+
+  styling:
+    id: styling
+    name: Styling
+    description: CSS approach (SCSS Modules, Tailwind)
+    parent: frontend
+    domain: web
+    exclusive: true
+    required: true
+    order: 3
+
+  client-state:
+    id: client-state
+    name: Client State Management
+    description: UI state, forms, local data (Zustand, Redux, MobX)
+    parent: frontend
+    domain: web
+    exclusive: true
+    required: false
+    order: 4
+
+  server-state:
+    id: server-state
+    name: Server State / Data Fetching
+    description: API data caching (React Query, SWR)
+    parent: frontend
+    domain: web
+    exclusive: true
+    required: false
+    order: 5
+
+  forms:
+    id: forms
+    name: Forms & Validation
+    description: Form handling and schema validation
+    parent: frontend
+    domain: web
+    exclusive: false
+    required: false
+    order: 6
+
+  testing:
+    id: testing
+    name: Testing
+    description: Unit, integration, and E2E testing
+    parent: frontend
+    domain: web
+    exclusive: false
+    required: false
+    order: 7
+
+  ui-components:
+    id: ui-components
+    name: UI Component Library
+    description: Pre-built component systems (Radix, shadcn)
+    parent: frontend
+    domain: web
+    exclusive: false
+    required: false
+    order: 8
+
+  mocking:
+    id: mocking
+    name: API Mocking
+    description: Mock Service Worker for development and testing
+    parent: frontend
+    domain: web
+    exclusive: false
+    required: false
+    order: 10
+
+  # ─────────────────────────────────────────────────────────────────
+  # Backend subcategories
+  # ─────────────────────────────────────────────────────────────────
+  api:
+    id: api
+    name: API Framework
+    description: Backend framework (Hono, Express, Fastify)
+    parent: backend
+    domain: api
+    exclusive: true
+    required: true
+    order: 1
+
+  database:
+    id: database
+    name: Database ORM
+    description: Database access layer (Drizzle, Prisma)
+    parent: backend
+    domain: api
+    exclusive: true
+    required: false
+    order: 2
+
+  auth:
+    id: auth
+    name: Authentication
+    description: Auth solution (Better Auth, Auth.js)
+    parent: backend
+    domain: api
+    exclusive: true
+    required: false
+    order: 3
+
+  observability:
+    id: observability
+    name: Observability
+    description: Logging, monitoring, error tracking
+    parent: backend
+    domain: api
+    exclusive: false
+    required: false
+    order: 4
+
+  analytics:
+    id: analytics
+    name: Analytics
+    description: Product analytics and tracking
+    parent: backend
+    domain: api
+    exclusive: false
+    required: false
+    order: 5
+
+  email:
+    id: email
+    name: Email
+    description: Transactional email (Resend, Sendgrid)
+    parent: backend
+    domain: api
+    exclusive: true
+    required: false
+    order: 6
+
+  # ─────────────────────────────────────────────────────────────────
+  # Mobile subcategories
+  # ─────────────────────────────────────────────────────────────────
+  mobile-framework:
+    id: mobile-framework
+    name: Mobile Framework
+    description: Native mobile framework (React Native, Expo)
+    parent: mobile
+    domain: mobile
+    exclusive: true
+    required: true
+    order: 1
+
+  # ─────────────────────────────────────────────────────────────────
+  # Setup subcategories
+  # ─────────────────────────────────────────────────────────────────
+  monorepo:
+    id: monorepo
+    name: Monorepo
+    description: Monorepo tooling (Turborepo, Nx)
+    parent: setup
+    domain: shared
+    exclusive: true
+    required: false
+    order: 1
+
+  tooling:
+    id: tooling
+    name: Build Tooling
+    description: ESLint, Prettier, TypeScript, Vite
+    parent: setup
+    domain: shared
+    exclusive: false
+    required: false
+    order: 2
+
+  # ─────────────────────────────────────────────────────────────────
+  # CLI subcategories
+  # ─────────────────────────────────────────────────────────────────
+  cli-framework:
+    id: cli-framework
+    name: CLI Framework
+    description: CLI application framework (Commander, oclif, yargs)
+    parent: cli
+    domain: cli
+    exclusive: true
+    required: true
+    order: 1
+
+  cli-prompts:
+    id: cli-prompts
+    name: CLI Prompts
+    description: Interactive prompts and UI (Clack, Inquirer, Ink)
+    parent: cli
+    domain: cli
+    exclusive: true
+    required: false
+    order: 2
+
+  cli-testing:
+    id: cli-testing
+    name: CLI Testing
+    description: CLI testing utilities
+    parent: cli
+    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, yargs]
+      reason: "CLI frameworks are mutually exclusive"
+
+    # CLI prompt library conflicts
+    - skills: [clack, inquirer, ink]
+      reason: "CLI prompt libraries - choose one primary approach"
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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: [ink, vitest]
+      reason: "oclif + Ink is a powerful combo for rich CLI UIs"
+
+    - when: commander
+      suggest: [clack, vitest]
+      reason: "Commander + Clack is lightweight and elegant"
+
+    - when: yargs
+      suggest: [inquirer, vitest]
+      reason: "Yargs + Inquirer is a classic CLI combination"
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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, svelte, solidjs]
+      needs_any: true
+      reason: "URQL has first-party support for React, Vue, Svelte, and Solid (no Angular support)"
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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, yargs]
+
+    - purpose: "CLI Prompts"
+      skills: [clack, inquirer, ink]
+
+# =============================================================================
+# 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: skill not yet created
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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: skill not yet created
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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
+  # ─────────────────────────────────────────────────────────────────
+  backend-testing: "api-testing-api-testing"
+  backend-performance: "api-performance-api-performance"
+  frontend-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-cli-oclif"
+  yargs: "cli-framework-cli-yargs"
+
+  # CLI Prompts
+  clack: "cli-prompts-cli-clack"
+  inquirer: "cli-prompts-cli-inquirer"
+  ink: "cli-prompts-cli-ink"
+
+  # ─────────────────────────────────────────────────────────────────
+  # 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"