Can I use a JSON file instead of a live URL?

Yes, you can provide either a live endpoint URL or a sample JSON response as an argument to generate the necessary files.

How does this skill handle different naming conventions?

It automatically maps snake_case fields commonly found in API responses to camelCase properties used in modern TypeScript application contracts.

Does it support complex data transformation logic?

Yes, the generated adapters include logic for common conversions such as transforming ISO strings into Date objects and converting currency from cents to decimals.

Is the generated code automatically validated?

The skill performs a validation step using 'npx tsc --noEmit' to ensure all generated types, contracts, and adapters are syntactically correct and type-safe.

API Type & Contract Generator

Name: API Type & Contract Generator
Author: HerbertJulio

byHerbertJulio

•

API開発

Generates TypeScript types, application contracts, and data transformation adapters from API endpoints or JSON samples.

This skill streamlines the integration of external APIs into TypeScript projects by automatically generating a robust architectural layer. It follows professional development patterns by separating raw API response types (snake_case) from clean application-level contracts (camelCase) and providing pure adapter functions for bidirectional data transformation. By automating the boilerplate of type definition and data mapping, it ensures type safety across the entire data flow while maintaining clean code standards as defined in your project's architecture.

主な機能

01Automated generation of raw TypeScript interfaces from JSON or API endpoints

0210 GitHub stars

03Development of pure adapter functions for API-to-App and App-to-API transformations

04Built-in validation using the TypeScript compiler to ensure code integrity

05Creation of clean application contracts with camelCase naming and Date object mapping

06Smart data conversion logic for common patterns like cents-to-decimal and string-to-Date

ユースケース

01Refactoring legacy API integrations to follow modern architectural patterns and naming conventions

02Rapidly prototyping data models and adapters based on sample JSON payloads from third-party services

03Integrating new REST API endpoints into a frontend application with strict type safety

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertjulio/specialist-agent dev-generate-types

For use in Claude.ai and ChatGPT

主な機能

01Automated generation of raw TypeScript interfaces from JSON or API endpoints

0210 GitHub stars

03Development of pure adapter functions for API-to-App and App-to-API transformations

04Built-in validation using the TypeScript compiler to ensure code integrity

05Creation of clean application contracts with camelCase naming and Date object mapping

06Smart data conversion logic for common patterns like cents-to-decimal and string-to-Date

ユースケース

01Refactoring legacy API integrations to follow modern architectural patterns and naming conventions

02Rapidly prototyping data models and adapters based on sample JSON payloads from third-party services

03Integrating new REST API endpoints into a frontend application with strict type safety