skills.rest
jujunjun110
jujunjun110COMMUNITY
Explore all skills by this author →
GitHub

add-api-integration

Generates gateway interfaces and production/stub adapters for TypeScript API integrations.

17|2|Updated Mar 19, 2026
Search Tags:#architecture#api#integration#infrastructure#gateway#stub
One-click install
npx skills add https://github.com/jujunjun110/product-starter --skill add-api-integration
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-api-integration
Source: https://github.com/jujunjun110/product-starter/tree/main/.claude/skills/add-api-integration
Command: npx skills add https://github.com/jujunjun110/product-starter --skill add-api-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the process of adding external API integrations by generating a gateway interface, a production adapter, and a stub adapter, reducing boilerplate and setup time.

Core Features & Use Cases

  • Gateway interface in the domain layer to standardize interactions with external services.
  • Production adapter in the infrastructure layer to handle API calls, retries, and timeouts.
  • Stub adapter for safe testing and local development with configurable responses.
  • Composition logic to switch between real and stub implementations via environment variables.
  • Use Case: Quickly scaffold a new payment provider integration by generating necessary components and wiring them together.

Quick Start

Create a new integration by instructing the AI to scaffold the gateway and adapters for the chosen API.

Frequently Asked Questions about add-api-integration

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

FAQPage Schema
How do I scaffold an external API integration in TypeScript?▼

To scaffold external API integration, this tool automatically generates a gateway interface, production adapter, and stub adapter for TypeScript projects, enforcing domain-driven architecture by separating interfaces and adapters across layers.

What is the best way to separate API gateway interfaces from adapters?▼

Separating API gateway interfaces from adapters requires placing interfaces in the domain layer and adapters in the infrastructure layer, using a composition layer to switch between production and stub implementations via environment variables.

Can I use a stub adapter for local development and testing?▼

Yes, you can use a stub adapter for local development and testing. It provides configurable safe responses and toggles with the production adapter through environment variables, allowing isolated development without real external API calls.

Does this API integration scaffolding work with existing TypeScript projects?▼

API integration scaffolding works with both new and existing TypeScript projects. It targets clean domain-driven architectures, generating the necessary gateway components and wiring them together without requiring a fresh project setup.

How do I toggle between real and stub API implementations?▼

You toggle between real and stub API implementations by configuring environment variables. The generated composition layer reads these variables to switch between the production adapter, which handles real API calls, and the stub adapter.

Related Skills

Explore More Software Engineering Skills→
ralvarezdevralvarezdev
3

hexagonal-arch

Defines domain-owned ports and implements adapters to enforce inward dependency flow in hexagonal architecture.

Community
Advanced
jacexhjacexh

python-resilience

Implement automated retry and timeout logic for external Python calls.

Community
Advanced
kriegcloudkriegcloud
68

effect-ai-tool

Define and implement type-safe AI tools using @effect/ai Tool and Toolkit APIs.

Community
Advanced
j5ik2oj5ik2o
81

clean-architecture

Enforces four-layer clean architecture with defined repository and gateway placements.

Community
Advanced