api-and-interface-designlisted
Install: claude install-skill ValentinNikolaev/agent-skills
<!-- GENERATED BY generate_skill_wrappers.py; DO NOT EDIT MANUALLY. -->
## Generated Claude Code skill — do not edit manually
This complete skill and its bundled resources are generated from `agent-plugins/skills/api-and-interface-design/SKILL.md`. Manual changes in this directory will be overwritten the next time the generator runs. Edit the canonical skill instead.
# API and Interface Design
Design an interface consumers can use, validate, and evolve. Adapted from Addy Osmani's `api-and-interface-design` workflow; see the bundled license and repository third-party notice.
## Route precisely
- Use for a new or changing public API, protocol, event, module interface, or cross-component contract before implementation.
- Use `write-spec` for full feature requirements, `review-spec` to evaluate an existing design document, `review-arch` for the whole system's boundaries, `vet-dependency` for library adoption, and `code-review` for a changed implementation.
- Do not impose REST or TypeScript conventions on a different transport or language.
## Fix the consumer contract
1. Read repository instructions, existing versioned contracts, callers, serializers, tests, and deployment constraints. Name the consumers and what they need to accomplish.
2. Define inputs, outputs, types or schema, errors, side effects, ordering, defaults, and lifecycle. Separate transport validation from trusted internal invariants. Treat external responses as untrusted data.
3. For a changed interface, in