openapi-to-typescript

Converts OpenAPI 3.0 JSON/YAML to TypeScript interfaces and type guards. This skill should be used when the user asks to generate types from OpenAPI, convert schema to TS, create API interfaces, or generate TypeScript types from an API specification.

1.51x

Quality

82%

Does it follow best practices?

Impact

100%

1.51x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

100%

37%

Order Management API Types

Type guards and ApiError generation

Criteria

Without context

With context

isApiError present

100%

ApiError interface present

100%

ApiError detail optional

100%

Type guard per interface

100%

Guard: object + null check

100%

Guard: field presence check

50%

100%

Guard: typeof primitive check

100%

Guard: enum .includes() check

44%

100%

UUID JSDoc comment

62%

100%

Email JSDoc comment

100%

Enum as union literal

100%

Enum type named correctly

100%

26%

Content Platform Search API Types

Complex type mapping and $ref resolution

Criteria

Without context

With context

Array type syntax

100%

$ref not inlined

100%

oneOf as union

100%

allOf as extends

100%

Required vs optional fields

100%

integer maps to number

100%

Enum as union literal

100%

Enum type named correctly

100%

Type guard: Array.isArray check

100%

ApiError always present

100%

JSDoc from description

100%

38%

Inventory Management API TypeScript Bindings

Request/response naming and file header

Criteria

Without context

With context

File header present

25%

100%

Header: source filename

100%

GET request type name

22%

100%

POST request type name

33%

100%

Response type name

66%

100%

Optional query params

100%

Required path params

100%

Response $ref not inlined

100%

ApiError always present

100%

Schema interfaces generated

100%

Type guards for schemas

100%

Output at types/api.ts

100%

Repository: softaworks/agent-toolkit
Commit: 3027f20

Evaluated: 30 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

Order Management API Types Content Platform Search API Types Inventory Management API TypeScript Bindings

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.