Heavybit Skill
API Design
Building APIs developers love. Covers versioning, backwards compatibility, documentation, extensibility, developer experience, and treating API design as a product problem. Drawn from practitioners at Stripe, GitHub, Postman, Auth0, ReadMe, and others.
Built from what these operators shared
API Design
Built from four library resources
What a skill is
A skill is a set of working instructions your agent loads when you need it, built from the strategies operators shared in the Heavybit Library. It guides the work and you still do it. Heavybit reads and approves every skill before it ships, and keeps updating skills as new content enters the Library. Skills are plain text, so you or your agent can read any skill in full before acting on it. Your agent decides how to apply a skill, so check its work; if a skill gets something wrong, ask your agent to report it or email platform@heavybit.com.
Connect your agent
- Add the endpoint below to your harness: Claude Code, Codex, Claude, Cursor, ChatGPT, or another that supports MCP.
- Sign in to your Heavybit account with Google or GitHub when your agent asks. It's free, and your first sign-in creates the account.
- Tell your agent what you're working on. It finds the right skill, or you can ask for one by name.
MCP endpointhttps://crucible.heavybit.com/mcp
Built from the Heavybit Library
The operators behind this skill shared what they know in these talks, podcasts, and articles. Every one is free in the Heavybit Library.
- Article
Apiary on API Versioning and Testing Strategies
OCT 10, 2014With Dana Oshiro
Apiary (a Heavybit member) works on rapid iteration of API design. We provide API Blueprint, a simple, markdown-based language to power your product portfolio, and a range of open source tools for API documentation, prototyping and testing.
Article
Apiary on API Versioning and Testing Strategies
Read3 MIN