openapi-specification-v2
REST APIを記述するためのOpenAPI（Swagger）2.0仕様に関するスキルです。Swagger 2.0仕様の作成・検証・解釈、クライアントやドキュメントの生成、あるいはpath・operation・parameter・response・schema・securityの定義を扱う際に活用できます。
description の原文を見る
OpenAPI (Swagger) 2.0 specification for describing REST APIs. Use when writing, validating, or interpreting Swagger 2.0 specs, generating clients/docs, or working with path/operation/parameter/response/schema/security definitions.
SKILL.md 本文
OpenAPI Specification 2.0 (旧称 Swagger 2.0) は、REST API を説明するための JSON/YAML フォーマットを定義しています: パス、オペレーション、パラメータ、レスポンス、スキーマ、セキュリティです。Swagger 2.0 スペックを作成・編集するときや、構造を検証するとき、またはそれらからコード・ドキュメントを生成するときに、このスキルを使用します。
このスキルは OpenAPI Specification 2.0 に基づいており、2026-01-30 に生成されました。
コア参考資料
| トピック | 説明 | 参考資料 |
|---|---|---|
| フォーマットと構造 | ドキュメントフォーマット、ファイル構造、データ型 | core-format-and-structure |
| 固定フィールドとパターンフィールド | スキーマ内の固定フィールド名 vs パターンフィールド名 | core-fixed-patterned-fields |
| Swagger オブジェクト | ルートドキュメント、必須フィールド・オプションフィールド、拡張 | core-swagger-object |
| Info とメタデータ | Info、Contact、License オブジェクト | core-info-metadata |
| Tags と External Docs | Tag オブジェクト、External Documentation オブジェクト | core-tags-and-external-docs |
| Reference オブジェクト | $ref、JSON Pointer、同一ドキュメント内および外部ファイル参照 | core-reference-object |
| データ型とフォーマット | プリミティブ型、フォーマット表、バリデーション、ファイル型 | core-data-types-and-formats |
| MIME タイプ | consumes/produces、RFC 6838、例 | core-mime-types |
| HTTP ステータスコード | レスポンスキー、デフォルトレスポンス、IANA/RFC 7231 | core-http-status-codes |
| パステンプレート | 波括弧、パスパラメータ、名前マッチング | core-path-templating |
| Header オブジェクト | レスポンスヘッダ定義 (型、フォーマット、アイテム、バリデーション) | core-header-object |
| Headers オブジェクト | レスポンスヘッダのコンテナ (名前 → Header オブジェクト) | core-headers-object |
| Items オブジェクト | ボディ以外の配列アイテム (パラメータ、ヘッダ) | core-items-object |
| Example オブジェクト | MIME タイプ別レスポンス例 | core-example-object |
パスとオペレーション
| トピック | 説明 | 参考資料 |
|---|---|---|
| パスとオペレーション | Paths オブジェクト、Path Item、Operation オブジェクト | paths-and-operations |
| Path Item $ref | 外部パス定義、競合動作 | path-item-ref |
パラメータとレスポンス
| トピック | 説明 | 参考資料 |
|---|---|---|
| パラメータ | パラメータロケーション (path、query、header、body、formData) | parameters |
| collectionFormat | csv、ssv、tsv、pipes、multi およびそれらの適用場所 | parameters-collection-format |
| パラメータ定義 (再利用) | ルートレベルパラメータ、$ref 経由での再利用 | parameters-definitions-reuse |
| レスポンス | Responses オブジェクト、Response オブジェクト | responses |
| レスポンス定義 (再利用) | ルートレベルレスポンス、$ref 経由での再利用 | responses-definitions-reuse |
スキーマと定義
| トピック | 説明 | 参考資料 |
|---|---|---|
| スキーマと定義 | Schema オブジェクト、Definitions、合成、ポリモーフィズム | schema-and-definitions |
| Schema JSON Schema キーワード | JSON Schema Draft 4 サブセットと Swagger 固有フィールド | schema-json-schema-keywords |
セキュリティ
| トピック | 説明 | 参考資料 |
|---|---|---|
| セキュリティ | Security Definitions、Security Scheme | security |
| Security Requirement オブジェクト | ルート/オペレーションレベルでのセキュリティ適用、OR/AND ロジック | security-requirement-object |
| Scopes オブジェクト | OAuth2 スコープ名 → 説明 | security-scopes-object |
| Basic と API Key | basic および apiKey Security Scheme | security-basic-apikey |
| OAuth2 フロー | implicit、password、application、accessCode および必須 URL | security-oauth2-flows |
ベストプラクティス
| トピック | 説明 | 参考資料 |
|---|---|---|
| スペック作成 | operationId、tags、responses、parameters、definitions、security | best-practices-spec-authoring |
高度なトピック
| トピック | 説明 | 参考資料 |
|---|---|---|
| ベンダー拡張 | x- プレフィックス、値型、許可される場所 | advanced-vendor-extensions |
| セキュリティフィルタリング | 空の Paths、アクセス制御用の空の Path Item | advanced-security-filtering |
| 拡張と XML | スキーマプロパティ用の XML オブジェクト | advanced-extensions-and-xml |
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- hairyf
- リポジトリ
- hairyf/skills
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/hairyf/skills / ライセンス: MIT
関連スキル
secure-code-guardian
認証・認可の実装、ユーザー入力の保護、OWASP Top 10の脆弱性対策が必要な場合に使用します。bcrypt/argon2によるパスワードハッシング、パラメータ化ステートメントによるSQLインジェクション対策、CORS/CSPヘッダーの設定、Zodによる入力検証、JWTトークンの構築などのカスタムセキュリティ実装に対応します。認証、認可、入力検証、暗号化、OWASP Top 10対策、セッション管理、セキュリティ強化全般で活用できます。ただし、構築済みのOAuth/SSO統合や単独のセキュリティ監査が必要な場合は、より特化したスキルの検討をお勧めします。
claude-authenticity
APIエンドポイントが本物のClaudeによって支えられているか（ラッパーやプロキシ、偽装ではないか）を、claude-verifyプロジェクトを模した9つの重み付きルールベースチェックで検証できます。また、Claudeの正体を上書きしているプロバイダーから注入されたシステムプロンプトも抽出します。完全に自己完結しており、httpx以外の追加パッケージは不要です。Claude APIキーまたはエンドポイントを検証したい場合、サードパーティのClaudeサービスが本物か確認したい場合、APIプロバイダーのClaude正当性を監査したい場合、複数モデルを並行してテストしたい場合、またはプロバイダーが注入したシステムプロンプトを特定したい場合に使用できます。
anth-security-basics
Anthropic Claude APIのセキュリティベストプラクティスを適用し、キー管理、入力値の検証、プロンプトインジェクション対策を実施します。APIキーの保護、Claudeに送信する前のユーザー入力検証、コンテンツセーフティガードレールの実装が必要な場合に活用できます。「anthropic security」「claude api key security」「secure anthropic」「prompt injection defense」といったフレーズでトリガーされます。
x-ray
x-ray.mdプレ監査レポートを生成します。概要、強化された脅威モデル（プロトコルタイプのプロファイリング、Gitの重み付け攻撃面分析、時間軸リスク分析、コンポーザビリティ依存関係マッピング）、不変条件、統合、ドキュメント品質、テスト分析、開発者・Gitの履歴をカバーしています。「x-ray」「audit readiness」「readiness report」「pre-audit report」「prep this protocol」「protocol prep」「summarize this protocol」のキーワードで実行されます。
semgrep
Semgrepスタティック分析スキャンを実行し、カスタム検出ルールを作成します。Semgrepでのコードスキャン、セキュリティ脆弱性の検出、カスタムYAMLルールの作成、または特定のバグパターンの検出が必要な場合に使用します。重要：ユーザーが「バグをスキャンしたい」「コード品質を確認したい」「脆弱性を見つけたい」「スタティック分析」「セキュリティlint」「コード監査」または「コーディング標準を適用したい」と尋ねた場合も、Semgrepという名称を明記していなくても、このスキルを使用してください。Semgrepは30以上の言語に対応したパターンベースのコードスキャンに最適なツールです。
ghost-bits-cast-attack
Java「ゴーストビッツ」/キャストアタック プレイブック（Black Hat Asia 2026）。16ビット文字が8ビットバイトに暗黙的に縮小されるJavaサービスへの攻撃時に使用します。WAF/IDSを回避して、SQLインジェクション、デシリアライゼーション型RCE、ファイルアップロード（Webシェル）、パストトラバーサル、CRLF インジェクション、リクエストスマグリング、SMTPインジェクションを実行できます。Tomcat、Spring、Jetty、Undertow、Vert.x、Jackson、Fastjson、Apache Commons BCEL、Apache HttpClient、Angus Mail、JDK HttpServer、Lettuce、Jodd、XMLWriterに影響し、WAFバイパスにより多くの「パッチ済み」CVEを再度有効化します。