api-design
Design and document REST, GraphQL and gRPC contracts with OpenAPI, versioning and contract tests.
Skill by poorvith-mp
Chalk Labs
Need help deploying api-design?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/poorvith-mp-api-design
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: documents, design, backend
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/api-design
What's inside
- Skill name
api-design- Description
- Design and document REST, GraphQL and gRPC contracts with OpenAPI, versioning and contract tests. Use when creating OpenAPI schemas, REST, GraphQL, or gRPC contracts.
- License
- MIT
- Instructions
- 34 lines in SKILL.md · view on GitHub
Files (4)
- SKILL.md
- api-design.skill
- routing.yaml · evals/
- openapi-spec.md · references/
SKILL.md (first lines)
# API Design
Guides the complete API lifecycle from OpenAPI/GraphQL schema design to documentation, mock server generation, and contract testing.
## Phased Workflow
### Phase 1: API Contract & Schema Design
1. Define OpenAPI 3.1 / GraphQL schemas with descriptive summary, input parameters, response schemas, and error structures.
2. Enforce API design standards: predictable URI naming (`/v1/resources/{id}`), correct HTTP status codes (200, 201, 204, 400, 401, 403, 404, 409, 422, 500), consistent JSON schemas.
### Phase 2: Mocking & Developer Documentation
1. Generate dynamic mock data generators (Prism, MSW, GraphQL Mocking).
2. Produce comprehensive interactive documentation with code snippets in cURL, JavaScript/TypeScript, Python, and Go.
### Phase 3: Contract & Integration Testing
1. Author automated contract tests (Pact, Newman, Jest) ensuring backend responses match OpenAPI spec.
2. Validate pagination (`cursor` / `limit`), filtering, and rate limit header implementations.
## Verification & Quality Checklist
- [ ] Schema passes OpenAPI 3.1 linter with zero errors.
- [ ] All error responses follow standard schema (RFC 7807 Problem Details).
- [ ] Breaking changes checked against semantic versioning policies.
## Anti-Patterns & Constraints
- NEVER return HTTP 200 OK for error responses with embedded `{ error: true }` in REST APIs.
- NEVER leak internal stack traces or database column names in API error bodies.
## References
Load these only when the task needs them:
- [references/openapi-spec.md](references/openapi-spec.md)From poorvith-mp/skills-developer, MIT.
More from poorvith-mp/skills-developer
- 0.456score
accessibility-fix
poorvith-mp
Audit and refactor code for WCAG 2.1/2.2 AA and AAA: ARIA, keyboard operability, screen readers.
SkillAFreshness: AClaude Code +9 - 0.452score
audit-readiness
poorvith-mp
Prepare for SOC 2, ISO 27001, HIPAA or PCI-DSS: control mapping, gap analysis and evidence.
SkillAFreshness: AClaude Code +9 - 0.452score
change-notes
poorvith-mp
Write commit messages, PR descriptions and changelog entries from the diff itself.
SkillAFreshness: AClaude Code +9 - 0.452score
branching-strategy
poorvith-mp
Design the branching and release model: trunk-based or GitFlow, protection rules, review policy, tracker traceability.
SkillAFreshness: AClaude Code +9 - 0.452score
backend-build
poorvith-mp
Implement services and business logic: request handling, validation, transactions, caching, queues and workers.
SkillAFreshness: AClaude Code +9 - 0.452score
authentication
poorvith-mp
Implement OAuth 2.0, OIDC, sessions, token lifetimes, MFA and password storage without rolling your own crypto.
SkillAFreshness: AClaude Code +9 - 0.427score
accessibility-engineer
poorvith-mp
Moved to accessibility-fix in skills-developer.
SkillAFreshness: AClaude Code +9 - 0.427score
appsec-architect
poorvith-mp
Moved to security-review in skills-developer.
SkillAFreshness: AClaude Code +9 - 0.424score
api-lifecycle-engineer
poorvith-mp
Moved to api-design in skills-developer.
SkillAFreshness: AClaude Code +9 - 0.424score
android-developer
poorvith-mp
Moved to mobile-build in skills-developer.
SkillAFreshness: AClaude Code +9 - 0.424score
ci-cd-pipeline-builder
poorvith-mp
Moved to ci-pipelines in skills-developer.
SkillAFreshness: AClaude Code +9 - 0.423score
ai-data-remediation-engineer
poorvith-mp
Moved to data-pipelines in skills-developer.
SkillAFreshness: AClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Sep 12, 2026 (1 month ago)
- Last release
- Oct 2, 2026 (29 days ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/poorvith-mp/skills-developer
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from poorvith-mp
- 0.495score
blender-modeling
poorvith-mp
Model, retopologise, UV unwrap and bake game-ready assets with correct scale, pivots and polycount.
SkillAFreshness: A★ 5Claude Code +9 - 0.495score
game-audio
poorvith-mp
Integrate FMOD and Wwise, build adaptive music systems, spatial audio and audio performance budgets.
SkillAFreshness: A★ 5Claude Code +9 - 0.495score
anti-cheat
poorvith-mp
Enforce server authority and defend against speed hacks, memory editing, and exploits.
SkillAFreshness: A★ 5Claude Code +9 - 0.495score
blender-animation
poorvith-mp
Rig, skin and animate characters and props, and export clean animation sets to an engine.
SkillAFreshness: A★ 5Claude Code +9 - 0.495score
game-ai
poorvith-mp
Design NPC behaviour: behaviour trees, state machines, pathfinding, perception and difficulty tuning.
SkillAFreshness: A★ 5Claude Code +9 - 0.495score
game-build-pipeline
poorvith-mp
Automate platform builds, asset cooking, console certification prep, and Steam or itch.io depot publishing.
SkillAFreshness: A★ 5Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get api-design running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
api-design skill. Agent Mart. https://agentmart.dev/skills/poorvith-mp-api-design (last updated 2026-10-24)