skills.rest
daltoniam
daltoniamCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

add-integration

Scaffold Switchboard integration adapters and guide SDK versus raw HTTP decisions.

15|7|Updated Feb 26, 2026
Search Tags:#testing#api#scaffolding#go#switchboard#add-integration#integration-adapter
One-click install
npx skills add https://github.com/daltoniam/switchboard --skill add-integration-daltoniam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-integration
Source: https://github.com/daltoniam/switchboard/tree/main/.agents/skills/add-integration
Command: npx skills add https://github.com/daltoniam/switchboard --skill add-integration-daltoniam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use when adding a new external API integration to Switchboard, scaffolding an integration adapter, or deciding between SDK vs raw HTTP for a new service. Not for modifying existing integrations or fixing bugs in current adapters.

Core Features & Use Cases

  • Guides the end-to-end lifecycle for adding a new integration adapter: research, design decisions (SDK vs Raw HTTP), implementation scaffolding, testing, and wiring.
  • Provides a repeatable, convention-driven workflow aligned with AGENTS.md to ensure adapters follow project standards.
  • Helps teams decide between Go SDKs and raw HTTP calls, and to scaffold the necessary file structure and configuration.

Quick Start

Provide the API target and scaffold the adapter using the recommended integration strategy.

Frequently Asked Questions about add-integration

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

FAQPage Schema
How do I add a new integration adapter to Switchboard?▼

To add a new integration adapter to Switchboard, you scaffold the adapter using a seven-step lifecycle that covers research, design decisions, implementation, testing, and wiring. This enforces documented conventions and validation to ensure consistent adapters.

When should I use a Go SDK versus raw HTTP for an API integration?▼

You should use a Go SDK versus raw HTTP for an API integration based on guided design decisions within the scaffolding workflow. This Skill helps teams evaluate the tradeoffs and select the recommended integration strategy for the new service.

What is the workflow for scaffolding an external API integration in Go?▼

The workflow for scaffolding an external API integration in Go involves a repeatable, convention-driven process aligned with AGENTS.md. It guides you through research, design, implementation, testing, and wiring to ensure adapters follow project standards.

Can I use this scaffolding process to modify existing integrations or fix bugs?▼

No, you cannot use this scaffolding process to modify existing integrations or fix bugs. It is designed exclusively for adding new external API integrations and scaffolding new integration adapters in Switchboard.

What testing practices are enforced when adding a Switchboard integration?▼

When adding a Switchboard integration, testing practices are enforced through a seven-step lifecycle that includes documented conventions and validation. This ensures consistent adapter quality and adherence to project standards throughout the implementation.

Related Skills

Explore More Software Engineering Skills→
daltoniamdaltoniam
15

pr-review

Review GitHub pull requests for the Switchboard Go MCP server.

Community
Advanced
89jobrien89jobrien
1

doob-new-provider

Implement and wire a new IssueTracker sync provider adapter for doob.

Community
Advanced
matteobortolazzomatteobortolazzo
1

stack-go

Standardize Go backend project layouts, testing patterns, and dependency management.

Community
Intermediate
aeonbridgeaeonbridge

mcp

Build MCP servers and clients with Python or TypeScript SDKs.

Official
Intermediate