Agent skill

api-integration-helper

Generate boilerplate code for REST API integrations with authentication, error handling, and retry logic

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/pilot-2-api-helper

SKILL.md

API Integration Helper

Kanitsal Cerceve (Evidential Frame Activation)

Kaynak dogrulama modu etkin.

Generate production-ready code for integrating with REST APIs.

Overview

This skill helps developers quickly set up REST API integrations by generating boilerplate code that handles authentication, HTTP requests, response parsing, error handling, and retries. Supports JavaScript and Python.

When to Use

Use this skill when you need to integrate with a third-party REST API and want to generate the initial setup code rather than writing it from scratch.

Instructions

Step 1: Gather API Requirements

Ask the user for API details: base URL, authentication method, and target language.

Step 2: Set Up Authentication

Generate authentication code based on the method (API key or OAuth).

For API key authentication:

javascript
// JavaScript
const headers = {
  'Authorization': `Bearer ${process.env.API_KEY}`
};
python
# Python
import os
headers = {
    'Authorization': f'Bearer {os.environ["API_KEY"]}'
}

Step 3: Create HTTP Request Function

Generate a function to make HTTP requests with error handling.

javascript
async function apiRequest(endpoint, options = {}) {
  const response = await fetch(`${BASE_URL}${endpoint}`, {
    headers: headers,
    ...options
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return await response.json();
}

Step 4: Add Retry Logic

Implement exponential backoff for failed requests.

javascript
async function withRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (i === maxRetries - 1) throw error;
      await sleep(Math.pow(2, i) * 1000);
    }
  }
}

Step 5: Handle Rate Limiting

Add rate limit detection and backoff.

javascript
if (response.status === 429) {
  const retryAfter = response.headers.get('Retry-After');
  await sleep(retryAfter * 1000);
}

Step 6: Generate Example Usage

Create example code showing how to use the generated functions.

javascript
// Example: Get user data
const userData = await withRetry(() => apiRequest('/users/123'));
console.log(userData);

Examples

Example 1: Generate code for GitHub API integration

  • Input: Base URL: https://api.github.com, Auth: API key, Language: JavaScript
  • Output: Complete JavaScript module with authentication and request functions

Example 2: Generate code for OpenAI API

  • Input: Base URL: https://api.openai.com/v1, Auth: API key, Language: Python
  • Output: Python module with retry logic and error handling

Promise: <promise>V0_SKILL_VERIX_COMPLIANT</promise>

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results