NextSpark-js
50 verified skills
create-plugin
Guide for creating new plugins from preset template. CRITICAL: Includes MANDATORY dependency management and Model B distribution rules.
tools
database-migrations
PostgreSQL migration patterns with RLS, Better Auth integration, and TIMESTAMPTZ. Covers main tables, meta tables, child entities, and sample data. Use this skill when creating migrations, validating SQL, or generating sample data.
data-ai
.claude/skills/monorepo-architecture
# NextSpark Monorepo Architecture ## Overview NextSpark uses a pnpm monorepo with strict separation of concerns between packages. ## Directory Structure ``` repo/ ├── packages/ │ ├── core/ # @nextsparkjs/core - Library only (no CLI) │ ├── cli/ # @nextsparkjs/cli - All CLI commands, wizard │ └── create-nextspark-app/ # Wrapper that installs CLI + runs init ├── themes/ │ ├── default/ # @nextsparkjs/theme-default │ ├── blog/ # @nextsparkjs/theme-
tools
scope-enforcement
Scope enforcement system for Claude Code workflow in this application. Covers scope.json configuration, path validation, violation handling, and scope change workflow. Use this skill when validating file modifications against session scope.
development
jira-integration
Jira integration patterns for project management. Covers REST API, webhooks, JQL queries, and automation. Use this skill when implementing Jira features or syncing sessions with issues.
tools
web-design-guidelines
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
development
accessibility
Accessibility (a11y) patterns for this Next.js application. Covers WCAG 2.1 AA compliance, ARIA attributes, keyboard navigation, focus management, and screen reader support. Use this skill when implementing accessible UI components or validating accessibility requirements.
tools
api-bypass-layers
Multi-layer security architecture for API bypass (superadmin/developer). Covers authentication layers, authorization, team context, RLS policies, and three-layer bypass validation. Use this skill when implementing admin bypass features or validating security architecture.
development
better-auth
Authentication patterns with Better Auth for this Next.js application. Covers session authentication, API key authentication, dual auth, OAuth, and testing. Use this skill when implementing or modifying authentication features.
development
billing-subscriptions
Multi-provider billing and subscription system for this Next.js application. Covers Gateway Factory pattern, Stripe integration, Polar.sh integration, Better Auth plugin, plans configuration, checkout flow, customer portal, webhooks, and usage tracking. Use this skill when implementing billing features or working with subscription management.
tools
core-theme-responsibilities
Core/Theme/Plugin responsibility assignment system for this application. Covers dependency direction, responsibility assignment rules, common anti-patterns, and validation. **CRITICAL SKILL** - Read before creating any technical plan involving core and theme/plugin interaction. See also: `monorepo-architecture` skill for package distribution and dependency management.
tools
cypress-api
API testing patterns with Cypress for CRUD operations. Covers BaseAPIController, entity controllers, test structure, and BDD documentation. Use this skill when writing API tests or creating new entity API controllers.
development
entity-api
Dynamic entity API patterns for CRUD operations. Covers entity resolution, query parameters, response formats, child entities, and metadata. Use this skill when consuming entity APIs or understanding dynamic endpoint behavior.
development
entity-system
Config-driven entity system for creating automatic CRUDs. Includes: config, fields, types, service, messages (i18n), migrations. Use this skill to create, modify, or understand system entities.
databases
github
GitHub workflow patterns for branch management, commits, and pull requests. Covers gitflow, branch naming conventions, commit messages, and PR creation. Use this skill for any Git/GitHub operations following project conventions.
tools
i18n-nextintl
Internationalization with next-intl for Next.js 15. Supports core/theme/entity message layers, namespace groups, and translation registry. Use this skill when adding translations, validating i18n, or working with localized content.
content-media
media-library
WordPress-style media management system for this Next.js application. Covers MediaService CRUD, file upload, tag system, duplicate detection, MediaLibrary modal, MediaSelector form field, and block editor integration. Use this skill when working with media uploads, browsing, or selection.
development
mock-analysis
Patterns for analyzing HTML/CSS mocks from Stitch, Figma, or similar tools. Covers section identification, component detection, and Tailwind config extraction. Use this skill when parsing mocks for block conversion.
tools
nextjs-api-development
REST API development with Next.js 15 App Router. Dual authentication (API Key + Session), dynamic entities, metadata system. Use this skill to create endpoints, validate APIs, or understand API patterns.
development
permissions-system
Three-layer permission system (Team Roles + Plans + Quotas) for this Next.js application. Covers user roles, team roles, theme extensions, permission checking, and RLS integration. Use this skill when implementing or modifying access control features.
tools
plugins
Plugin development system for this Next.js application. Covers plugin structure, configuration, lifecycle hooks, registry integration, environment variables, and testing patterns. CRITICAL: Includes MANDATORY dependency management rules for NPM distribution. Use this skill when creating, modifying, or validating plugins.
tools
react-patterns
Modern React patterns for this Next.js 15 application. Covers Server/Client Components, Context API, TanStack Query, Suspense, Error Boundaries, and performance patterns. Use this skill when implementing React components or understanding component architecture.
tools
rate-limiting
Rate limiting patterns for all API endpoints in this Next.js application. Covers distributed rate limiting with Redis, tier selection, HOC patterns, and security best practices. Use this skill when creating new API endpoints or reviewing rate limiting implementation.
development
scheduled-actions
Scheduled Actions system for background task processing in this application. Covers action scheduling, handler creation, webhook configuration, and cron processing. Use this skill when creating, debugging, or configuring scheduled actions.
development
service-layer
Service layer patterns for this Next.js application. Covers static class pattern, RLS integration, standard method signatures, and BaseEntityService. Use this skill when implementing business logic or data access services.
data-ai
.claude/skills/session-management
# Session Management Skill Sistema de gestión de sesiones de desarrollo para Claude Code. ## Conceptos Clave ### Tipos de Sesión | Tipo | T-Shirt | Workflow | Carpeta | Descripción | |------|---------|----------|---------|-------------| | **Story** | L - XL | COMPLETE | `stories/` | Features complejos, múltiples iteraciones | | **Task** | S - M | STANDARD | `tasks/` | Mejoras, bugs medianos | | **Log** | XS | QUICK | `logs/` | Fixes rápidos, cambios triviales | ### Estructura de Carpetas `
development
shadcn-components
shadcn/ui component patterns for this Next.js application. Covers available components, compound patterns, variants, form integration, and accessibility. Use this skill when building UI with shadcn/ui components.
development
suspense-loading
Suspense and loading state patterns for this Next.js application. Covers loading.tsx files, skeleton components, INP optimization, and streaming SSR. Use this skill when implementing loading states or optimizing perceived performance.
tools
tailwind-theming
Tailwind CSS theming system for this Next.js application. Covers CSS variables, semantic tokens, dark mode, buildSectionClasses, and theme build process. Use this skill when implementing UI styling or working with theme configurations.
development
test-coverage
Test coverage metrics and registry system for this Next.js application. Covers FEATURE_REGISTRY, FLOW_REGISTRY, TAGS_REGISTRY, and coverage metrics interpretation. Use this skill when evaluating test coverage, identifying gaps, or planning testing priorities.
testing
asana-integration
Asana integration patterns for work management. Covers Personal Access Tokens, webhooks, and task management. Use this skill when implementing Asana features or syncing sessions with tasks.
development
block-decision-matrix
Decision framework for determining new block vs variant vs existing. Covers decision criteria, edge cases, and anti-patterns. Use this skill when planning block conversion from mocks.
development
clickup-integration
ClickUp integration patterns for task management. Covers API authentication, webhooks, task sync, and MCP integration. Use this skill when implementing ClickUp features or syncing sessions with tasks.
tools
cypress-selectors
3-level selector system for testing: CORE_SELECTORS + BLOCK_SELECTORS + THEME_SELECTORS. Provides helpers sel(), cySelector(), entitySelectors() for components and POMs. Use this skill when working with data-cy attributes, POMs, or Cypress tests.
tools
create-theme
Guide for creating new themes from preset template. CRITICAL: Includes MANDATORY dependency management rules for NPM distribution.
documentation
cypress-e2e
End-to-End testing patterns with Cypress for UAT tests. Covers test structure, cy.session(), batch execution, tags, POMs, and BDD documentation. Use this skill when writing UAT tests or creating new entity test files.
testing
design-system
Theme-aware design system analysis and token mapping. Covers extracting theme tokens, mapping mock values, and gap analysis. CRITICAL: All values are EXAMPLES - always read actual theme globals.css.
development
documentation
Documentation patterns for this Next.js application. Covers documentation structure, numbered hierarchy, frontmatter, BDD format, and feature documentation. Use this skill when creating or maintaining project documentation.
development
impact-analysis
Impact analysis for understanding how code changes affect the system. Covers git diff analysis, entity mapping, flow identification, and regression suggestions. Use this skill when analyzing branches, planning testing, or understanding change scope.
development
jest-unit
Jest unit testing patterns for this Next.js application. Covers test structure, mocking strategies, React component testing, hook testing, and coverage targets. Use this skill when writing unit tests for services, hooks, utilities, or components.
development
notion-integration
Notion integration patterns for knowledge management. Covers API, databases, pages, and blocks. Use this skill when implementing Notion features or syncing sessions with databases.
development
npm-development-workflow
CRITICAL workflow for developing and testing NextSpark in dual-mode: monorepo AND npm. ALL changes MUST be validated in both environments before publishing. Defines the exact methodology, commands, and validation steps.
development
page-builder-blocks
Page builder block patterns for this Next.js application. Covers block structure (5 files), baseBlockSchema, field definitions, and component patterns. Use this skill when creating or modifying page builder blocks.
development
pom-patterns
Page Object Model patterns for Cypress tests with hierarchical structure. Covers BasePOM, DashboardEntityPOM, entity POMs, and selector integration. Use this skill when creating new POMs or extending existing ones.
testing
vercel-react-best-practices
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.
development
registry-system
Auto-generated registry system for this Next.js application. Covers Data-Only pattern, zero dynamic imports policy, registry structure, and rebuild process. Use this skill when working with registries or understanding import patterns.
development
server-actions
Next.js Server Actions for mutations in this application. Covers entity actions, user actions, team actions, and best practices. Use this skill when implementing mutations from Client Components.
tools
shadcn-theming
shadcn/ui theme customization for NextSpark applications. Covers tweakcn.com integration, CSS variable format, color space conversion, and theme initialization. Use this skill when initializing or customizing the design system for a theme.
development
zod-validation
Zod validation patterns for this Next.js application. Covers schema definition, API validation, form integration, error formatting, and type inference. Use this skill when implementing validation for APIs, forms, or entity schemas.
development
tanstack-query
TanStack Query (React Query) patterns for data fetching in this Next.js application. Covers useQuery, useMutation, optimistic updates, cache invalidation, and anti-patterns. Use this skill when implementing data fetching or state management with server data.
development