スキル openapi-spec-generation

📦

openapi-spec-generation

Name: openapi-spec-generation
Author: sickn33

コンテンツリビジョン r2 安全 🌐 ネットワークアクセス⚙️ 外部コマンド

OpenAPI 3.1 仕様を生成

ドキュメント、SDK、テストの整合性を保つには、チームに正確な API コントラクトが必要です。このスキルは、REST API 向けの OpenAPI 3.1 の作成、レビュー、保守をガイドします。

対応: Claude Codex Code(CC)

🥉 78 ブロンズ

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

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

エージェントリクエスト

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

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

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

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

Markdown詳細 GET /skills/sickn33-openapi-spec-generation.md 署名済み manifest GET /api/skills/sickn33-openapi-spec-generation/manifest 署名済み lockfile GET /api/skills/sickn33-openapi-spec-generation/lockfile

テストする

「openapi-spec-generation」を使用しています。チームがユーザーとプロフィールのエンドポイント向けのスターターコントラクトを必要としています。

期待される結果:

リソースグループ、認証要件、レスポンスカテゴリを含む構造化された API コントラクトのアウトライン。
ユーザー、プロフィール、ページネーション、標準エラーレスポンスのためのスキーマ計画。

「openapi-spec-generation」を使用しています。開発者にルートハンドラーはありますが、保守されている API ドキュメントがありません。

期待される結果:

ルートから operations、parameters、request bodies、response models へのマッピング。
ドキュメント公開前のコードアノテーションと検証手順のチェックリスト。

「openapi-spec-generation」を使用しています。ドキュメント所有者が SDK 生成品質を改善したいと考えています。

期待される結果:

operation IDs、schema 再利用、server entries、error response の一貫性に関するレビュー要約。
仕様検証、ドキュメント公開、クライアント生成をカバーするリリースワークフロー。

セキュリティ監査

安全

v5 • 2026/8/4 バージョン別レポートを開く

All 21 static findings are false positives. The URLs are documentation examples, the reconnaissance matches are ordinary schema terms, and the backticks mark Markdown file paths rather than executable commands.

スキャンされたファイル

1,070

解析済み行数

レビュー項目

誤検知を無視

リスク要因

🌐 ネットワークアクセス (8)

resources/implementation-playbook.md:28 resources/implementation-playbook.md:66 resources/implementation-playbook.md:69 resources/implementation-playbook.md:72 resources/implementation-playbook.md:74 resources/implementation-playbook.md:76 resources/implementation-playbook.md:532 resources/implementation-playbook.md:533

⚙️ 外部コマンド (2)

SKILL.md:32 SKILL.md:36

最新の完了済み静的・セマンティック監査では、確認済みのセキュリティ検出事項は見つかりませんでした。これは、スキルに副作用がないことを証明するものではありません。

監査者: codex 監査履歴を表示 →

このレポートを共有・引用

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

バージョン別レポートを開く

レポートリンクをコピー

https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdownバッジ

