Skills
.Work. You
Rest

agh-contract-codegen-coship

Official

Co-ship API contracts with auto-generated web types.

Software Engineering#typescript#openapi#codegen#storybook#integration-testing#contract#msw
Authorcompozy
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Prevents breaking integration between backend wire contracts and the generated frontend types by ensuring contract changes ship together with the required OpenAPI and TypeScript regeneration outputs.

Core Features & Use Cases

  • Contract co-ship enforcement: Detects edits to backend contract and spec artifacts and requires the same-PR regeneration bundle.
  • Deterministic regeneration workflow: Regenerates openapi/agh.json and web/src/generated artifacts and then updates affected web consumers to use generated types instead of mirrored duplicates.
  • Verification gate: Runs codegen checks plus web and site typecheck/test/build steps and validates against the coship checklist before committing.

Quick Start

Run this skill when you change contract DTOs, OpenAPI specs, or JSON-RPC extension shapes to generate, update, and verify all required downstream artifacts in a single PR.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: agh-contract-codegen-coship
Download link: https://github.com/compozy/agh/archive/main.zip#agh-contract-codegen-coship

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.