Run any Skill in Manus with one click

alpha-coreapi-design

Stars14

Forks3

UpdatedMarch 3, 2026 at 12:24

Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, API gateways, GraphQL Federation, BFF pattern, contract testing, API mocking, versioning, rate limiting, webhooks, and HATEOAS maturity model. Use when designing new APIs, reviewing API architecture, or choosing between API styles.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

rnavarych

rnavarych/alpha-engineer

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

6 files

SKILL.md

readonly

name	alpha-core:api-design
description	Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, API gateways, GraphQL Federation, BFF pattern, contract testing, API mocking, versioning, rate limiting, webhooks, and HATEOAS maturity model. Use when designing new APIs, reviewing API architecture, or choosing between API styles.
allowed-tools	Read, Grep, Glob, Bash

You are an API design specialist. Design APIs that are intuitive, consistent, evolvable, and secure.

API Style Selection

Style	Best For	Avoid When
REST	CRUD, public APIs, web apps, hypermedia	Real-time, complex queries
GraphQL	Complex data relationships, mobile, BFF	Simple CRUD, file uploads
gRPC	Internal microservices, high performance, streaming	Browser clients (without gRPC-Web)
tRPC	TypeScript full-stack monorepos, type safety end-to-end	Non-TypeScript backends, public APIs
WebSocket	Real-time bidirectional, chat, live presence, gaming	Request-response patterns
SSE	Server-push, live feeds, AI streaming responses	Bidirectional communication
AsyncAPI	Event-driven architectures, Kafka/NATS/MQTT integration	Synchronous request-response

Core Principles

Design for evolvability: version from day one, deprecate with sunset headers
Consistency over cleverness: boring and predictable beats clever and surprising
Contract first: spec → mock → implement → contract test
Security by default: auth on everything, rate limit everything, validate all input

Reference Files

references/rest-design.md — URL structure, HTTP methods, status codes, error format (RFC 9457), pagination patterns, versioning, rate limiting
references/graphql-trpc.md — GraphQL schema design, DataLoader, Federation, subscriptions with Redis, tRPC router composition and OpenAPI export
references/async-streaming.md — SSE, long polling, AsyncAPI, CloudEvents, webhook delivery with payload signing and retry strategy
references/gateway-specs.md — API gateway comparison (Kong/Apigee/KrakenD etc.), OpenAPI 3.1, JSON:API, HAL, HATEOAS, BFF pattern
references/contracts-security.md — Pact contract testing, API mocking tools, API-first workflow, OAuth scopes, idempotency, conditional requests, bulk operations, HTTP/3

More from this repository

same repository

alpha-core-ai-ml-engineering

rnavarych/alpha-engineer

Guides on AI/ML system design, LLM application architecture, MLOps pipelines, AI SaaS platform selection (OpenAI, Anthropic, Google Vertex AI, AWS Bedrock, Azure OpenAI, Hugging Face, Cohere, Replicate, Together AI), model serving, feature stores, experiment tracking, evaluation frameworks, RAG architecture, AI agent patterns, responsible AI, cost optimization, and emerging AI/ML trends. Use when designing AI systems, selecting AI providers, building LLM applications, setting up MLOps, or evaluating AI architecture patterns.

2026-07-2414

ai-llm-patterns

rnavarych/alpha-engineer

AI/LLM integration patterns: Anthropic SDK streaming with TypeScript, RAG architecture (chunking, embedding, vector search with pgvector), tool use / function calling, model selection guide (Haiku 4.5 vs Sonnet 5 vs Opus 4.8), prompt caching, structured output with Zod, token cost management. Use when building AI features, RAG pipelines, AI agents.

2026-07-2414

mobile-flutter

rnavarych/alpha-engineer

Flutter 3.27+ patterns — Riverpod 2 state with codegen, GoRouter 14+ navigation, Impeller rendering (default on all platforms), WASM web, extension types, on-device AI (firebase_ai, MediaPipe), Patrol 3.x testing, platform channels, performance

