add-cdc-adapter

Create a CDC destination adapter scaffold for the Mako sync-cdc pipeline.

11|6|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/mako-ai/mako --skill add-cdc-adapter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-cdc-adapter
Source: https://github.com/mako-ai/mako/tree/main/.cursor/skills/add-cdc-adapter
Command: npx skills add https://github.com/mako-ai/mako --skill add-cdc-adapter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold a new CDC destination adapter to extend Mako's sync-cdc pipeline, enabling teams to add support for additional databases as CDC targets without starting from scratch.

Core Features & Use Cases

  • Provides the CdcDestinationAdapter interface scaffold (ensureLiveTable, applyEvents, applyBatch) and example implementation guidance.
  • Documents how to register the adapter in the registry and how the frontend may surface it for configuration.
  • Useful when extending CDC support to a new database (e.g., ClickHouse, MySQL, Snowflake) to materialize CDC events and backfill data.

Quick Start

Generate a new adapter scaffold following the provided steps and register it in the adapter registry.

Frequently Asked Questions about add-cdc-adapter

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

FAQPage Schema
How do I scaffold a CDC adapter for a new database target in TypeScript?

To scaffold a CDC adapter for a new database target, generate the CdcDestinationAdapter interface structure and register it in the adapter registry to extend the sync pipeline. This provides the required ensureLiveTable, applyEvents, and applyBatch methods.

What methods are required when implementing a CDC destination adapter?

Implementing a CDC destination adapter requires the ensureLiveTable, applyEvents, and applyBatch methods. The scaffold guides you to implement these with idempotent behavior and proper error handling to correctly materialize CDC events.

How do I register a new database adapter in the resolver registry?

Register a new database adapter by adding it to the adapter registry after generating the scaffold. This ensures the resolver can route CDC events to the new destination and allows frontend configuration for the target database.

When do I need to create a custom CDC adapter for my database?

You need a custom CDC adapter when extending CDC support to a new database like ClickHouse, MySQL, or Snowflake. It allows the sync pipeline to materialize CDC events and backfill data without starting from scratch.

Does the CDC adapter scaffold support idempotent event processing?

Yes, the CDC adapter scaffold requires idempotent behavior for event processing. You must implement applyEvents and applyBatch with idempotency and proper error handling to ensure reliable data synchronization.

Can I use this scaffold to add CDC support for ClickHouse or Snowflake?

Yes, you can use this scaffold to add CDC support for databases like ClickHouse, MySQL, or Snowflake. It generates the destination adapter structure needed to materialize CDC events and backfill data for these targets.