Claude MarketplacesSubmit
yonatangross avatar

Api Design

yonatangross/orchestkit

Covers REST conventions, GraphQL schema design, versioning strategies, and RFC 9457 Problem Details error handling across 18 rules in 7 categories. You'll reach for this when deciding between URL path versioning and header versioning, implementing standardized error responses with `application/problem+json`, or setting up OpenAPI specs. The agent-facing errors section is especially solid, adding `retryable` and `error_category` fields that actually help AI clients handle failures intelligently. Also includes patterns for gRPC services, SSE/WebSocket streaming, and messaging platform integrations like WhatsApp and Telegram. The deprecation and sunset policy guidance (3 month notice, 6 month window) is more opinionated than most API skills, which is helpful when you need a concrete answer rather than endless options.

skills.sh installs
211
GitHub stars
301
last updated
Aug 21, 2026
View on GitHub

Install

$ npx -y skills add yonatangross/orchestkit --skill api-design --agent claude-code

Installs into .claude/skills of the current project.

Files

API Design

Comprehensive API design patterns covering REST/GraphQL framework design, versioning strategies, and RFC 9457 error handling. Each category has individual rule files in rules/ loaded on-demand.

Quick Reference

CategoryRulesImpactWhen to Use
API Framework3HIGHREST conventions, resource modeling, OpenAPI specifications
Versioning2HIGHURL path versioning, header versioning; deprecation windows are house policy in references/ork-delta.md
Error Handling1HIGHAgent-facing RFC 9457 extensions; base spec and FastAPI wiring are upstream
GraphQL2HIGHStrawberry code-first, DataLoader, permissions, subscriptions
gRPC2HIGHProtobuf services, streaming, interceptors, retry
Streaming2HIGHSSE endpoints, WebSocket bidirectional, async generators
Integrations2HIGHMessaging platforms (WhatsApp, Telegram), Payload CMS patterns
SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/yonatangross/orchestkit
Categories
Backend & APIs, Debugging, Design & UI/UX
First seen
Jun 3, 2026

More from yonatangross/orchestkit

All 61

Recommended

More Backend & APIs
1davepoon avatarauth-patternsdavepoon/buildwithclaudeThis skill should be used when the user asks about "authentication in Next.js", "NextAuth", "Auth.js", "middleware auth", "protected routes", "session managemen182skills.sh installs
2borghei avatardatabase-designerborghei/claude-skillsDatabase design with schema analysis, index optimization, and migration generation for PostgreSQL, MySQL, MongoDB, and DynamoDB. Use when designing schemas, opt170skills.sh installs
3davila7 avatarfastmcp-serverdavila7/claude-code-templatesComplete guide for building MCP servers with FastMCP 3.0 - tools, resources, authentication, providers, middleware, and deployment. Use when creating Python MCP154skills.sh installs
4webmaxru avatarenonic-api-referencewebmaxru/enonic-agent-skillsEnonic XP server-side JavaScript/TypeScript API reference for all /lib/xp/* libraries. Provides function signatures, parameters, return types, and usage example141skills.sh installs
5loops-so avatarapiloops-so/skillsUse this skill whenever the user wants to integrate Loops from application code, backend services, webhook handlers, or server-side automation. This includes th137skills.sh installs
6andrelandgraf avatarusing-drizzle-queriesandrelandgraf/fullstackrecipesWrite type-safe database queries with Drizzle ORM. Covers select, insert, update, delete, relational queries, and adding new tables.135skills.sh installs