jpskill.com
📦 その他 コミュニティ

generate-api-client

OpenAPI仕様書を読み込み、型安全なAPIクライアントを自動生成することで、開発者はAPI連携に関わるコーディング作業を効率化し、よりビジネスロジックに集中できる環境を構築するSkill。

📜 元の英語説明(参考)

Orval APIクライアント生成スキル（OpenAPI仕様書から型安全なAPIクライアントを自動生成）

🇯🇵 日本人クリエイター向け解説

一言でいうと

OpenAPI仕様書を読み込み、型安全なAPIクライアントを自動生成することで、開発者はAPI連携に関わるコーディング作業を効率化し、よりビジネスロジックに集中できる環境を構築するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o generate-api-client.zip https://jpskill.com/download/18136.zip && unzip -o generate-api-client.zip && rm generate-api-client.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/18136.zip -OutFile "$d\generate-api-client.zip"; Expand-Archive "$d\generate-api-client.zip" -DestinationPath $d -Force; ri "$d\generate-api-client.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して generate-api-client.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → generate-api-client フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1
📖 Claude が読む原文 SKILL.md(中身を展開)

この本文は AI(Claude)が読むための原文(英語または中国語)です。日本語訳は順次追加中。

Generate API Client Skill - Orval APIクライアント生成スキル

役割

OpenAPI仕様書（api-docs.yaml）から型安全なAPIクライアントを自動生成するスキルです。

実行フロー

Phase 1: 仕様書確認

# OpenAPI仕様書の存在確認
ls backend/src/main/resources/static/api-docs.yaml

Phase 2: Orval実行

cd frontend

# Orvalで型安全なAPIクライアント生成
pnpm run generate:api

Phase 3: 生成確認

# 生成されたファイル確認
ls frontend/src/lib/api/generated/

Phase 4: 型チェック

# TypeScript型チェック
npx tsc --noEmit

Phase 5: 完了報告

## Generate API Client 完了報告

### 生成結果
- ✅ APIクライアント生成完了
- ✅ 型定義生成完了
- ✅ TypeScript型チェック成功

### 生成ファイル
- frontend/src/lib/api/generated/api.ts
- frontend/src/lib/api/generated/model.ts

### 次のステップ
生成されたAPIクライアントをimportして使用できます。