Agent skill · software engineering · daffy0208

api-integration-builder

Build reliable third-party API integrations including OAuth, webhooks, rate limiting, error handling, and data sync. Use when integrating with external services (Slack, Stripe, Gmail, etc.), building API connections, handling webhooks, or implementing OAuth flows.

Why this skill is useful

Provides specific patterns and code snippets for handling OAuth, webhooks, and error management that the AI wouldn't reliably generate on its own.

What it needs

Requires slack account access. About 8k tokens when loaded. Last updated 2025-12-25. 33 stars on the source repository.

What this skill does

API Integration Builder Build reliable, maintainable integrations with third-party APIs. Core Principles 1. Assume failure: APIs will go down, rate limits will hit, data will be inconsistent 2. Idempotency matters: Retries shouldn't cause duplicate actions 3. User experience first: Never show users "API Error 429" 4. Security always: Tokens are secrets, validate all data, assume malicious input Integration Architecture Basic Integration Flow Components 1. Authentication Layer: Handle OAuth, refresh tokens, API keys 2. Request Manager: Make API calls with retries, rate limiting 3. Webhook Handler: Receive real-time updates from third parties 4. Data Sync: Keep your data in sync with external service 5. Error Recovery: Handle failures gracefully Authentication Patterns API Key Authentication Simple but limited: Pros: Simple, no complex flows Cons: Can't act on behalf of users, no granular permissions OAuth 2.0 Flow The standard for user-authorized access: Token Refresh: Request Management Rate Limiting Client-side rate limiting: 429 Response handling: Error Handling Comprehensive error handling: Exponential backoff: Webhook Handling Receiving Webhooks Webhook Security Data Synchronization Sync Strategy Sync Scheduler Common Integration Patterns Slack Integration Stripe Integration Gmail/Google Calendar Integration Testing Integrations Mock External APIs Webhook Testing Monitoring & Observability Integration Health Checks Logging & Alerts `typescript // Log all API requests async function logAPIRequest( service: string, endpoint: string, statusCode: number, duration: number, error?: Error ) { await db.apiLogs.create({ service, endpoint, statuscode: statusCode, durationms: duration,

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills daffy0208/api-integration-builder

View the source on GitHub

Browse the @skills marketplace