API and Interface Design Skill

The API and Interface Design skill is designed to assist with stable API and interface design. It provides guidance on designing APIs, module boundaries, or any public interface. It is useful when creating REST or GraphQL endpoints, defining type contracts between modules, or establishing boundaries between frontend and backend. The skill emphasizes the importance of designing interfaces that are hard to misuse, with clear contracts and consistent error handling. It covers principles like Hyrum's Law, the One-Version Rule, and the importance of validating at boundaries. The skill also includes patterns for REST API design, pagination, filtering, and partial updates. It is suitable for engineers and developers involved in API design and development.