How do I trigger this skill in Claude Code?

You can use natural language commands like 'update canary types', 'sync schema', 'update API types', or 'fix canary-client' to activate the workflow.

Can it handle breaking API changes?

Yes, the skill includes a dedicated analysis step to identify modified or removed types and provides patterns for searching and updating all affected references.

What does the Canary Schema Update Workflow do?

It automates the process of updating TypeScript types from an OpenAPI spec and ensures those changes are correctly applied to your API client, data layers, and test environments.

Does it support monorepo structures?

Yes, it is specifically configured for monorepos, providing clear paths for shared packages like 'canary-types' and app-specific layers like 'buyers' or 'sellers'.

Does this skill help with unit and integration testing?

Absolutely. It guides the update of MSW network handlers and test factories to ensure that your mock data always matches the latest API response shapes.

Canary Schema & API Workflow

Name: Canary Schema & API Workflow
Author: oskar-dragon

byoskar-dragon

API Development

Synchronizes OpenAPI schema changes across TypeScript monorepos by automating type generation, client updates, and data layer propagation.

About

The Canary Schema Update Workflow is a specialized skill designed to manage the complex process of propagating backend API changes through a frontend monorepo. It guides Claude through a structured six-step process: generating TypeScript types from OpenAPI specs, analyzing diffs, updating central API clients, adjusting data fetching layers (such as React Server Components or React Query), and synchronizing network mocks and test factories. This ensures end-to-end type safety and consistency, preventing regressions in production code and test suites when schemas evolve.

Key Features

Built-in validation workflows using Turbo for type-checking and linting
Synchronization of MSW network handlers and shared test data factories
Comprehensive impact analysis for identifying breaking API changes
0 GitHub stars
Automated TypeScript type generation from OpenAPI specifications
Structured updates for API clients using 'ky' and domain-specific data layers

Use Cases

Updating frontend types and clients immediately after a backend API schema change
Propagating new endpoints across multiple monorepo applications and data layers
Fixing broken test suites and network mocks caused by API modifications

About

Key Features

Built-in validation workflows using Turbo for type-checking and linting
Synchronization of MSW network handlers and shared test data factories
Comprehensive impact analysis for identifying breaking API changes
0 GitHub stars
Automated TypeScript type generation from OpenAPI specifications
Structured updates for API clients using 'ky' and domain-specific data layers

Use Cases

Updating frontend types and clients immediately after a backend API schema change
Propagating new endpoints across multiple monorepo applications and data layers
Fixing broken test suites and network mocks caused by API modifications