squareone

Run `biome migrate` whenever the @biomejs/biome version changes so biome.json's $schema (and any deprecated config) stays in sync with the installed Biome. Use when processing a dependabot PR that bumps @biomejs/biome (it arrives via the npm monorepo-infra group), when biome:lint/biome:format reports an info like "Expected: <new> Found: <old> — Run the command biome migrate", or any time you notice biome.json's $schema version lagging the installed Biome, or when the "Validate Biome schema version" CI step (validate-biome-schema.js) fails. Trigger keywords: biome, @biomejs/biome, biome migrate, biome.json, $schema mismatch, schema version, dependabot biome bump, Biome upgrade.

Reference for IVOA (International Virtual Observatory Alliance) standards relevant to the Rubin Science Platform — TAP, SIA, SODA, DataLink, ObsCore, VOTable, UWS, VOSI, SSO/GMS, HiPS, and registry standards — with canonical documentation links and how each maps to RSP services. Use when working on the /api-aspect page, labeling or linking API endpoints, interpreting Repertoire service discovery, curating the api-aspect presentation map, or when the user mentions IVOA, VO standards, the Virtual Observatory, or a protocol acronym (TAP, SIA, SSA, SCS, SODA, DataLink, DALI, ObsCore, ADQL, VOTable, UWS, VOSI, SSO, GMS, HiPS, MOC).

Project-specific build/test/lint/typing commands for this repo. Read this skill at the start of any phase that runs validation (`stoker-work`, `stoker-fixup`, `stoker-rebase`).

Validates that version strings in Dockerfiles match package.json dependencies and constraints. Use when updating Docker base images, Node.js versions, pnpm versions, turbo versions, or other tool versions in Dockerfiles. Ensures consistency between Dockerfile versions and package.json engines, devDependencies, and packageManager fields. Automatically runs on pre-commit for Dockerfile changes and in CI pipeline. Trigger keywords: Dockerfile, Docker version, Node version, pnpm version, turbo version, version mismatch, version sync, Docker update.

Critical architecture knowledge for the squared component library package. Use this skill when working on squared package components, troubleshooting build/transpilation issues, or setting up apps to consume squared. Covers the NO BUILD STEP architecture, CSS Modules-only styling requirement, Next.js transpilation configuration, direct TypeScript source exports, and testing infrastructure.

Local-first GitHub issue planning and synchronization system. Use this skill when planning projects locally, creating issue files in .issues/, working with the /plan-issue, /update-issue, /sync-issue, /list-issues, or /work-issue commands, or synchronizing local plans with GitHub issues. Covers frontmatter schema, file structure conventions, sub-issue management, and gh CLI operations.

Comprehensive guide for creating React components in the squared package and squareone app. Use this skill when creating new components, setting up component structure, implementing CSS Modules styling, writing Storybook stories, or setting up component tests. Covers TypeScript patterns (type vs interface, no React.FC), CSS Modules with design tokens, compound component patterns, Storybook integration, and vitest testing.

Complete reference for Rubin Observatory design system CSS variables and design tokens. Use this skill when styling components, referencing CSS custom properties, understanding the design token architecture, or working with colors, spacing, typography, and other design primitives. Covers both rubin-style-dictionary foundation tokens and squareone-specific tokens.

How to use the file-factory CLI to create new React components, hooks, context providers, Next.js pages along with associated tests and storybook stories. ALWAYS use this tool instead of manually creating new components/hooks/contexts/pages to ensure consistent file structure and conventions.

Expert guidance for working with the AppConfig runtime configuration system in squareone. Use this skill when implementing configuration loading, working with YAML config files, setting up new pages that need configuration, troubleshooting config hydration issues, or migrating from next/config patterns. Covers server-side loadAppConfig(), client-side useAppConfig(), MDX content loading, Sentry configuration injection, and Kubernetes ConfigMap patterns.

Guide for discovering and integrating with Rubin Science Platform (RSP) APIs using OpenAPI specifications. Use this skill when working with Gafaelfawr authentication APIs (/auth/*), Times Square notebook APIs (/times-square/api/*), or other RSP services. Covers finding OpenAPI specs, using WebFetch to download specifications, creating TypeScript types from schemas, implementing SWR-based hooks, handling authentication patterns (CSRF tokens, credentials), and creating mock APIs for development.

Check WCAG color contrast ratios between two colors. Accepts any CSS color format (hex, rgb, rgba, hsl, hsla, named colors) and returns the contrast ratio along with WCAG compliance levels (AA/AAA for normal and large text).

SWR-based data fetching and caching patterns used throughout the monorepo. Use this skill when implementing API interactions, creating custom data hooks, handling loading/error states, or working with mock data. Covers SWR configuration, custom hook patterns (useUserInfo, useTimesSquarePage), error handling, and mock data setup.

Complete testing infrastructure and patterns for the monorepo. Use this skill when writing tests, setting up test configuration, troubleshooting test failures, or working with the CI pipeline. Covers vitest configuration, Storybook addon-vitest integration, React Testing Library patterns, mock data setup, and the test-suite-runner agent for comprehensive testing.

Times Square notebook execution system integration patterns. Use this skill when working with Times Square pages, implementing SSE updates, handling URL parameters, setting up GitHub PR previews, or working with the Times Square API. Covers context providers, data fetching hooks, mock API endpoints, and page routing patterns.

Expert guidance on Turborepo build orchestration and remote caching workflow. Use this skill when running build commands, troubleshooting caching issues, working with monorepo task execution, or investigating CI/CD pipeline problems. Covers the critical pattern of always using root-level pnpm scripts, understanding the turbo-wrapper.js authentication system, filter syntax for targeting packages, and remote cache configuration.