Skip to content

LeoYeAI/agent-master-skills / skills/afrexai-api-architect

afrexai-api-architect

Verified

Design, build, test, document, and secure production-grade APIs. Covers the full lifecycle from schema design through deployment, monitoring, and versioning. Use when designing new APIs, reviewing existing ones, generating OpenAPI specs, building test suites, or debugging production issues.

FileKindSize
README.mdmarkdown2.8 KB
SKILL.mdskill md26.8 KB
_meta.jsonconfig286 B
# AfrexAI API Architect πŸ”Œ

The complete API development lifecycle skill β€” from design through deployment, monitoring, and versioning.

## What This Does

Turns your AI agent into a senior API engineer. Not just curl commands β€” a full methodology:

- **Design**: Resource modeling, naming conventions, status code decision trees
- **Spec**: OpenAPI 3.1 generation with quality scoring (0-20 checklist)
- **Build**: Validation layers, error codes, idempotency, rate limiting patterns
- **Test**: Test pyramid, per-endpoint checklists, contract testing, curl recipes
- **Secure**: 30+ point security audit, CORS config, auth patterns
- **Version**: Strategy decision matrix, deprecation playbook, migration templates
- **Monitor**: Metrics dashboard, structured logging, health checks
- **Review**: 100-point API quality rubric across 6 dimensions

## Install

```bash
clawhub install afrexai-api-architect
```

## Quick Start

Tell your agent:
- *"Design a REST API for an order management system"*
- *"Review this API for quality and security issues"*
- *"Generate an OpenAPI spec for my user service"*
- *"Write comprehensive tests for the POST /orders endpoint"*
- *"Security audit our payment API"*

## What Makes This Different

Most API skills give you curl examples. This gives you:
- A **design-first methodology** (spec before code)
- **Decision matrices** (pagination type, versioning strategy, status codes)
- **Scoring rubrics** (spec quality 0-20, API quality 0-100)
- **Production patterns** (idempotency, rate limiting, webhook design)
- **GraphQL guidance** with anti-pattern detection
- **Edge case handling** (timezones, concurrent updates, eventual consistency)

## ⚑ Level Up

Want industry-specific API patterns? Our context packs include API design guidance tailored to your vertical:

- **SaaS Context Pack** β€” Multi-tenant API design, subscription billing APIs
- **Fintech Context Pack** β€” Payment processing, PSD2 compliance, ledger APIs
- **Healthcare Context Pack** β€” FHIR/HL7 integration, HIPAA-compliant endpoints

**[$47 per pack β†’ AfrexAI Store](https://afrexai-cto.github.io/context-packs/)**

## πŸ”— More Free Skills by AfrexAI

- [afrexai-code-reviewer](https://clawhub.com/skills/afrexai-code-reviewer) β€” 60+ pattern code review with SPEAR framework
- [afrexai-data-analyst](https://clawhub.com/skills/afrexai-data-analyst) β€” DICE framework for data analysis
- [afrexai-business-automation](https://clawhub.com/skills/afrexai-business-automation) β€” 5-phase automation lifecycle
- [afrexai-seo-content-engine](https://clawhub.com/skills/afrexai-seo-content-engine) β€” Keyword research to published article
- [afrexai-customer-support](https://clawhub.com/skills/afrexai-customer-support) β€” HEARD framework + churn prevention

**[Browse all AfrexAI skills β†’](https://afrexai-cto.github.io/context-packs/)**
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall