# api-integration-specialist

A Claude skill that walks the agent through third-party API work: auth, retries, rate limits and webhooks.

- skill · `type=skill` · Claude Code · 2978 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/api-integration-specialist
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/api-integration-specialist

## What it does

The skill gives the agent patterns for talking to someone else's API: keep keys in environment variables instead of code, run OAuth 2.0 through the authorization code flow, map the service response onto your own model. Everything is shown in JavaScript — an `APIClient` class, a `fetch` wrapper, response transformation.

Failure handling gets its own section. There is an `APIError` class carrying status and body, a retry helper with exponential backoff, and a client-side rate limiter. Only server errors get retried; client errors are thrown straight away. Webhook signatures are verified with HMAC.

Reach for it when you wire up Stripe, Twilio or SendGrid and would rather not re-derive timeouts and rate-limit handling from scratch. One caveat: the samples are JavaScript, so on another stack the agent has to port the logic itself.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/api-integration-specialist
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill api-integration-specialist -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/api-integration-specialist/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/api-integration-specialist/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/api-integration-specialist/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/api-integration-specialist/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates api-integration-specialist
```

2. **Manually: put the files in place**
- File: `.github/skills/api-integration-specialist/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/api-integration-specialist
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/api-integration-specialist/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/api-integration-specialist

## When to use it
- build an API client with one error path
- set up OAuth 2.0 and exchange the code for tokens
- retry failed requests with growing delays
- cap how often you hit an external service
- verify an incoming webhook signature

## Example prompts
- wire Stripe into this project, read the keys from env vars
- build a client for this API with retries and 429 handling
- set up the webhook and verify the signature with HMAC

## Similar
- [bfl-api](https://affpapa.org/en/nevibecode/skills/bfl-api.md) — skill · 1000 installs
- [api-integration-surface-strategy](https://affpapa.org/en/nevibecode/skills/api-integration-surface-strategy.md) — skill · 8000 installs
- [api-rate-limiting](https://affpapa.org/en/nevibecode/skills/secondsky-api-rate-limiting.md) — skill · 491 installs
- [mcp-integration](https://affpapa.org/en/nevibecode/skills/mcp-integration.md) — skill · 6994 installs
- [webhook-integration](https://affpapa.org/en/nevibecode/skills/webhook-integration.md) — skill · 1100 installs
- [build-zoom-phone-integration](https://affpapa.org/en/nevibecode/skills/anthropics-build-zoom-phone-integration.md) — skill · 2100 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 205 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
