SEO Image Gen: SEO資産向けAI画像生成(拡張機能)

概要

この公開インテークコピーは、https://github.com/sickn33/antigravity-awesome-skills から plugins/antigravity-awesome-skills-claude/skills/seo-image-gen をパッケージ化し、その出所を隠さずにネイティブOmniスキル編集形式に変換しています。

オペレーターがアップストリームワークフロー、サポートファイル、およびリポジトリコンテキストを保持する必要がある場合に使用します。一方、公開バリデーターと非公開エンハンサーは通常のダウンストリームフローを継続します。

このインテークはコピーされたアップストリームファイルをそのまま保持し、metadata.json の external_source ブロックと ORIGIN.md をプロヴナンスアンカーとしてレビュー用に使用します。

SEO Image Gen: SEO資産向けAI画像生成(拡張機能) Geminiの画像生成をbanana Creative Directorパイプライン経由で使用して、SEOユースケース向けの本番対応画像を生成します。SEOニーズを最適化されたドメインモード、アスペクト比、および解像度デフォルトにマッピングします。

公開見出しにきれいにマッピングされなかったインポートされたソースセクションは、以下またはサポートファイルに保持されています。注目すべきインポートセクション:アーキテクチャノート、前提条件、SEO画像ユースケース、生成パイプライン、生成後SEOチェックリスト、コスト認識。

このスキルを使用する場合

このセクションをトリガーフィルターとして使用します。オペレーターがファイルを読み込む、コマンドを実行する、またはプルリクエストを開く前に、アクティベーション境界を明示する必要があります。

• OG画像、ヒーロー画像、スキーマビジュアル、インフォグラフィック、または同様のSEOアセットを生成する場合に使用します。
• 画像生成がより広いSEOまたは公開ワークフローの一部である場合に使用します。
• 必要な画像生成拡張機能が利用可能な場合にのみ使用します。
• リクエストがインポートされたソースの意図と明確に一致する場合に使用します:OGカード、ヒーロー画像、スキーマアセット、製品ビジュアル、インフォグラフィックなどのSEO対応画像を生成します。画像生成がSEOワークフローまたはコンテンツ公開タスクの一部である場合に使用します。
• オペレーターがプロセスをゼロから書き直す代わりにアップストリームワークフロー詳細を保持すべき場合に使用します。
• プロヴナンスが回答、PR、またはレビューパケットに表示されたままである必要がある場合に使用します。

操作テーブル

状況	ここから開始	その理由
初回使用	metadata.json	コピーされたワークフローに触れる前に、external_source ブロック経由でリポジトリ、ブランチ、コミット、およびインポートパスを確認します
プロヴナンスレビュー	ORIGIN.md	インポートされたソースの平易な言語監査証跡をレビュアーに提供します
ワークフロー実行	SKILL.md	実行を実質的に変更する最小のコピーファイルから開始します
サポートコンテキスト	SKILL.md	パッケージ全体を読み込まずに、最も関連性の高い次のコピーされたソースファイルを追加します
ハンドオフ決定	## 関連スキル	タスクが外れた場合にオペレーターがより強力なネイティブスキルに切り替えるのに役立ちます

ワークフロー

このワークフローは意図的に編集および運用の両方です。インポートされたソースをオペレーターにとって有用に保ちながら、ダウンストリームエンハンサーフローに供給される公開インテーク標準を満たします。

1. ユーザーゴール、インポートされたワークフロー範囲、およびこのスキルが依然としてタスクの正しいルーターであるかどうかを確認します。
2. コピーされたアップストリームサポートファイルを読み込む前に、概要とプロヴナンスファイルを読みます。
3. 現在のリクエストの結果を実質的に変更する参照、例、プロンプト、またはスクリプトのみを読み込みます。
4. プロヴナンスおよびソース境界を作業ノートで明示的に保持しながら、アップストリームワークフローを実行します。
5. アップストリーム期待値と、コピーされたファイルで指す証拠に対して結果を検証します。
6. 仕事がこのインポートされたワークフローの重力中心から外れたら、関連スキルにエスカレートまたはハンドオフします。
7. マージまたはクロージャーの前に、何が使用されたか、何が変更されたか、およびレビュアーが依然として検証する必要があるものを記録します。

インポートされたワークフロー注記

インポート: アーキテクチャノート

このスキルには異なる役割を持つ2つのコンポーネントがあります:

