api-architect

API architect for designing and generating external service integration code. Use when building REST API clients, service integrations, or applying resilience patterns (circuit breaker, bulkhead, throttling, backoff). Generates fully implemented code across service/manager/resilience layers.

13 stars

Best use case

api-architect is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

API architect for designing and generating external service integration code. Use when building REST API clients, service integrations, or applying resilience patterns (circuit breaker, bulkhead, throttling, backoff). Generates fully implemented code across service/manager/resilience layers.

Teams using api-architect should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/api-architect/SKILL.md --create-dirs "https://raw.githubusercontent.com/tae0y/python-project-template/main/.claude/skills.nouse/api-architect/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/api-architect/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How api-architect Compares

Feature / Agentapi-architectStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

API architect for designing and generating external service integration code. Use when building REST API clients, service integrations, or applying resilience patterns (circuit breaker, bulkhead, throttling, backoff). Generates fully implemented code across service/manager/resilience layers.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# API Architect

Design and generate fully implemented API client code in a 3-layer architecture.

## Workflow

Collect the following before generating code. Once all mandatory items are confirmed, generate immediately.

### Mandatory
- **Language** (e.g. Python, Java, TypeScript)
- **API endpoint URL**
- **REST methods** (at least one: GET, GET all, POST, PUT, DELETE)

### Optional
- DTOs for request/response — if omitted, generate mock DTOs based on API name
- API name
- Resilience: circuit breaker, bulkhead, throttling, backoff
- Test cases

## 3-Layer Design

| Layer | Responsibility |
|-------|---------------|
| **Service** | Basic HTTP requests and responses |
| **Manager** | Abstraction over Service for ease of configuration and testing |
| **Resilience** | Applies requested resilience patterns, calls Manager |

## Code Generation Rules

- Fully implement all layers — no stubs, comments in lieu of code, or templates
- Use the most popular resilience framework for the requested language
- Generate mock DTOs from the API name if not provided
- Never say "implement other methods similarly" — write all methods in full

Related Skills

We are still matching the closest adjacent skills for this page. In the meantime, continue through the full directory.