api-automation-architect

Designs resilient API automation workflows with idempotency, retries, circuit breakers, and observability.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/Scardubu/SwarmXQ --skill api-automation-architect-scardubu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-automation-architect
Source: https://github.com/Scardubu/SwarmXQ/tree/main/.ai/skills/api-automation-architect
Command: npx skills add https://github.com/Scardubu/SwarmXQ --skill api-automation-architect-scardubu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building API integrations that survive real-world failures is hard: duplicate webhook deliveries, transient 503s, cascading downstream outages, and silent errors all break naive integrations. This Skill provides a structured protocol for designing and generating production-hardened API automation workflows where every call has a timeout, every write is idempotent, and every failure is typed and observable. ## Core Features & Use Cases - Resilience Pattern Taxonomy: Classifies workflows (single call, sequential chain, fan-out, event-driven, long-running, bidirectional sync) and applies the right patterns: idempotency keys, exponential backoff, circuit breakers, dead letter queues, sagas, and outbox. - TypeScript Implementation Generation: Produces code using ky/fetch, p-retry or cockatiel for retry and circuit breaking, BullMQ for queues, and OpenTelemetry spans for tracing. - Observability & Quality Gates: Enforces spans per external call, structured retry logs, latency metrics, and alert thresholds, with quality gates banning fire-and-forget calls and infinite retries. - Use Case: A user asks to build a Stripe webhook processor that handles duplicate deliveries. The Skill designs an idempotency-key flow backed by Redis, adds typed error classification, retry with backoff, and OpenTelemetry spans around every external call. ## Quick Start Ask the AI to design a resilient, idempotent workflow for chaining two API calls with retry logic, a circuit breaker, and observability spans.

Frequently Asked Questions about api-automation-architect

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

FAQPage Schema
How do I make an API call resilient with retry logic in TypeScript?

Wrap the call in a retry policy using p-retry or cockatiel with a max attempt ceiling, exponential backoff, and a timeout via abort signals. Classify errors so only transient failures like rate limits and 503s are retried.

How do I handle duplicate webhook deliveries idempotently?

Generate a deterministic idempotency key from the webhook inputs, check a Redis store before processing, and cache the result with a TTL. Duplicate deliveries then return the stored result instead of re-executing the operation.

What is the difference between p-retry and cockatiel for retries?

p-retry provides simple retry with backoff for individual operations, while cockatiel offers composable policies including retry, circuit breaker, timeout, and fallback in one library. Use cockatiel when you need circuit breakers alongside retries.

When should I use a circuit breaker for API integrations?

Use a circuit breaker when a downstream service is degraded and continued calls would cause cascading load. Configure a failure threshold percentage and recovery timeout so calls fail fast until the dependency recovers.

When should API workflows move into a BullMQ queue?

Move workflows into a BullMQ queue when they exceed roughly 500ms, involve long-running polling or job orchestration, or must guarantee no work is lost on failure via a dead letter queue. Synchronous request paths should stay short.