JPeetz/agent-skills / skills/api-backend/api-and-interface-design
api-and-interface-design
VerifiedUse this skill when designing APIs, module boundaries, or any public interface. Create stable, well-documented interfaces that are hard to misuse — REST endpoints, GraphQL schemas, module contracts, component props. Covers contract-first design, error semantics, validation boundaries, idempotency, and consistent naming.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 485 B |
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 9.6 KB |
| evals/evals.json | config | 2.2 KB |
CHANGELOG.md
View on GitHub# Changelog
## 1.0.0 (2026-10-19)
- Initial release
- Adapted from addyosmani/agent-skills (MIT)
- Core principles: Hyrum's Law, One-Version Rule, Contract First
- Design patterns: error semantics, validation boundaries, idempotency
- REST API patterns: resource design, pagination, naming conventions
- Consistency rules for error formats, validation placement, and naming
- Anti-rationalizations covering versioning, Hyrum's Law, and internal APIs
- 12-point verification checklistRelated skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |