test-connector

Automate end-to-end local testing of Fivetran Connector SDK connectors.

70|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/fivetran/connector_sdk_tools --skill test-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-connector
Source: https://github.com/fivetran/connector_sdk_tools/tree/main/claude-code/skills/test-connector
Command: npx skills add https://github.com/fivetran/connector_sdk_tools --skill test-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually testing Fivetran Connector SDK connectors locally is tedious and error-prone, requiring manual virtual environment setup, secure credential handling, debug command execution, and manual verification of synced data in the local warehouse.

Core Features & Use Cases

  • Automated Environment Setup: Automatically creates a Python virtual environment and installs required dependencies for the connector project.
  • Secure Credential Workflow: Enforces encrypted configuration handling to never expose plaintext credentials during testing.
  • End-to-End Test Validation: Runs fivetran debug, resets local state for clean initial syncs when needed, and verifies synced table data in the local DuckDB warehouse.
  • Use Case: A developer building a Stripe connector for the Fivetran Connector SDK can use this skill to run a full local test in seconds, confirm tables sync correctly, and catch configuration or code errors before pushing to production.

Quick Start

Use the test-connector skill to run a full local validation test for your Fivetran connector project.

Frequently Asked Questions about test-connector

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

FAQPage Schema
How do I test a Fivetran connector locally without manual environment setup?

You can validate a Fivetran connector locally by automating environment setup, running the debug command, and verifying synced data in a local DuckDB warehouse. This eliminates manual virtual environment configuration and verification errors.

Can I run regression tests on a Fivetran Connector SDK project after code changes?

Yes, you can run regression tests after code fixes by executing an end-to-end local validation. This process resets local state for clean initial syncs and validates schema or primary key changes automatically.

How are API credentials handled during local connector testing?

Credentials are handled securely using encrypted configuration workflows during local connector testing. This enforces secure encrypted credential handling to ensure plaintext credentials are never exposed throughout the validation process.

Does the Fivetran Connector SDK support automated validation in a local DuckDB warehouse?

Yes, local validation supports DuckDB warehouse result verification. It runs the fivetran debug command, syncs tables, and structures errors into infrastructure, configuration, and code failures for troubleshooting.

What is the best way to catch configuration or code errors before pushing a Fivetran connector to production?

The best way to catch errors is running an end-to-end local test that classifies failures by infrastructure, configuration, or code. This structured error classification identifies issues before production deployment.

Why does my Fivetran connector schema validation fail during a local initial sync?

Schema validation may fail due to configuration or code errors classified during the local sync. Running a test that resets local state ensures a clean initial sync to accurately identify and troubleshoot the failure.