Can it handle projects that use multiple different APIs?

Yes, for multi-protocol systems, it generates a 'Contract Index' to synchronize data models and error codes across different interfaces like REST and WebSockets.

Does this skill write the actual backend code?

No, it focuses strictly on the 'contract' layer to ensure architectural alignment and a single source of truth before implementation begins.

How does it ensure the API matches product requirements?

The skill performs a mandatory PRD-to-Contract mapping during its self-check phase to ensure that 100% of the product requirements are addressed in the specification.

What protocols does the API Writer support?

It supports a wide range of protocols including HTTP/REST, GraphQL, gRPC, WebSocket, SSE, Webhooks, and even SDK/Library interfaces or file formats.

API Contract & Specification Writer

Name: API Contract & Specification Writer
Author: TestAny-io

byTestAny-io

•

API 开发

Generates standardized API contracts and protocol specifications to serve as a single source of truth for cross-team development.

The API Writer skill bridges the gap between product requirements and technical implementation by generating precise, reviewable API specifications. It supports a vast array of protocols including REST, GraphQL, gRPC, and Webhooks, ensuring that architectural boundaries and data ownership are defined before coding begins. By enforcing a 'contract-first' approach, it reduces communication drift between frontend and backend teams and maintains consistency through automated mapping of PRDs to interface definitions.

主要功能

01Standardized templates for SDK interfaces, file formats, and IPC/CLI tools

026 GitHub stars

03Multi-protocol support including REST, GraphQL, gRPC, WebSocket, and Webhooks

04Automated PRD-to-Contract requirement mapping for 100% coverage

05Contract Indexing for complex systems using multiple communication patterns

06Consistency self-checks for data models, error codes, and permissions

使用场景

01Architecting complex microservices that require unified event and sync protocols

02Documenting public-facing SDKs and libraries to ensure backward compatibility

03Generating formal API specifications immediately following PRD approval

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add testany-io/testany-agent-skills api-writer

For use in Claude.ai and ChatGPT

Download Skill