api-spec
Installation
SKILL.md
API Specification
Entry Gate
Own bounded API contract artifacts and their validation. Resolve the service, native authority, consumers, and accepted business semantics before defining wire behavior. Missing identity, permission, lifecycle, success, or failure decisions block the affected definition; return the exact gap to the product or domain owner.
Route Map
| Request condition | Read or route | Result |
|---|---|---|
| Create or revise an API contract | Contract design | One declared authority and scoped artifact change |
| Author or validate OpenAPI fields, security, or compatibility | Applicable OpenAPI authoring sections | Wire definitions and separate validation evidence |
| Confirm an already accepted contract without changes | Existing baseline | Bounded no-op evidence |
| Feature behavior or shared business meaning is undecided | product-spec or domain-modeling |
Owner decision before the dependent contract |
| Implement source or review a fixed change | Matching dev-* owner or repo-review |
No implementation or independent review inside API authoring |