api-data-contracts

Extract API shapes from OpenAPI specs into TypeScript interfaces and fetch blueprints.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/tmorrowdev/data-plugin --skill api-data-contracts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-data-contracts
Source: https://github.com/tmorrowdev/data-plugin/tree/main/skills/api-data-contracts
Command: npx skills add https://github.com/tmorrowdev/data-plugin --skill api-data-contracts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenAPI specifications often describe API shapes in detail but do not provide ready-to-use, frontend-ready contracts. This skill translates the spec into typed data contracts that describe request/response models and endpoint semantics for UI agents, without exposing any real data.

Core Features & Use Cases

  • Derives TypeScript interfaces from OpenAPI schemas, resolving $ref references, preserving enum values, and honoring nullable fields.
  • Generates structured endpoint fetch blueprints including method, path, parameters, request bodies, responses, and pagination metadata for seamless UI integration.
  • Produces self-contained contracts suitable for handoff to frontend teams or UI-generating agents, enabling code generation and UI previews without contacting live services.

Quick Start

Provide your OpenAPI spec URL and I will generate typed contracts for the endpoints.

Frequently Asked Questions about api-data-contracts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate TypeScript interfaces from an OpenAPI spec?

Generating TypeScript interfaces from an OpenAPI spec involves reading endpoints and schemas to produce reusable typed data contracts. The conversion resolves $ref references, preserves enums, and honors nullable fields for seamless UI integration.

What are typed API data contracts and when do I need them?

Typed API data contracts are structured TypeScript interfaces and fetch blueprints that describe request and response models. You need them when translating OpenAPI schemas into frontend-ready shapes for UI agents or code generation without contacting live services.

Can I use OpenAPI schemas to create fetch blueprints for UI integration?

Yes, OpenAPI schemas can be converted into structured endpoint fetch blueprints for UI integration. These blueprints detail the HTTP method, path, parameters, request bodies, responses, and pagination metadata needed for seamless frontend code generation.

Does generating TypeScript contracts from OpenAPI resolve $ref pointers and enums?

Yes, generating TypeScript contracts from OpenAPI resolves $ref pointers and preserves enum values. The extraction operates strictly on spec content to resolve schema references, honor nullable fields, and document authentication details into typed interfaces.

What is the best way to document API pagination and authentication for frontend teams?

The best way to document API pagination and authentication for frontend teams is to generate self-contained typed data contracts. These contracts extract endpoint semantics and metadata directly from the OpenAPI spec for seamless handoff and UI code generation.

Why do my OpenAPI generated TypeScript interfaces lose nullability information?

OpenAPI generated TypeScript interfaces lose nullability if the extraction process fails to honor nullable fields. Proper typed data contract generation preserves nullability, resolves $ref pointers, and includes enums to maintain schema fidelity for UI agents.