add-connector

Scaffold a connector module with standardized structure, tests, and CDC/webhook support.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold and standardize a production-grade connector scaffold for Mako's sync system, reducing boilerplate and ensuring consistent structure for new data sources.

Core Features & Use Cases

  • Creates api/src/connectors/<name>/ with essential files (connector.ts, schema.ts, index.ts, icon.svg, and tests) and a registry-ready layout.
  • Provides a template for getConfigSchema(), supports resumable fetching, webhook handling, and CDC backfill patterns for production-grade data integrations.
  • Useful when adding new data sources, implementing new sync providers, or extending existing connectors with standardized quality checks.

Quick Start

Run the add-connector skill to generate a new api/src/connectors/<name>/ scaffold and implement the required methods.

Frequently Asked Questions about add-connector

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

FAQPage Schema
How do I scaffold a new data-source connector for Mako's sync system?

Scaffold a new data-source connector by generating a standardized module with essential files like connector.ts, schema.ts, and tests, enforcing required methods and resumable backfill for production-grade reliability.

What is the best way to add CDC and webhook support to a sync provider?

Add CDC and webhook support by using a connector template that enforces integration patterns, providing standardized structures for webhook handling and CDC backfill to ensure maintainable data integrations.

Does the connector scaffold include automated tests and schema validation?

Yes, the connector scaffold includes automated tests and schema validation by generating essential files like schema.ts and test modules alongside the main connector.ts to enforce standardized quality checks.

Can I extend existing connectors with standardized structure for new data sources?

Yes, you can extend existing connectors by applying a standardized structure that enforces required methods, resumable fetching, and registry-ready layout for reliable, maintainable data integrations.

Why do I need resumable fetching when implementing a new sync provider?

Resumable fetching is needed to ensure production-grade reliability by allowing data synchronization to resume from the last checkpoint, preventing data loss during interruptions in the sync system.

What limitations exist when scaffolding a connector module for Mako's sync system?

Limitations include strict adherence to enforced required methods and standardized structure, as the scaffold targets Mako's sync system specifically, requiring compliance with resumable backfill and CDC/webhook patterns.