connector-dev

What problem does it solve?

Many teams struggle to design, implement, and maintain robust external API connectors without a clear structure, proper configuration handling, and thorough research, leading to duplicated effort and fragile integrations.

Core Features & Use Cases

• Research‑first workflow: Guarantees that OpenAPI specs, local documentation, and external resources are reviewed before any code is written.
• Full vs Lite connector patterns: Provides two scalable directory layouts—connector/full for complex APIs with multiple endpoints, authentication, pagination, and rate limiting; connector/lite for simple APIs with few endpoints.
• 4‑Tier architecture: Separates settings, plumbing, translation, and business logic into config.py, client.py, service modules, and an optional gateway.py.
• Scaffolding checklist: Step‑by‑step file creation order, registration steps, and verification checklist to ensure a production‑ready connector.
• Anti‑patterns guide: Highlights common mistakes such as hard‑coding credentials, mixing auth logic into services, and neglecting documentation.

Quick Start

Use the connector‑dev skill to design a new API integration by following the research‑first workflow and selecting the appropriate connector structure.