スキル

gemini-api-dev でベストプラクティスに沿って Gemini API 呼び出しを書く

代理に Interactions API 向けの Gemini 呼び出しコードを書かせたい人向け。先に公式の npx skills add で gemini-api-dev を入れる。これは Google 公式サポートの製品ではない。

公式ソース · gemini-skills

インストール

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

誰向けか

代理に Gemini API、SDK、モデル操作の呼び出しコードを書かせたいときに、このスキルライブラリを使う。原文はそれを Gemini API、SDK、モデル操作のスキルライブラリと書き、gemini-api-dev を個別に名指しする:Interactions API 向けのアプリ開発。テキスト生成、複数ターン対話、ストリーミング出力、関数呼び出し、構造化出力、画像生成、Deep Research agents、非推奨モデルのガードレール、Python と TypeScript SDK をカバーする。ドキュメントは

https://ai.google.dev/gemini-api/docs/interactions?ua=chat

公式リポジトリは

https://github.com/google-gemini/gemini-skills

原文はこれらのスキルを、普段使う AI コーディングアシスタントとパッケージマネージャへ入れられると書く。具体的な製品は名指ししない。クライアントの名簿を自分で足さない。いくつかの環境だけの独占とも書かない。このマシンで公式 npx コマンドを実行する準備が無いなら、先に続けない。

原文はさらに書く:これは Google 公式サポートの製品ではなく、Google オープンソースソフトウェア脆弱性報奨金プログラムにも参加できない。評価数字は、スキルを入れたあと代理が正しい API コードを出す割合が変わることを示すだけ。自分のマシンでの一回の呼び出し成功基準にしない。評価が二つのモデルに触れたからといって、スキルがその二つだけで使えるとも推論しない。ライブラリに他のスキルがあるかもしれない。ただし原文がコピー可能なインストール例として書くのは gemini-api-dev だけ。最初に、出ていないスキルを自分で名指ししない。

3 分で最初の試行を終える

先に公式リポジトリを開いて照合する:

https://github.com/google-gemini/gemini-skills

推奨経路は公式の npx skills add。最初は閲覧だけ。先にスキルをたくさん入れない。閲覧は対話式。実行前に、リストを見るだけだと確認する:

npx skills add google-gemini/gemini-skills --list

リストを見たら、原文の具体例は gemini-api-dev。インストールはこのマシンへスキルファイルを書く。実行前に、これが一つだけ欲しいと確認する:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

出ていないスキル名に変えない。第二のインストーラも作らない。原文はスキルの着地ディレクトリを書いていない。経路を自分で足さない。

代理では最初は照合だけ。先に本物の API を呼ばない。画像生成も Deep Research の起動もしない。代理に、gemini-api-dev がカバーする Interactions API 能力と、これが公式サポートの Google 製品ではないことを言わせる。観察点は、テキスト生成、複数ターン対話、ストリーミング出力、関数呼び出し、構造化出力、Python と TypeScript SDK を復唱でき、まだネットに出ていないこと。

本当の呼び出しコードを書くとネットに出る。クォータも消費しうる。自分の Gemini 資格情報を使う準備ができてから続ける。原文はキーのフィールド名を書いていない。プレースホルダのキーを書かない。最初は画像生成と Deep Research に触れない。

利用事例

事例一:先に閲覧し、スキルを一つ入れる。npx skills add google-gemini/gemini-skills --list を実行し、リストにスキルが見えてから gemini-api-dev を入れる。Interactions API スキルを代理へつなぐだけで、まだリクエストを送る準備が無い人向け。成功の合図は list が開き、指定スキルのインストールコマンドが正常に終わること。原文は list の完全なフィールドを書いていない。他の --skill 名を作らない。

事例二:先に配線範囲を照合し、コードを書くか決める。gemini-api-dev を入れたあと、代理にテキスト生成、複数ターン対話、ストリーミング出力、関数呼び出し、構造化出力、画像生成、Deep Research agents、非推奨モデルのガードレール、Python と TypeScript SDK をカバーすると復唱させる。代理がすぐネットに出たり画像を出したりすることを心配する人向け。成功の合図は範囲をはっきり言え、公式サポート製品ではないと認めること。本物の呼び出しを書くなら、今回 Gemini API にアクセスすると先に確認し、資格情報は自分で用意する。原文にリクエストの見本パラメータは無い。作らない。評価に出た Gemini 3 Flash と Gemini 3.1 Pro の数字を、自分が再現すべき基準にしない。

利用上の境界

主経路は npx skills add google-gemini/gemini-skills。閲覧は --list。例のスキルは --skill gemini-api-dev。他のスキル名やインストーラを作らない。原文は常用の AI コーディングアシスタントとパッケージマネージャへ入れられると言うが、製品は名指ししない。名簿を足さない。独占範囲とも書かない。

これは公式サポートの Google 製品ではない。脆弱性報奨金プログラムの説明は

https://bughunters.google.com/open-source-security

能力は上記の Interactions API 項目と二つの SDK で止まる。画像生成と Deep Research には外部副作用がある。最初はしない。原文はキーフィールド、クォータ、アンインストール手順を書いていない。書いていないモデル名簿、クライアント名簿、リクエストパラメータを補わない。最初の成功は閲覧コマンドまたはインストール終了と、代理が範囲を復唱できることだけ。本当にネットへ出る前に、資格情報と今回 API へアクセスすることを確認する。原文はアンインストールや更新コマンドを書いていない。第二のインストーラを自分で足さない。代理が画像生成や Deep Research 起動を始めたら先に止め、読み取り専用の説明へ戻る。評価のパーセントは、自分の一回の成功合図の代わりにならない。