• SKILL.md(このファイル):対話的な /seo image-gen コマンドを処理して画像を生成します
• エージェント(agents/seo-image-gen.md):既存のOG/ソーシャル画像を評価し、生成計画を作成する監査のみアナリスト(/seo audit 中にスポーン、自動生成しません)

例

例1: アップストリームワークフローを直接要求する

@seo-image-gen を使用して <task> を処理します。コピーされたアップストリームワークフローから開始し、結果を実質的に変更するファイルのみを読み込み、回答にプロヴナンスを表示してください。

説明: これはオペレーターがインポートされたワークフローを必要としているが、リポジトリ全体ではない場合の最も安全な開始点です。

例2: プロヴナンスベースのレビューをリクエストする

metadata.json と ORIGIN.md に対して @seo-image-gen をレビューし、最初に読み込むコピーされたアップストリームファイルとその理由を説明してください。

説明: レビューまたはトラブルシューティングの前にこれを使用して、出所とファイル選択の正確な監査可能な説明が必要な場合。

例3: 実行前にコピーされたサポートファイルを絞ります

@seo-image-gen を使用して <task> を処理します。結果を実質的に変更するコピーされた参照、例、またはスクリプトのみを読み込み、進行する前にファイルを明示的に名前付けします。

説明: これにより、スキルはデフォルトでコピーされたパッケージ全体を読み込む代わりに段階的な情報開示に合わせて調整されます。

例4: レビュアーパケットを構築する

コピーされたアップストリームファイルとプロヴナンスを使用して @seo-image-gen をレビューし、マージ前のギャップをまとめます。

説明: これはPRがヒューマンレビューを待っており、反復可能な監査パケットが必要な場合に便利です。

ベストプラクティス

生成された公開スキルを、アップストリームリポジトリの周りのレビュー可能なパッケージングレイヤーとして扱います。目標は、プロヴナンスを明示的に保持し、実行を実質的に改善するコピーされたソース資料のみを読み込むことです。

• インポートされたスキルをアップストリームリポジトリに根付かせます。ソース資料がサポートできないステップを発明しないでください。
• ワークフローが監査可能で、レビューが高速に行えるよう、最小限の有用なサポートファイルセットを優先します。
• プロヴナンス、ソースコミット、およびインポートされたファイルパスをノートとPR説明に表示してください。
• 汎用レビューボイラープレートに依存する代わりに、ワークフローを正当化するコピーされたアップストリームファイルを直接指します。
• 生成された例をスキャフォルディングとして扱います。実行前に具体的なタスクに適合させます。
• アーキテクチャ、デバッグ、設計、またはセキュリティの懸念が支配的になったら、より強力なネイティブスキルにルーティングします。

トラブルシューティング

問題: オペレーターがインポートされたコンテキストをスキップし、あまりに一般的に回答した

症状: 結果が plugins/antigravity-awesome-skills-claude/skills/seo-image-gen のアップストリームワークフローを無視し、プロヴナンスに言及せず、コピーされたソースファイルをまったく使用していません。 解決策: metadata.json、ORIGIN.md、および最も関連性の高いコピーされたアップストリームファイルを再度開きます。最初に external_source ブロックを確認し、その後継続する前にプロヴナンスを再度述べます。

問題: インポートされたワークフローがレビュー中に不完全に感じられる

症状: レビュアーは生成された SKILL.md を見ることができますが、現在のタスクにどの参照、例、またはスクリプトが重要かをすぐに判断できません。 解決策: 採用したパスを正当化する正確なコピーされた参照、例、スクリプト、またはアセットを指します。ギャップが依然として真実である場合は、隠すのではなくPRに記録します。

問題: タスクが別の専門化に外れた

症状: インポートされたスキルは正しい場所で開始しますが、仕事がネイティブスキルがより適切に処理するデバッグ、アーキテクチャ、設計、セキュリティ、またはリリースオーケストレーションに変わります。 解決策: 関連スキルセクションを使用して意図的にハンドオフします。インポートされたプロヴナンスを表示したままにして、次のスキルが盲目的に開始する代わりに正しいコンテキストを継承します。

関連スキル

• @00-andruia-consultant - このインポートされたスキルがコンテキストを確立した後、仕事がそのネイティブ専門化により適切に処理される場合に使用します。
• @00-andruia-consultant-v2 - このインポートされたスキルがコンテキストを確立した後、仕事がそのネイティブ専門化により適切に処理される場合に使用します。
• @10-andruia-skill-smith - このインポートされたスキルがコンテキストを確立した後、仕事がそのネイティブ専門化により適切に処理される場合に使用します。
• @10-andruia-skill-smith-v2 - このインポートされたスキルがコンテキストを確立した後、仕事がそのネイティブ専門化により適切に処理される場合に使用します。

