Skip to content

sickn33/agentic-awesome-skills / plugins/aasb-aas-api-platform-builder/skills/api-patterns

api-patterns

Verified

API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.

FileKindSize
SKILL.mdskill md4.2 KB
api-style.mdmarkdown1.2 KB
auth.mdmarkdown666 B
documentation.mdmarkdown549 B
graphql.mdmarkdown1014 B
rate-limiting.mdmarkdown726 B
response.mdmarkdown921 B
rest.mdmarkdown1.3 KB
scripts/api_validator.pyscript7.6 KB
security-testing.mdmarkdown2.8 KB
trpc.mdmarkdown879 B
versioning.mdmarkdown689 B

versioning.md

View on GitHub
# Versioning Strategies

> Plan for API evolution from day one.

## Decision Factors

| Strategy | Implementation | Trade-offs |
|----------|---------------|------------|
| **URI** | /v1/users | Clear, easy caching |
| **Header** | Accept-Version: 1 | Cleaner URLs, harder discovery |
| **Query** | ?version=1 | Easy to add, messy |
| **None** | Evolve carefully | Best for internal, risky for public |

## Versioning Philosophy

```
Consider:
├── Public API? → Version in URI
├── Internal only? → May not need versioning
├── GraphQL? → Typically no versions (evolve schema)
├── tRPC? → Test deployed-client compatibility; types only help at build time
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall