neo-api-to-ts-interface
par martinforsulu
Web & Frontend DevelopmentRésumé
Automatically generates TypeScript interfaces from REST API responses with Storybook-style documentation UI.
Description
Ce que fait ce skill
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.
Quand l'utiliser
- 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
Exemple de workflow
User asks: Generate TypeScript interfaces from this API response: {"id":1,"user":{"name":"Alice","roles":["admin"]},"active":true}
- 1
Parse the JSON payload and recursively traverse its structure
- 2
Infer types for each field: primitives, nested objects, arrays, and unions
- 3
Generate a formatted TypeScript interface file with readonly modifiers and proper union types
- 4
Validate the output against the TypeScript compiler API
- 5
Render a Storybook CSF documentation file with collapsible type explorer
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-interfaceExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.