integration-change-builder

Design external integration changes with retries, timeouts, idempotency, and webhook security.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill integration-change-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: integration-change-builder
Source: https://github.com/machenjie/rd-skills/tree/main/src/professional-skills/integration-change-builder
Command: npx skills add https://github.com/machenjie/rd-skills --skill integration-change-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you design external integration changes that stay reliable under failures while staying secure against spoofed or replayed inbound events.

Core Features & Use Cases

  • Outbound resilience design: Enforces explicit timeouts, bounded exponential backoff with jitter, and circuit-breaker behavior to prevent cascading outages.
  • Idempotent operations: Requires idempotency keys for retried writes so network timeouts do not duplicate payments or state transitions.
  • Webhook security & correctness: Mandates HMAC signature verification over the raw request body plus replay protection via deduplication windows.
  • Credential lifecycle and reconciliation: Ensures secrets are managed safely with rotation considerations and that drift is detected through scheduled reconciliation.

Quick Start

Ask the agent to use the integration-change-builder to produce a complete integration design for your proposed third-party API or webhook change, including timeouts, retry/backoff, idempotency, webhook signature verification, replay protection, reconciliation, and test obligations.

Frequently Asked Questions about integration-change-builder

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

FAQPage Schema
How do I design idempotent API calls to prevent duplicate state transitions on retry?

Idempotency keys prevent duplicate state transitions by tagging retried writes so network timeouts do not duplicate payments or state changes. You must require idempotency keys for all retryable writes to ensure external integration reliability.

What is the best way to secure inbound webhooks against spoofing and replay attacks?

Webhook security against spoofing and replay attacks requires HMAC signature verification over the raw request payload combined with replay protection via deduplication windows. This validates inbound event authenticity and prevents malicious duplicate processing.

How do I prevent cascading outages when integrating third-party REST APIs?

Preventing cascading outages in third-party REST API integrations requires explicit outbound timeouts, bounded exponential backoff with jitter, and circuit-breaker behavior. These resilience patterns stop failure propagation across external provider dependencies.

How do I manage credentials and detect drift during provider migration?

Managing credentials and detecting drift during provider migration requires safe secrets management with rotation considerations plus scheduled reconciliation. This ensures configuration drift is detected early through consistent state validation across external systems.

Does this integration design approach work for gRPC and SOAP integrations?

This integration design approach works for third-party REST, SOAP, gRPC, and webhook scenarios. It applies resilience patterns, security verification, and operational failure handling uniformly across diverse external provider protocols and migration contexts.