追加リソース

このサポートマトリックスと以下のリンクファイルをこのインポートされたスキルのオペレーターパケットとして使用します。それらは汎用スキャフォルディングではなく、実際のコピーされたソース資料を反映する必要があります。

リソース族	レビュアーに提供する内容	パス例
references	アップストリームからコピーされた参照ノート、ガイド、または背景資料	references/n/a
examples	アップストリームからコピーされた実行例または再利用可能なプロンプト	examples/n/a
scripts	実行または検証を変更するアップストリームヘルパースクリプト	scripts/n/a
agents	インポートされたパッケージの一部である真正のルーティングまたはデリゲーションノート	agents/n/a
assets	ソースパッケージからコピーされたサポートアセットまたはスキーマ	assets/n/a

インポートされた参照ノート

インポート: クイックリファレンス

コマンド	機能
/seo image-gen og <description>	OG/ソーシャルプレビュー画像を生成(1200x630相当)
/seo image-gen hero <description>	ブログヒーロー画像を生成(ワイドスクリーン、ドラマティック)
/seo image-gen product <description>	製品写真を生成(クリーン、白背景)
/seo image-gen infographic <description>	インフォグラフィックビジュアルを生成(垂直、データ密集型)
/seo image-gen custom <description>	Creative Directorパイプライン全体を使用してカスタム画像を生成
/seo image-gen batch <description> [N]	N個のバリエーション(デフォルト: 3)を生成

インポート: リファレンスドキュメント

オンデマンドで読み込みます。スタートアップで全読み込みしないでください:

• references/prompt-engineering.md:6コンポーネントシステム、ドメインモード、テンプレート
• references/gemini-models.md:モデル仕様、レート制限、機能
• references/mcp-tools.md:MCPツールパラメータと応答
• references/post-processing.md:ImageMagick/FFmpegパイプラインレシピ
• references/cost-tracking.md:価格設定、使用追跡
• references/presets.md:ブランドプリセット管理
• references/seo-image-presets.md:SEO固有プリセットテンプレート

インポート: 前提条件

このスキルではbanana拡張機能をインストールする必要があります:

./extensions/banana/install.sh

可用性を確認: 画像生成ツールを使用する前に、gemini_generate_image または set_aspect_ratio ツールが利用可能かどうかを確認して、MCPサーバーが接続されていることを確認します。ツールが利用できない場合は、拡張機能がインストールされていないことをユーザーに通知し、インストール指示を提供します。

インポート: SEO画像ユースケース

各ユースケースは事前設定済みのbananaパラメータにマッピングされます:

ユースケース	アスペクト比	解像度	ドメインモード	注記
OG/ソーシャルプレビュー	16:9	1K	ProductまたはUI/Web	クリーン、プロフェッショナル、テキストフレンドリー
ブログヒーロー	16:9	2K	CinemaまたはEditorial	ドラマティック、大気的、編集品質
スキーマ画像	4:3	1K	Product	クリーン、説明的、スキーマImageObject
ソーシャルスクエア	1:1	1K	UI/Web	プラットフォーム最適化スクエア
製品写真	4:3	2K	Product	白背景、スタジオライティング
インフォグラフィック	2:3	4K	Infographic	データ密集型、垂直レイアウト
ファビコン/アイコン	1:1	512	Logo	ミニマル、スケーラブル、認識可能
Pinterestピン	2:3	2K	Editorial	高い垂直カード

インポート: 生成パイプライン

すべての生成リクエスト:

1. ユースケースを特定 します(コマンドまたはコンテキストからog、hero、productなど)
2. SEOデフォルトを適用 します(上記のユースケーステーブルから)
3. アスペクト比を設定 します(MCPツール set_aspect_ratio 経由)
4. Reasoning Briefを構築 します(banana Creative Directorパイプライン使用):
   • references/prompt-engineering.md を読み込んで6コンポーネントシステムの説明を確認
   • ドメインモード重点を適用(被写体30%、スタイル25%、コンテキスト15%など)
   • 具体的でビスセラルに:カメラが見えるものを説明
5. 生成 します(gemini_generate_image MCPツール経由)
6. 生成後SEOチェックリスト を実施します(以下参照)

