mcpField
G
gemini-guide

gemini-guide

github.com/jezweb開発1.1k149 回インストール3 週間前に更新
リポジトリ

gemini-guide について

gemini-guideは、ClaudeがGemini APIのドキュメントやSDKのパターンを調べるためのスキルです。Gemini自体は呼び出さず、コード生成手順、Google AIの公式ドキュメント、任意のローカルキャッシュを優先順に参照します。

主な機能

  1. 01Gemini APIドキュメントの検索
  2. 02JavaScriptとPython SDKのパターン確認
  3. 03非推奨の使い方を事前確認
  4. 04トピック別のドキュメント検索
  5. 05ローカルキャッシュまたはオンライン文書の参照

活用シーン

  1. 01Gemini API連携コードの作成
  2. 02SDKの初期化と呼び出し方法の確認
  3. 03モデルやAPIトピックの情報収集

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jezweb/claude-skills --skill gemini-guide

インストール後、Claude Code で/gemini-guideを入力して読み込まれたか確認します。

同梱ファイルreferences/deprecated-patterns.mdreferences/topic-index.md

詳細

Gemini ガイド

Google Gemini を使用した開発時に、Gemini API のドキュメントと SDK のパターンを参照します。このスキルは Gemini のドキュメントを Claude に提供するものであり、Gemini を呼び出すものではありません。

スキル方向ツール
gemini-guide（このスキル）Gemini のドキュメント -> ClaudeWebFetch、ローカルドキュメント
gemini-peer-reviewコード -> GeminiGemini API を直接呼び出し

ドキュメントソース

次の優先順位で確認してください。

優先度ソース最適な用途
1GitHub の codegen_instructions常に最新の SDK パターン — https://raw.githubusercontent.com/googleapis/js-genai/refs/heads/main/codegen_instructions.md を取得
2WebFetch 経由の Google AI ドキュメント公式ドキュメント — https://ai.google.dev/gemini-api/docs/{topic}（Markdown 形式にするには末尾に .md.txt を追加）
3ローカルにキャッシュされたドキュメント（~/Documents/google-gemini-context/ にある場合）事前取得済みのトピック — JS 24 件、Python 24 件、共通 7 件

参照ワークフロー

ユーザーから Gemini のトピックについて質問された場合：

  1. 最初に修正事項を確認する：references/deprecated-patterns.md を読み、コードを書く前に、推奨してはいけない内容を把握します
  2. 最新の SDK パターンを取得する：常に最新のパターンを確認するため、GitHub の codegen_instructions.md を取得します
  3. クエリをトピックに対応付ける：references/topic-index.md を読みます。~/Documents/google-gemini-context/ にローカルドキュメントがある場合は該当ファイルを読み、ない場合は https://ai.google.dev/gemini-api/docs/{topic}.md.txt を WebFetch で取得します
  4. 統合する：ドキュメントをまとめ、動作するコード例を含む明確な回答を作成します。必ずステップ 1 の正しいパターンを使用してください。

すぐに適用できる修正事項

よくある間違いは次のとおりです。完全な参考資料を読んでいない場合でも、これらを適用してください。

Claude が提案する可能性のある内容正しい内容
@google/generative-ai@google/genai
google-generativeai（Python）google-genai
GoogleGenerativeAIGoogleGenAI
genAI.getGenerativeModel()ai.models.generateContent()
model.startChat() / chat.sendMessage()ai.chats.create() / chat.send()
generationConfigconfig
stream=True（メソッドのパラメーター）config={"stream": True}
gemini-progemini-2.5-flash
gemini-pro-visiongemini-2.5-flash（統合マルチモーダル）
安全性カテゴリが 4 つ5 カテゴリ（HARM_CATEGORY_CIVIC_INTEGRITY を含む）
HARM_CATEGORY_DANGEROUS_CONTENTHARM_CATEGORY_DANGEROUS（_CONTENT なし）
X-Goog-Api-Key（大文字表記）x-goog-api-key（小文字表記）
1 日あたりのレート制限1 日あたりの制限なし — 1 分あたりのみ（RPM、TPM）
正しい初期化（JS）
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});  // auto-reads GEMINI_API_KEY env var
const response = await ai.models.generateContent({
  model: "gemini-2.5-flash",
  contents: "Your prompt"
});
正しい初期化（Python）
from google import genai
client = genai.Client()  # auto-reads GEMINI_API_KEY env var
response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="Your prompt"
)

ローカルドキュメント（任意）

~/Documents/google-gemini-context/ にローカルキャッシュがある場合、次の内容が含まれています。

ディレクトリ内容
javascript/トピックファイル 24 件 — クイックスタート、関数呼び出し、ストリーミング、構造化出力など
python/トピックファイル 24 件 — JavaScript と同じトピック
common/言語共通ファイル 7 件 — 安全性、料金、レート制限、エラー、認証、リージョン、openai-compat
rest-api/REST エンドポイントのドキュメント
MODELS.md現在のモデル ID、機能、トークン制限、レート制限
googlegenai-gemini-api.mdSDK の包括的なガイド（608 行、JS と Python）

利用できない場合は、Google AI ドキュメントを WebFetch で取得してください（Markdown 形式にするには末尾に .md.txt を追加します）。

現在のモデル

モデルID最適な用途
Gemini 2.5 Progemini-2.5-pro複雑な推論、高度なコーディング
Gemini 2.5 Flashgemini-2.5-flashほとんどのタスク（推奨デフォルト）
Gemini 2.5 Flash-Litegemini-2.5-flash-lite-preview-06-17低コスト、低レイテンシ
Gemini 2.0 Flashgemini-2.0-flash高速な推論
Text Embeddingtext-embedding-004セマンティック検索、RAG（768 次元）

モデルの詳細については、~/Documents/google-gemini-context/MODELS.md（利用可能な場合）または https://ai.google.dev/gemini-api/docs/models をご確認ください。

メンテナンス

情報が誤っている、または古くなっていると思われる場合：

  1. GitHub の codegen_instructions.md を確認します（常に最新です）
  2. https://ai.google.dev/gemini-api/docs/models でモデル ID を確認します
  3. 古くなったドキュメントをユーザーに知らせます

参照ファイル

場合読むファイル
クエリをドキュメントファイルに対応付ける場合references/topic-index.md
コードを書く前に非推奨のパターンを確認する場合references/deprecated-patterns.md

コメント

Markdown 対応