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

0•

API 开发

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

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.

主要功能

01Built-in validation workflows using Turbo for type-checking and linting

02Synchronization of MSW network handlers and shared test data factories

03Comprehensive impact analysis for identifying breaking API changes

040 GitHub stars

05Automated TypeScript type generation from OpenAPI specifications

06Structured updates for API clients using 'ky' and domain-specific data layers

使用场景

01Updating frontend types and clients immediately after a backend API schema change

02Propagating new endpoints across multiple monorepo applications and data layers

03Fixing broken test suites and network mocks caused by API modifications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oskar-dragon/claude-code canary-workflow

For use in Claude.ai and ChatGPT

Download Skill