開発者がNode.jsおよびTypeScriptプロジェクトでGenkitフレームワークを正しく活用するためのガイダンスを提供します。このスキルは、Genkitを使用したAIアプリケーション構築のためのリファレンスドキュメント、一般的なエラーの解決策、コードパターンを提供します。
スキルZIPをダウンロード
Claudeでアップロード
設定 → 機能 → スキル → スキルをアップロードへ移動
オンにして利用開始
テストする
「developing-genkit-js」を使用しています。 Set up a new Genkit project with Google AI provider
期待される結果:
- ソースフォルダー内にaiディレクトリを作成
- genkitと@genkit-ai/google-genaiパッケージをインストール
- genkit()の初期化とgoogleAIプラグインを含むgenkit.tsを作成
- 整理のためにflowsおよびtoolsサブディレクトリを作成
- Dev UIにアクセスできるようpackage.jsonにgenkit:uiスクリプトを追加
- GEMINI_API_KEY環境変数を設定
「developing-genkit-js」を使用しています。 Fix ValidationError when using defineFlow with pre-1.0 imports
期待される結果:
- `import { defineFlow } from "@genkit-ai/flow"`を、aiインスタンス上でフローを定義する方法に置き換え
- `import { genkit } from "@genkit-ai/core"`を`import { genkit } from "genkit"`に置き換え
- `configureGenkit()`を`const ai = genkit({ plugins: [...] })`に置き換え
- `response.text()`メソッドではなく`response.text`プロパティを使用してレスポンステキストにアクセス
- `npx tsc --noEmit`で型チェックを実行し、移行が完了したことを確認
セキュリティ監査
低リスクAll 194 static analyzer findings are false positives. The skill consists entirely of markdown documentation and code examples for the Genkit JS framework. The 176 'external_commands' detections are markdown inline code spans (backtick formatting) showing CLI commands like `genkit --version` and `npx tsc --noEmit`, not actual shell execution. The 'weak cryptographic algorithm' findings have no corresponding crypto operations in the source. The 'hardcoded URL' findings are documentation references (localhost dev UI and example.com placeholder). The 'env_access' finding is documentation instructing users to set API keys. No executable code exists in this skill. Safe to publish.
低リスクの問題 (4)
品質スコア
作れるもの
新しいGenkitプロジェクトのセットアップ
開発者が既存のNode.jsアプリケーションにGenkitを使用してAI機能を追加したい場合、このスキルはディレクトリ構造、パッケージインストール、プラグイン設定、初期フローの作成をガイドします。
Genkit pre-1.0からv1.xへの移行
v1.0リリース前に構築されたGenkitアプリケーションをメンテナンスしているチーム向けに、このスキルは非推奨のAPIを特定し、インポート、モデル参照、フロー定義の移行パターンを提供します。
マルチモーダルAI機能の構築
アプリケーションに画像生成やテキスト読み上げ機能を追加したい製品チーム向けに、このスキルは正しい設定を含むGeminiマルチモーダルモデルの動作例を提供します。
これらのプロンプトを試す
Node.jsプロジェクトにGenkitを使ってAI機能を追加したいです。プロジェクト構造のセットアップ、必要なパッケージのインストール、テキストを生成するシンプルなフローの作成をサポートしてください。
GenkitフローでTypeScriptエラーが発生しています。一般的なエラーリファレンスを確認し、これが非推奨APIの問題なのか、インポートの問題なのかを特定してください。
Zodスキーマを使用して構造化されたJSON出力を返すGenkitフローが必要です。スキーマの定義方法、フローの作成方法、型付けされた出力へのアクセス方法を示してください。
Gemini 2.5 Flash Imageモデルを使用して画像を生成し、部分的な結果をストリーミングするGenkitフローを構築したいです。正しいresponseModalities設定を含め、メディア出力の処理方法についても説明してください。
ベストプラクティス
- Genkit APIはバージョン間で頻繁に変更されるため、内部知識に依存せず、常にGenkit CLI（`genkit docs:search`、`genkit docs:read`）を使用して最新のドキュメントを参照してください。
- APIキーや機密設定は環境変数または.envファイルに保管してください。資格情報をソースファイルにハードコードしたり、バージョン管理システムにコミットしたりしないでください。
- すべての入出力定義には、スタンドアロンの`zod`パッケージではなく`genkit`パッケージのZodスキーマを使用してください。LLMがスキーマフィールドを正しく設定できるよう、`.describe()`アノテーションを追加してください。
回避
- `@genkit-ai/core`、`@genkit-ai/ai`、`@genkit-ai/flow`などの非推奨パッケージからインポートしないでください。コア機能は直接`genkit`パッケージからインポートしてください。
- トラブルシューティング時に一般的なエラーリファレンスの確認をスキップしないでください。多くのエラーは文書化された解決策がある非推奨APIの使用が原因です。
- `gemini-2.0-*`や`gemini-1.5-*`などの廃止されたモデルバージョンを使用しないでください。必ずベストプラクティスリファレンスで指定されている最新世代のモデルを使用してください。