APIエンドポイントの仕様化 スキル（SKILL.md）
- 新しいインターフェースの設計
- フロントエンドとバックエンドの合意
- パートナー向けドキュメント
- このスキルは何をする？
- メソッド・パス・引数・例・エラー・権限。
- 入力するもの
- テーマ、目的、いくつかの箇条書き。
- 受け取るもの
- 仕様
- 例
- エラー表
- 未決事項
- 対応
- Claude、ChatGPT、Gemini、Microsoft 365 Copilot、Cursorなどのアシスタント
スキルの指示
AIはこのスキルでこのように作業します。コピーするか、ファイルとしてアシスタントに追加してください。
- エンドポイントの目的と利用者を確認します。
- メソッド、パス、型つきパラメーターを決めます。
- 架空のテストデータでリクエストとレスポンスの例を書きます。
- エラーケースをステータスコードつきで挙げます。
- 認証、権限、制限を決め、未決事項に印をつけます。
全文を見る
--- name: api-endpoint-spec description: "APIエンドポイントの仕様書を作ります。インターフェースを作る前に使います。" license: "仕事を含め自由に利用可。独自のコレクションとして公開しないこと。AI Compare Ninja 利用規約。" --- # APIエンドポイントの仕様化 そのまま実装・テストできる、あいまいさのないAPI仕様を書きます。 ## 手順 1. エンドポイントの目的と利用者を確認します。 2. メソッド、パス、型つきパラメーターを決めます。 3. 架空のテストデータでリクエストとレスポンスの例を書きます。 4. エラーケースをステータスコードつきで挙げます。 5. 認証、権限、制限を決め、未決事項に印をつけます。 ## 出力 - 仕様 - 例 - エラー表 - 未決事項 ## ルール - 例に実際の顧客データは使いません。 - 前提は前提として明示します。 - 事実、数値、名前、日付、約束をでっち上げないでください。不足している情報は［不明：…］と書くか、質問してください。 - 特に指定がなければ、ユーザーの言語で回答してください。 - 個人データは、作業に必要な範囲でのみ扱ってください。 - あなたが作るのは下書きです。判断と送信は人が行います。 利用：自由（仕事にも可） · 独自のコレクションとして公開しないこと · 出典：AI Compare Ninja
ファイルとして： ダウンロード (ZIP)
Claudeにインストール
- Claudeで設定（Settings）を開き、「Capabilities」で「Code execution and file creation」をオンにします。
- 「Customize」›「Skills」に進みます。
- 「+」をクリックし、「Create skill」、「Upload a skill」の順に選びます。
- ダウンロードしたZIPファイルを選びます。スキルが一覧に表示され、オン・オフを切り替えられます。
ZIPファイルには、ファイルSKILL.mdを含むフォルダー「api-endpoint-spec」が入っています。Claudeが求める形式のままなので、解凍せずにそのままアップロードしてください。
Claude Code：ファイルを ~/.claude/skills/（自分用）またはプロジェクト内の .claude/skills/ に解凍します。
手順はAnthropicのヘルプに基づきます（2026年10月時点）。メニュー名は英語版の表記で、日本語表示や今後の更新で変わる場合があります。TeamやEnterpriseのアカウントでは、管理者がスキルを許可する必要があります。出典： https://support.claude.com/en/articles/12512180-use-skills-in-claude · https://claude.com/docs/skills/how-to
ChatGPT・Gemini・Copilotで使う
ChatGPT：Business・Enterprise・Eduのワークスペースでは、管理者が許可していればファイルをスキルとしてアップロードできます。Geminiアプリ：SKILL.mdまたはZIPでアップロードできます。Microsoft 365 Copilot：Coworkで自分のスキルとしてアップロードします。Codex、GitHub Copilot、Cursorはプロジェクト内の .agents/skills/ フォルダーからスキルを読み込みます。それ以外では、本文をChatGPTやClaudeのプロジェクトの指示欄か、チャットの最初に貼り付けてください。
各社のヘルプページによる（2026年10月時点）。利用できるかはプラン、管理者設定、年齢、地域によって異なります。出典： https://help.openai.com/en/articles/20001066-skills-in-chatgpt · https://support.google.com/gemini/answer/17094296 · https://learn.microsoft.com/en-us/microsoft-365/copilot/cowork/cowork-customize · https://developers.openai.com/codex/skills · https://code.visualstudio.com/docs/copilot/customization/agent-skills · https://cursor.com/docs/context/skills
利用条件・安全性・注意事項
テキストのみ・当サイトで確認済み. このスキルには、スクリプト、リンク、他サービスへの呼び出しは含まれていません。AIに対し、何もでっち上げず、最終判断をあなたに任せるよう指示しています。
AIの結果は誤っていたり不完全だったりすることがあります。使う前、送る前に必ず確認してください。法律・税務・金融・医療の助言ではありません。無保証です。
パスワード、健康・銀行・身分証明書の情報、他人の個人情報をAIツールに入力しないでください。入力した内容は、各提供元がそれぞれの規約に基づいて処理します。
当サイトのスキルは、仕事を含めて自由に使い、変更できます。独自のコレクションとして公開することはご遠慮ください。AIの出力については保証しません。必ずご自身で確認してください。 利用規約