api-writer

Generate API contracts from PRD and boundary confirmations for REST, GraphQL, and gRPC.

79|23|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/TestAny-io/testany-agent-skills --skill api-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-writer
Source: https://github.com/TestAny-io/testany-agent-skills/tree/main/plugins/testany-eng/skills/api-writer
Command: npx skills add https://github.com/TestAny-io/testany-agent-skills --skill api-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams translate PRD and boundary confirmations into formal API contracts, preventing interface drift between front-end, back-end, and other stakeholders.

Core Features & Use Cases

  • Contract generation from PRD, boundary notes, and design inputs for REST, GraphQL, gRPC, and related protocols.
  • Multi-protocol alignment ensures consistency across HTTP, GraphQL, event contracts, and SDK boundaries.
  • Documentation-to-contract bridging outputs ready-to-use contract artifacts (OpenAPI/AsyncAPI/GraphQL) for downstream teams.

Quick Start

Provide PRD excerpts and boundary confirmations, specify the target contract type (HTTP/REST, GraphQL, or gRPC), and request a draft contract ready for review.

Frequently Asked Questions about api-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate OpenAPI contracts from a PRD to prevent interface drift?

Generate OpenAPI contracts from your PRD by providing excerpts and boundary confirmations to produce precise, versioned contract artifacts. This prevents interface drift by establishing formal API agreements across teams before implementation begins.

Can I write API contracts for GraphQL and gRPC from the same PRD inputs?

Yes, you can write API contracts for GraphQL and gRPC from the same PRD inputs. The tool supports multi-protocol alignment, ensuring consistency across REST, GraphQL, gRPC, and event contracts while maintaining clear ownership and versioning.

What is the best way to translate boundary confirmations into formal API contracts?

Translating boundary confirmations into formal API contracts involves mapping design inputs and boundary notes directly to contract artifacts. This process outputs ready-to-use OpenAPI or AsyncAPI files with clear references to the PRD, excluding implementation details.

Does this API contract generation approach support event contracts and SDK-style interfaces?

Yes, this API contract generation approach supports event contracts and SDK-style interfaces. It applies contract writing across services and teams, producing artifacts for AsyncAPI and SDK boundaries to ensure multi-protocol alignment.

How to create versioned API documentation without including implementation details?

Create versioned API documentation by drafting contracts from PRD excerpts and boundary confirmations. The resulting artifacts include ownership, versioning, and PRD references, strictly separating contract definitions from implementation details.

When do I need formal API contracts instead of just writing PRD requirements?

You need formal API contracts when translating PRD requirements to prevent interface drift between front-end, back-end, and stakeholders. Contracts provide ready-to-use artifacts like OpenAPI and AsyncAPI files that downstream teams can implement against directly.