スキル openapi-to-typescript
📦

openapi-to-typescript

コンテンツリビジョン r1 安全 ⚙️ 外部コマンド

OpenAPI 仕様から TypeScript を生成

API チームには、OpenAPI コントラクトと常に整合する TypeScript モデルが必要です。このスキルは OpenAPI 3.0 仕様をインターフェース、エンドポイント型、実行時ガードに変換します。

対応: Claude Codex Code(CC)
🥉 78 ブロンズ

自分のエージェントでインストール

このリクエストをエージェントにコピーしてください。正規の Skill ページとマニフェストが含まれています。

エージェントリクエスト
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.

エージェントは引き続き計画を提示し、セキュリティポリシーで必要な確認を求める必要があります。

エージェントが読めるリソース

AI エージェント、クローラー、スクリプトがページ全体ではなく整理されたコンテキストを必要とする場合は、これらのリンクを使ってください。

Markdown詳細 GET /skills/softaworks-openapi-to-typescript.md 署名済み manifest GET /api/skills/softaworks-openapi-to-typescript/manifest 署名済み lockfile GET /api/skills/softaworks-openapi-to-typescript/lockfile

テストする

「openapi-to-typescript」を使用しています。 Product と Order スキーマを含む OpenAPI 3.0 の製品カタログ仕様。

期待される結果:

Product と Order のインターフェース、エンドポイントのリクエスト型とレスポンス型、型ガード、API エラー型を含む TypeScript ファイル。

「openapi-to-typescript」を使用しています。 enum フィールド、配列、パスパラメーターを含むサービス仕様。

期待される結果:

enum 用に生成されたユニオン型、配列プロパティ型、パスリクエスト型、サポートされていないスキーマ参照に関する警告。

「openapi-to-typescript」を使用しています。 paths セクションが欠落している無効な OpenAPI ドキュメント。

期待される結果:

欠落している paths フィールドを説明する検証メッセージ。生成された出力ファイルはありません。

セキュリティ監査

安全
v5 • 2026/7/7 バージョン別レポートを開く

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
スキャンされたファイル
645
解析済み行数
0
レビュー項目
0
誤検知を無視

リスク要因

⚙️ 外部コマンド (54)
SKILL.md:24 SKILL.md:25 SKILL.md:27 SKILL.md:34-38 SKILL.md:38-48 SKILL.md:48 SKILL.md:49 SKILL.md:50 SKILL.md:51 SKILL.md:52 SKILL.md:58 SKILL.md:59 SKILL.md:60 SKILL.md:61 SKILL.md:62 SKILL.md:67-73 SKILL.md:73-76 SKILL.md:76-79 SKILL.md:79-82 SKILL.md:82-85 SKILL.md:85-88 SKILL.md:88-91 SKILL.md:91-94 SKILL.md:94-99 SKILL.md:99-105 SKILL.md:105-112 SKILL.md:112-116 SKILL.md:116-118 SKILL.md:118-132 SKILL.md:132-135 SKILL.md:135 SKILL.md:136 SKILL.md:140-142 SKILL.md:142-160 SKILL.md:160-163 SKILL.md:163-164 SKILL.md:164-170 SKILL.md:170-183 SKILL.md:183-186 SKILL.md:186-187 SKILL.md:187-188 SKILL.md:188-189 SKILL.md:189-190 SKILL.md:190-194 SKILL.md:194-211 SKILL.md:211-215 SKILL.md:215-216 SKILL.md:216-219 SKILL.md:219-223 SKILL.md:223-228 SKILL.md:228-261 SKILL.md:261-264 SKILL.md:264-335 SKILL.md:335-343
最新の完了済み静的・セマンティック監査では、確認済みのセキュリティ検出事項は見つかりませんでした。これは、スキルに副作用がないことを証明するものではありません。
監査者: codex 監査履歴を表示 →
このレポートを共有・引用

バージョン付き評価レポート、中立的なバッジ、埋め込みカード、引用を共有できます。Skillstore は証拠を報告しますが、この Skill が安全かどうかは判断しません。

バージョン別レポートを開く
セキュリティ評価

レポートリンクをコピー

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

Markdownバッジ

[![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バッジ

<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>

埋め込みカード

<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>
学術引用 (APA · BibTeX · CFF)

APA形式の引用

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形式の引用

@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 スコア

このスコアの理由 証拠の信頼度: 高
55
アーキテクチャ
85
保守性
87
コンテンツ
71
コミュニティ
83
仕様準拠

作成できるもの

フロントエンド API 統合

バックエンドの OpenAPI 仕様を、UI のデータ取得とレスポンス処理用の TypeScript コントラクトに変換します。

共有サービスコントラクト

内部 API を利用するチーム向けに、生成されたリクエスト型とレスポンス型を公開します。

テストでのレスポンス検証

生成された型ガードを使用して、自動テストワークフローで API レスポンスを検証します。

これらのプロンプトを試す

基本型を生成 
./openapi.json から TypeScript インターフェースを生成し、types/api.ts に保存してください。ファイルを書き込む前に検証エラーを報告してください。
カスタム出力パスを使用 
./specs/service.yaml を TypeScript のリクエスト型、レスポンス型、スキーマ型に変換してください。結果を src/generated/api-types.ts に保存してください。
再生成された型を比較 
./openapi.yaml から型を再生成し、結果を src/types/api.ts と比較して、破壊的な型変更があれば要約してください。
複雑なスキーマを処理 
./api/openapi.yaml を変換し、oneOf、allOf、enum、配列、未解決の参照をレビューしてください。手動レビューが必要な箇所を指摘してください。

ベストプラクティス

  • コントラクトエラーを早期に修正するため、生成前に OpenAPI 仕様を検証します。
  • ソース API 仕様が変更されるたびに型を再生成します。
  • 不明な型、循環参照、複雑な allOf スキーマに関する警告をレビューします。

回避

  • ソース仕様を更新できる場合は、生成されたファイルを手動で編集しないでください。
  • 生成された型ガードを完全なビジネスルール検証として扱わないでください。
  • 生成された出力内の未解決の参照や不明な型を無視しないでください。

よくある質問

どの OpenAPI バージョンがサポートされていますか？
このスキルは OpenAPI 3.0.x をサポートします。Swagger 2.0 または OpenAPI 3.1 のサポートはドキュメント化されていません。
完全な API クライアントを生成しますか？
いいえ。インターフェース、エンドポイント型、型ガード、共有 API エラー型を生成します。
YAML と JSON の仕様を読み取れますか？
はい。このスキルのドキュメントには、JSON と YAML の OpenAPI ファイルを受け付けると記載されています。
enum はどのように扱われますか？
文字列 enum は、許可されたリテラル選択肢を表す TypeScript ユニオン型に変換されます。
仕様が無効な場合はどうなりますか？
このスキルは検証エラーを報告し、出力を生成する前に停止します。
出力ファイルを選択できますか？
はい。生成された TypeScript の保存先を尋ね、デフォルトとして types/api.ts を使用します。

開発者情報

作成者

softaworks

ライセンス

MIT

Skillstore リビジョン

r1

バージョンに関する注意

作者はバージョンを宣言していません。

リポジトリ

https://github.com/softaworks/agent-toolkit/tree/main/skills/openapi-to-typescript/

参照

f93e9bb0daca99badb6a7e574b97737155d57cb3

メンテナンスの新しさ

2026/7/18

利用状況

7 ダウンロード · 269 閲覧

ファイル構成

📄 README.md

📄 SKILL.md

softaworks のその他のスキル

すべて表示

関連スキル

すべて表示