[![Skillstore security assessment](https://skillstore.io/badges/skills/sickn33-openapi-spec-generation/security.svg)](https://skillstore.io/skills/sickn33-openapi-spec-generation?utm_source=security_passport_badge)

HTMLバッジ

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

埋め込みカード

<iframe src="https://skillstore.io/embed/skills/sickn33-openapi-spec-generation.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形式の引用

sickn33. (2026). openapi-spec-generation security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5

BibTeX形式の引用

@techreport{sickn33-sickn33-openapi-spec-generation-2026,
  author = {sickn33},
  title = {openapi-spec-generation security audit report (audit version 5)},
  institution = {Skillstore},
  year = {2026},
  number = {5},
  url = {https://skillstore.io/skills/sickn33-openapi-spec-generation/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-spec-generation security audit report (audit version 5)"
version: "unspecified"
type: report
authors:
  - name: "sickn33"
date-released: "2026-08-04"
url: "https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5"
identifiers:
  - type: other
    value: "skillstore:sickn33-openapi-spec-generation:audit:5"
    description: "Skillstore immutable audit report identifier"

バリアントを比較

インストール可能なバリアント 2 件

各作者のスキルは個別のインストール項目として維持されます。推奨バリアントは Skillstore の証拠で順位付けされます。

このバリアントが首位の理由

Skillstore スコアが最高

作者 / ソース Skillstore スコア証拠の信頼度 Skillstore 利用状況更新済み

sickn33 推奨現在

sickn33-openapi-spec-generation

Skillstore スコア 78

証拠の信頼度高

Skillstore 利用状況 17

更新済み

2026-09-09

wshobson

wshobson-openapi-spec-generation

Skillstore スコア 76

証拠の信頼度高

Skillstore 利用状況 14

更新済み

2026-09-09

Skillstore スコア

このスコアの理由証拠の信頼度: 高

アーキテクチャ

保守性

コンテンツ

コミュニティ

仕様準拠

作成できるもの

新しい API コントラクトを設計する

バックエンド実装を開始する前に、明確な OpenAPI 3.1 のベースラインを作成します。

既存エンドポイントを文書化する

ルートの挙動、レスポンスモデル、検証ルールを再利用可能な API ドキュメントに変換します。

SDK とポータルの入力を準備する

生成されるクライアントとドキュメントポータルが一貫した operation の詳細を持つように仕様を整えます。

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

スターター仕様を作成する

これらのエンドポイントを持つ REST API の最初の OpenAPI 3.1 仕様を作成してください: [list endpoints]。paths、schemas、responses、認証を含めてください。

ドラフト仕様をレビューする

不足している schemas、弱い response 定義、一貫性のない operation IDs、不明確な security 要件について、この OpenAPI ドラフトをレビューしてください: [paste summary]。

コードを OpenAPI にマッピングする

これらのルート定義とモデルを使用して、OpenAPI 3.1 の構造を提案してください。生成に必要なアノテーションまたはメタデータを特定してください: [paste routes]。

コントラクトガバナンスを計画する

OpenAPI の変更検証、ドキュメント公開、SDK 生成のためのワークフローを設計してください。チェック、所有権、リリース手順を含めてください。

ベストプラクティス

実際のエンドポイントの挙動から始め、その後で名前、スキーマ、レスポンスパターンを正規化します。
operations 全体で認証、認可、エラー、ページネーションを一貫して定義します。
ドキュメントを公開したり SDK を生成したりする前に仕様を検証します。

回避

本番 API コントラクトにプレースホルダースキーマを残さないでください。
一貫性のない operation IDs、tags、response shapes を混在させないでください。
security schemes と error formats を文書化せずに仕様を公開しないでください。

よくある質問

このスキルは完全な OpenAPI ファイルを生成しますか？

構造と内容をガイドできます。最終的な品質は、提供されるエンドポイントの詳細とスキーマに依存します。

既存コードから作業できますか？

はい。code-first パターンを含み、ルート、モデル、アノテーションを OpenAPI の概念にマッピングするのに役立ちます。

外部 API サービスを呼び出しますか？

いいえ。このスキルはガイダンスと例を提供します。単独でネットワークリクエストを行うことはありません。

どの OpenAPI バージョンを対象にしていますか？

OpenAPI 3.1 に焦点を当てており、schemas、再利用可能な components、security schemes、server metadata を含みます。

SDK 生成に役立ちますか？

はい。クライアント生成とドキュメントポータル向けに一貫した仕様を準備する方法を説明します。

GraphQL API に適していますか？

いいえ。GraphQL スキーマではなく、OpenAPI で記述される RESTful API に焦点を当てています。

開発者情報

作成者

sickn33

ライセンス

MIT

Skillstore リビジョン

バージョンに関する注意

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

リポジトリ

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/openapi-spec-generation

参照

81e05e636292629114b76cbb3922fbe57672fc02

メンテナンスの新しさ

2026/8/5

利用状況

15 ダウンロード · 114 閲覧

ファイル構成

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md

sickn33 のその他のスキル

すべて表示

📦

content-creator

ブランドに一貫したマーケティングコンテンツを作成

マーケティングチームには、チャネルを横断して一貫性を保つコンテンツが必要です。このスキルは、ブランドボイスとSEOに合わせてコンテンツを計画、執筆、分析、最適化するのに役立ちます。

ライティング＆コンテンツ表示

📦

prompt-engineering-patterns

実証済みパターンでLLMプロンプトを改善

一貫性のないプロンプトは時間を浪費し、AIの出力を信頼しにくくします。このスキルは、再利用可能なパターン、例、評価手順、最適化ワークフローを使ってプロンプト設計を支援します。

生産性表示

📦

senior-architect

スケーラブルなソフトウェアアーキテクチャを設計する

アーキテクチャ上の意思決定は、Web、モバイル、バックエンド、クラウドシステム全体で比較するのが困難です。このスキルは、レポート、依存関係レビュー、トレードオフ文書化のための構造化されたガイドとローカルのスキャフォールドスクリプトを提供します。

コーディング＆開発表示

📦

senior-fullstack

シニアレベルのパターンでフルスタックアプリを構築

チームには、モダンなWebアプリケーション向けに一貫したセットアップ、アーキテクチャ、レビュー指針が必要です。このスキルは、React、Next.js、Node.js、GraphQL、PostgreSQLプロジェクト向けのスキャフォールダー、ワークフローのリファレンス、品質向上のためのプロンプトを提供します。

コーディング＆開発表示

📦