プリセットを確認

ユーザーがブランドを言及するか、SEOプリセットが設定されている場合:

python3 ~/.claude/skills/seo-image-gen/scripts/presets.py list

マッチするプリセットを読み込み、デフォルトとして適用します。また references/seo-image-presets.md でSEO固有のプリセットテンプレートを確認してください。

インポート: 生成後SEOチェックリスト

成功した生成後は常に、ユーザーに以下をガイドします:

1. 代替テキスト: 生成された画像の説明的なキーワードリッチなalt textを作成
2. ファイル名: SEOフレンドリーフォーマットに変更:keyword-description-widthxheight.webp
3. WebP変換: ページ速度最適化のためWebPに変換:

   magick output.png -quality 85 output.webp
   

4. ファイルサイズ: ヒーロー画像では200KB未満、サムネイルでは100KB未満を目標
5. スキーママークアップ: 生成された画像の ImageObject スキーマを提案:

   {
     "@type": "ImageObject",
     "url": "https://example.com/images/keyword-description.webp",
     "width": 1200,
     "height": 630,
     "caption": "ターゲットキーワード付き説明キャプション"
   }
   

6. OGメタタグ: ソーシャルプレビュー画像の場合、以下を思い出させます:

   <meta property="og:image" content="https://example.com/images/og-image.webp" />
   <meta property="og:image:width" content="1200" />
   <meta property="og:image:height" content="630" />
   <meta property="og:image:alt" content="説明的なalt text" />
   

インポート: コスト認識

画像生成にはお金がかかります。透明性を保ちます:

• 生成前に推定コストを表示(特にバッチの場合)
• すべての生成をログ:python3 ~/.claude/skills/seo-image-gen/scripts/cost_tracker.py log --model MODEL --resolution RES --prompt "brief"
• ユーザーが使用状況を質問した場合は cost_tracker.py summary を実行

概算コスト(gemini-3.1-flash):

• 512: 約$0.02/画像
• 1K解像度: 約$0.04/画像
• 2K解像度: 約$0.08/画像
• 4K解像度: 約$0.16/画像

インポート: モデルルーティング

シナリオ	モデル	理由
OG画像、ソーシャルプレビュー	gemini-3.1-flash-image-preview @ 1K	高速、コスト効果的
ヒーロー画像、製品写真	gemini-3.1-flash-image-preview @ 2K	品質+詳細
テキスト付きインフォグラフィック	gemini-3.1-flash-image-preview @ 2K、thinking: high	テキストレンダリング改善
クイックドラフト	gemini-2.5-flash-image @ 512	迅速な反復

インポート: エラーハンドリング

エラー	解決方法
MCPが設定されていない	./extensions/banana/install.sh を実行
APIキーが無効	https://aistudio.google.com/apikey で新しいキーを取得
レート制限(429)	60秒待ってから再試行。無料層: ~10 RPM / ~500 RPD
IMAGE_SAFETY	プロンプトを言い換え - references/prompt-engineering.md セーフティセクション参照
MCPが利用不可	フォールバック:python3 ~/.claude/skills/seo-image-gen/scripts/generate.py --prompt "..." --aspect-ratio "16:9"
拡張機能がインストールされていない	インストール指示を表示:./extensions/banana/install.sh

インポート: クロススキル統合

• seo-images(分析)はseo-image-gen(生成)に供給: /seo images の監査結果は不足または低品質の画像を特定し、それらの発見を使用して /seo image-gen コマンドを駆動します
• seo-audit は seo-image-gen エージェント(このスキルではない)をスポーンしてOG/ソーシャル画像をサイト全体で分析し、優先度付き生成計画を作成します
• seo-schema は生成された画像を消費できます:生成後、新しいアセットを指す ImageObject スキーママークアップを提案します

インポート: レスポンス形式

生成後は常に以下を提供します:

1. 画像パス: 保存された場所
2. 作成されたプロンプト: APIに送信されたものを表示(教育目的)
3. 設定: モデル、アスペクト比、解像度
4. SEOチェックリスト: alt textの提案、ファイル命名、WebP変換
5. スキーマスニペット: 該当する場合はImageObjectまたはog:imageマークアップ

インポート: 制限事項

• このスキルは、タスクが上記で説明されたスコープと明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家レビューの代替として扱わないでください。
• 必要な入力、権限、セーフティ境界、または成功基準が欠落している場合は、停止して明確化を求めます。