codegen-sync

Synchronize TypeScript SDK types with updated Elixir protocol definitions.

56|2|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/matteing/opal --skill codegen-sync
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: codegen-sync
Source: https://github.com/matteing/opal/tree/main/.claude/skills/codegen-sync
Command: npx skills add https://github.com/matteing/opal --skill codegen-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verifies TypeScript codegen stays in sync with Elixir protocol definitions. Use this skill after modifying Elixir structs, protocol messages, or RPC types to regenerate and verify the TypeScript client SDK types.

Core Features & Use Cases

  • Regenerate TypeScript SDK types when Elixir types change.
  • Validate generated outputs against Git diffs to ensure consistency.
  • CI-ready: run checks to prevent drift and keep client and server in sync.

Quick Start

Run the code generation script to regenerate the TypeScript SDK after Elixir changes.

Frequently Asked Questions about codegen-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep TypeScript SDK types in sync with Elixir definitions?β–Ό

To keep TypeScript SDK types in sync with Elixir definitions, run the codegen toolchain to regenerate client types and verify them against Git diffs to prevent drift. This ensures server-side changes are reflected accurately in the client.

Why does my TypeScript client SDK have type drift after updating Elixir structs?β–Ό

TypeScript client SDK type drift occurs when Elixir structs or RPC definitions change without regenerating outputs. Run the synchronization validation checks to detect mismatches and regenerate the expected TypeScript types.

How to validate generated TypeScript types against Elixir protocol definitions?β–Ό

Validate generated TypeScript types by running the codegen validation checks to compare outputs against Git diffs. This process detects inconsistencies between the TS client SDK and the Elixir protocol definitions.

Can I use codegen synchronization checks in CI to prevent SDK drift?β–Ό

Yes, you can run codegen synchronization checks in CI-ready pipelines to prevent SDK drift. The validation process verifies that generated TypeScript outputs match the expected results from Elixir protocol definitions.

When should I regenerate TypeScript types from Elixir RPC definitions?β–Ό

Regenerate TypeScript types from Elixir RPC definitions immediately after modifying structs, protocol messages, or RPC types in the Elixir backend to ensure the TypeScript client SDK remains perfectly synchronized.

What is the best way to automate TypeScript SDK generation from Elixir?β–Ό

The best way to automate TypeScript SDK generation is using a codegen toolchain workflow that regenerates types and validates outputs against Git diffs, ensuring continuous synchronization between Elixir and TypeScript.