Use when designing public APIs, module boundaries, provider adapters, tool schemas, or data contracts.
Scanned 6/9/2026
Skills Directorynpx -y skills add MohitGoyal09/AgentForge --skill api-interface-design --agent claude-codeInstalls into .claude/skills of the current project.
Are you the author of Api Interface Design?
Add the live security badge to your README — it updates automatically with every re-scan.
[](https://www.skillsdirectory.com/skills/mohitgoyal09-api-interface-design)More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.
---
name: api-interface-design
description: Use when designing public APIs, module boundaries, provider adapters, tool schemas, or data contracts.
---
# API Interface Design
Design the contract before the implementation.
## Use This For
- REST, GraphQL, or SDK interface design
- Tool parameter schemas
- Provider adapter boundaries
- Data exchanged between the agent loop, tools, and persistence
## Principles
- Prefer additive changes over breaking existing fields.
- Use one predictable error shape.
- Validate external input at the boundary.
- Keep internal call sites typed and boring.
- Treat every observable behavior as something users may depend on.
## Checklist
- Inputs and outputs are typed.
- Error semantics are consistent.
- Optional fields are truly optional.
- New behavior has at least one success test and one failure test.
- Docs show the smallest working example.
Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.
No comments yet. Be the first to comment!
