Skills openapi-to-typescript
๐Ÿ“ฆ

openapi-to-typescript

Content revision r1 Safe โš™๏ธ External commands

Generate TypeScript from OpenAPI Specs

API teams need TypeScript models that stay aligned with OpenAPI contracts. This skill converts OpenAPI 3.0 specs into interfaces, endpoint types, and runtime guards.

Supports: Claude Codex Code(CC)
๐Ÿฅ‰ 78 Bronze

Install with my Agent

Copy this request to your Agent. It includes the canonical Skill page and manifest.

Agent request
Review the Skillstore skill "openapi-to-typescript" from https://skillstore.io/skills/softaworks-openapi-to-typescript.md and its manifest at https://skillstore.io/api/skills/softaworks-openapi-to-typescript/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

Your Agent should still show its plan and request any confirmation required by the security policy.

Test it

Using "openapi-to-typescript". An OpenAPI 3.0 product catalog spec with Product and Order schemas.

Expected outcome:

A TypeScript file containing Product and Order interfaces, endpoint request and response types, type guards, and an API error type.

Using "openapi-to-typescript". A service spec with enum fields, arrays, and path parameters.

Expected outcome:

Generated union types for enums, array property types, path request types, and warnings for unsupported schema references.

Using "openapi-to-typescript". An invalid OpenAPI document missing the paths section.

Expected outcome:

A validation message explaining the missing paths field, with no generated output file.

Security Audit

Safe
v5 โ€ข 7/7/2026 Open versioned report

All 58 static findings were adjudicated as false positives. The external command alerts came from Markdown backticks, inline identifiers, JSON examples, and TypeScript examples rather than executable shell or Ruby code. The system reconnaissance alerts matched type-checking examples and OpenAPI validation text, and no prompt-injection or exfiltration intent was found.

2
Files scanned
645
Lines analyzed
0
Review items
0
False positives ignored
No confirmed security findings were detected by the latest completed static and semantic audit. This does not prove the skill has no side effects.
Audited by: codex View Audit History โ†’
Share & cite this report

Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.

Open versioned report
Security Assessment

Copy report link

https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown badge

[![Skillstore security assessment](https://skillstore.io/badges/skills/softaworks-openapi-to-typescript/security.svg)](https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge)

HTML badge

<a href="https://skillstore.io/skills/softaworks-openapi-to-typescript?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/softaworks-openapi-to-typescript/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

Embed card

<iframe src="https://skillstore.io/embed/skills/softaworks-openapi-to-typescript.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
Academic citations (APA ยท BibTeX ยท CFF)

APA citation

softaworks. (2026). openapi-to-typescript security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5

BibTeX citation

@techreport{softaworks-softaworks-openapi-to-typescript-2026, author = {softaworks}, title = {openapi-to-typescript security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "openapi-to-typescript security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "softaworks" date-released: "2026-07-07" url: "https://skillstore.io/skills/softaworks-openapi-to-typescript/audits/5" identifiers: - type: other value: "skillstore:softaworks-openapi-to-typescript:audit:5" description: "Skillstore immutable audit report identifier"

Skillstore Score

Why this score Evidence Confidence: High
55
Architecture
85
Maintainability
87
Content
71
Community
83
Spec Compliance

What You Can Build

Frontend API Integration

Convert backend OpenAPI specs into TypeScript contracts for UI data fetching and response handling.

Shared Service Contracts

Publish generated request and response types for teams that consume internal APIs.

Response Validation in Tests

Use generated type guards to validate API responses in automated test workflows.

Try These Prompts

Generate Basic Types
Generate TypeScript interfaces from ./openapi.json and save them to types/api.ts. Report validation errors before writing files.
Use a Custom Output Path
Convert ./specs/service.yaml into TypeScript request, response, and schema types. Save the result to src/generated/api-types.ts.
Compare Regenerated Types
Regenerate types from ./openapi.yaml, compare the result with src/types/api.ts, and summarize any breaking type changes.
Handle Complex Schemas
Convert ./api/openapi.yaml and review oneOf, allOf, enums, arrays, and unresolved references. Flag areas needing manual review.

Best Practices

  • Validate the OpenAPI spec before generation to fix contract errors early.
  • Regenerate types whenever the source API specification changes.
  • Review warnings for unknown types, circular references, and complex allOf schemas.

Avoid

  • Do not edit generated files manually when the source spec can be updated.
  • Do not treat generated type guards as complete business-rule validation.
  • Do not ignore unresolved references or unknown types in generated output.

Frequently Asked Questions

Which OpenAPI versions are supported?
The skill supports OpenAPI 3.0.x. It does not document support for Swagger 2.0 or OpenAPI 3.1.
Does it generate a full API client?
No. It generates interfaces, endpoint types, type guards, and a shared API error type.
Can it read YAML and JSON specs?
Yes. The skill documentation states that JSON and YAML OpenAPI files are accepted.
How are enums handled?
String enums are converted to TypeScript union types that represent the allowed literal choices.
What happens when the spec is invalid?
The skill reports the validation error and stops before generating output.
Can I choose the output file?
Yes. It asks where to save the generated TypeScript and uses types/api.ts as the default.

Developer Details

Author

softaworks

License

MIT

Skillstore revision

r1

Version notice

The author did not declare a version.

Ref

f93e9bb0daca99badb6a7e574b97737155d57cb3

Maintenance freshness

7/18/2026

Usage

7 downloads ยท 269 views

File structure

๐Ÿ“„ README.md

๐Ÿ“„ SKILL.md