Is Zod mandatory for using this skill?

While highly recommended for runtime safety, the skill also provides general TypeScript patterns for interfaces, types, and utility transformations that can be used independently.

How does this skill improve API reliability?

It enforces strict typing and runtime validation using Zod, ensuring that data structures match your expected schemas at both compile-time and runtime.

Can I use this for both frontend and backend development?

Yes, these patterns are designed to create a unified contract that can be shared or mirrored across the entire application stack.

Why does the skill forbid the 'any' type?

Using 'any' bypasses TypeScript's type checking; this skill promotes using 'unknown' with type guards to ensure all data is safely handled before use.

Type-Safe API Contracts

Name: Type-Safe API Contracts
Author: Agentient

byAgentient

0•

API Development

Enforces strict TypeScript patterns and Zod integration to ensure robust, type-safe API design and runtime data validation.

This skill provides a comprehensive framework for developing resilient TypeScript APIs by mandating explicit return types and implementing strict runtime validation via Zod. It offers standardized patterns for API response wrappers, clear guidance on choosing between interfaces and types, and provides a suite of utility types for efficient data transformation. By eliminating anti-patterns like the 'any' type and unsafe non-null assertions, it ensures that your API contracts are self-documenting, reliable, and easy to maintain across the full stack.

Key Features

01Mandatory explicit return types for increased code predictability

020 GitHub stars

03Best practices for Interface vs Type usage in object modeling

04Built-in utility types for efficient field picking and transformation

05Seamless Zod integration for rigorous runtime schema validation

06Generic API response wrappers for standardized communication

Use Cases

01Standardizing communication layers between frontend and backend services

02Designing robust REST or GraphQL API endpoints with end-to-end type safety

03Implementing strict schema validation for incoming user-submitted request data

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add agentient/vibekit typescript-type-safe-api-contracts

For use in Claude.ai and ChatGPT

Download Skill