2026-03-0514

role-mobileflutter-expert

rnavarych/alpha-engineer

Expert guidance on Flutter 3.27+ (Impeller default on all platforms, Material 3, WASM web, DevTools, Flame), Dart 3.3+ (records, patterns, sealed classes, extension types, macros), state management (Riverpod 2 with codegen, BLoC/Cubit 9.x, Signals), navigation (GoRouter 14+, auto_route), networking (Dio, retrofit, Ferry/Artemis GraphQL), local storage (Drift, ObjectBox, Isar, Hive CE, Realm), testing (widget_test, golden tests, Patrol 3.x, alchemist, mocktail, bloc_test), on-device AI (firebase_ai, google_generative_ai, MediaPipe Tasks), Flutter for Web (WASM default)/Desktop/Embedded, Mason, very_good_cli, flutter_gen, custom_lint, Flutter Hooks, freezed. Use when building or optimizing Flutter apps.

2026-03-0514

alpha-coreci-cd-patterns

rnavarych/alpha-engineer

Designs CI/CD pipelines with build, test, and deploy stages, blue-green/canary/rolling deployments, feature flags, artifact management, and environment promotion strategies. Use when setting up or improving CI/CD pipelines or deployment workflows.

2026-03-0514

alpha-corearchitecture-patterns

rnavarych/alpha-engineer

Advises on software architecture: SOLID, DDD, CQRS, Event Sourcing, Clean/Hexagonal Architecture, microservices, Data Mesh, EDA, Service Mesh, micro-frontends, Cell-based architecture, Platform Engineering, Vertical Slice, Feature Sliced Design, Saga/Outbox. Use when making architectural decisions, evaluating design patterns, or refactoring systems.

2026-03-0314

name	alpha-core:api-design
description	Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, API gateways, GraphQL Federation, BFF pattern, contract testing, API mocking, versioning, rate limiting, webhooks, and HATEOAS maturity model. Use when designing new APIs, reviewing API architecture, or choosing between API styles.
allowed-tools	Read, Grep, Glob, Bash

You are an API design specialist. Design APIs that are intuitive, consistent, evolvable, and secure.

API Style Selection

Style	Best For	Avoid When
REST	CRUD, public APIs, web apps, hypermedia	Real-time, complex queries
GraphQL	Complex data relationships, mobile, BFF	Simple CRUD, file uploads
gRPC	Internal microservices, high performance, streaming	Browser clients (without gRPC-Web)
tRPC	TypeScript full-stack monorepos, type safety end-to-end	Non-TypeScript backends, public APIs
WebSocket	Real-time bidirectional, chat, live presence, gaming	Request-response patterns
SSE	Server-push, live feeds, AI streaming responses	Bidirectional communication
AsyncAPI	Event-driven architectures, Kafka/NATS/MQTT integration	Synchronous request-response

Core Principles

Design for evolvability: version from day one, deprecate with sunset headers
Consistency over cleverness: boring and predictable beats clever and surprising
Contract first: spec → mock → implement → contract test
Security by default: auth on everything, rate limit everything, validate all input

Reference Files

references/rest-design.md — URL structure, HTTP methods, status codes, error format (RFC 9457), pagination patterns, versioning, rate limiting
references/graphql-trpc.md — GraphQL schema design, DataLoader, Federation, subscriptions with Redis, tRPC router composition and OpenAPI export
references/async-streaming.md — SSE, long polling, AsyncAPI, CloudEvents, webhook delivery with payload signing and retry strategy
references/gateway-specs.md — API gateway comparison (Kong/Apigee/KrakenD etc.), OpenAPI 3.1, JSON:API, HAL, HATEOAS, BFF pattern
references/contracts-security.md — Pact contract testing, API mocking tools, API-first workflow, OAuth scopes, idempotency, conditional requests, bulk operations, HTTP/3