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.