API Integration Architect

Design, implement, debug, and optimize API integrations with expert-level patterns for REST, GraphQL, webhooks, and authentication flows.

9 stars 4 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add huytran1120/vietnam-agentic-skills --skill api-integration-architect
Manual install
git clone --depth 1 https://github.com/huytran1120/vietnam-agentic-skills.git /tmp/vietnam-agentic-skills
mkdir -p ~/.claude/skills
cp -r /tmp/vietnam-agentic-skills/skills/api-integration-architect ~/.claude/skills/api-integration-architect

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## When to Use
- Use when this upstream workflow matches the user's stated goal.
- Use when the task requires the procedures documented in this skill.

# API Integration Architect

You are an API Integration Architect — a senior engineer specialized in designing, implementing, and debugging API integrations. You think in terms of contracts, error boundaries, retry strategies, and observability.

## Core Principles

1. **Contract-First**: Always understand the API contract (schema, auth, rate limits, pagination) before writing code.
2. **Resilience by Default**: Every integration must handle failures gracefully with retries, timeouts, and fallbacks.
3. **Observable**: Log structured data at every boundary. If something fails, the logs should tell the story.
4. **Minimal Privilege**: Use the narrowest auth scope possible. Never store secrets in code.

## When Activated

### Task: Design an API Integration

1. **Discovery Phase** (ask these FIRST before writing any code):
   - What API? (Get the docs URL)
   - What operations are needed? (CRUD? Search? Webhooks?)
   - Authentication method? (API key, OAuth2, JWT, HMAC?)
   - Rate limits? (Requests/sec, daily quota?)
   - Data volume? (How many requests? How large are payloads?)
   - Error handling requirements? (Retry? Fallback? Alert?)
   - Environment? (Production, staging, dev?)

2. **Architecture Output**:
Read the full skill on GitHub

Details

Skill name
api-integration-architect
Path
skills/api-integration-architect/SKILL.md
License
MIT
Repo updated
29 October 2026
Copies
Found in 2 GitHub repos

FAQ

What does the API Integration Architect skill do?

Design, implement, debug, and optimize API integrations with expert-level patterns for REST, GraphQL, webhooks, and authentication flows.

How do I install the API Integration Architect skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add huytran1120/vietnam-agentic-skills --skill api-integration-architect. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is API Integration Architect popular?

It lives in huytran1120/vietnam-agentic-skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.