ghcopilot-hub

Next.js 16 App Router patterns for Server Components, Server Actions, route handlers, caching, streaming, and version-sensitive request APIs. Trigger: Use when working in Next.js 16 App Router code with app/, layout.tsx, page.tsx, loading.tsx, generateMetadata, Server Actions, route.ts handlers, revalidatePath/revalidateTag, cookies()/headers()/params async APIs, middleware.ts vs proxy.ts naming, or RSC streaming and serialization issues.

Next.js best practices - file conventions, RSC boundaries, data patterns, async APIs, metadata, error handling, route handlers, image/font optimization, bundling

React 19 patterns with Compiler-aware guidance, composition, refs, and effects. Trigger: When working with React components (.tsx, .jsx), effects, refs, context APIs, or render performance/memoization decisions.

Layer-aware testing strategies for Clean Architecture using Vitest, React Testing Library, MSW, and Cypress. Use when creating or reviewing unit, integration, component, architectural, or E2E test plans across `src/domain`, `src/application`, `src/infrastructure`, `src/interface`, and `src/presentation`, especially for mocking-boundary decisions, async reliability, and flaky-test prevention. Trigger keywords: test, vitest, cypress, e2e, mock, msw, renderHook, loader, query, router, zustand.

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

Advanced TypeScript decision patterns for strict typing: satisfies vs type annotations, exhaustiveness checks, const-derived unions, and performance-aware control/data flow. Trigger: Use when the task involves TypeScript modeling decisions (type vs interface, enum alternatives), strict mode/type errors, generics, utility types, or hot-path performance issues in branching/looping.

Architecture tests with ArchUnitTS for Clean Architecture boundaries and import rules. Trigger: When adding or updating architecture tests or enforcing layer dependency rules.

Workflow for repositories managed by ghcopilot-hub. Trigger: Use when the repository contains `.github/ghcopilot-hub.json`, managed files under `.github/agents/` or `.github/skills/`, or when the user asks to run ghcopilot-hub commands, add/remove packs or skills, inspect drift, update managed files, or customize a consumer repository safely.

Expert Mermaid diagram design, validation, debugging, and style calibration for docs and architecture communication. Trigger: Use when users ask to create, fix, refactor, validate, or theme Mermaid diagrams (flowchart, sequence, class, state, gantt, C4), when they report parser/syntax/render readability issues, or when they mention connectors, arrows, mermaid-validate, or CLI verification.

High-performance React Hook Form patterns for Clean Architecture applications, including subscription isolation, controlled-component wiring, field-array safety, async defaults, and Zod boundary design. Use this skill when implementing or reviewing useForm, useWatch, useController, useFieldArray, resolver/defaultValues, or when debugging form re-render/performance issues in React + TypeScript projects.

Creates new AI agent skills or updates existing ones following the Agent Skills spec. Trigger: When user asks to create or update a new skill, add agent instructions, or document patterns for AI.

Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Provides multi-dimensional scoring and actionable improvement suggestions.

Tailwind CSS 4 patterns and best practices. Trigger: When styling with Tailwind - cn(), theme variables, no var() in className.

Advanced TanStack Query v5 extensions. Trigger: when implementing advanced Query patterns, v5 migrations, cache optimizations, mutation lifecycle handling, or query error propagation strategies.

TanStack Router patterns aligned with the project Clean Architecture and the ghcopilot-hub-tanstack skill. Trigger: When implementing or refactoring routing, loaders, search params, router defaults, route-level error boundaries, and recovery flows.

Implement Query + Router data flows for this Clean Architecture repo using render-as-you-fetch. Trigger: Use when the task involves queryOptions factories, route loaders, ensureQueryData, search params validation, query keys, preloading, Suspense data consumption, skeleton fallbacks, route error boundaries, mutation error feedback, or URL-driven data fetching with @tanstack/react-query and @tanstack/react-router.

Zod 4 schema validation patterns. Trigger: When using Zod for validation - breaking changes from v3.

Zustand 5 state management patterns. Trigger: When managing React state with Zustand.