Skip to content
TakoAPI
Back to skills

neo-api-to-ts-interface

by martinforsulu

Web & Frontend Development
—Not yet rated
Your rating

Brief

Automatically generates TypeScript interfaces from REST API responses with Storybook-style documentation UI.

Description

What This Skill Does

Generates TypeScript interfaces from REST API responses by parsing JSON or XML payloads and inferring type structures. Produces formatted, compilable TypeScript code alongside Storybook-style documentation for exploring and sharing types. Supports CLI, programmatic, and agent workflow usage.

Removes the manual round-trip between fetching an API response and writing matching TypeScript, eliminating drift between actual response shapes and declared types.

When to Use It

  • Converting a third-party API response into typed interfaces before writing client code
  • Batch-processing multiple endpoints to keep a shared types file in sync
  • Generating interactive type documentation for an internal API
  • Validating that existing TypeScript interfaces match current API response shapes
  • Automating interface generation in a CI pipeline after API schema changes

Example Workflow

INPUT

User asks: Generate TypeScript interfaces from this API response: {"id":1,"user":{"name":"Alice","roles":["admin"]},"active":true}

AGENT
  1. 1

    Parse the JSON payload and recursively traverse its structure

  2. 2

    Infer types for each field: primitives, nested objects, arrays, and unions

  3. 3

    Generate a formatted TypeScript interface file with readonly modifiers and proper union types

  4. 4

    Validate the output against the TypeScript compiler API

  5. 5

    Render a Storybook CSF documentation file with collapsible type explorer

OUTPUT

A compilable types.ts file with inferred interfaces and an accompanying Storybook HTML doc showing the type hierarchy with example values

Installation

clawhub install martinforsulu/neo-api-to-ts-interface

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links