external-api-integration

What problem does it solve?

This Skill solves the common issue of AI agents generating unsafe, unreliable external API integration code for Rails applications, which leads to outages from missing timeouts, duplicate records from unhandled retries, credential leaks from unsanitized logging, and blocked user requests from synchronous external calls.

Core Features & Use Cases

• Faraday client setup: Pre-configured HTTP client with open/read timeouts, retries for idempotent requests, and sanitized request/response logging to avoid credential leaks.
• Circuit breaker protection: Stoplight-based circuit breaking for flaky upstream APIs to prevent retry storms from compounding outages.
• Service object wrapper: Encapsulates all external API logic in reusable service objects to keep controllers and models clean.
• Async job offloading: Moves external calls to background jobs to avoid blocking user-facing requests.
• Test safety: VCR cassette configuration to record and replay API responses, eliminating real API calls in test suites.
• Idempotency support: Guidance for adding idempotency keys to POST requests to prevent duplicate records on automatic retries. For example, use this Skill to integrate a CRM like HubSpot or payment processor like Stripe, ensuring all calls are retried safely, logged without exposing credentials, and never block user interactions.

Quick Start

Use the external-api-integration skill to build a production-ready HubSpot client with retries, circuit breaking, and background job offloading for your Rails app.