Communitygithub.com

haoyiyin/mflux-cover

AI を活用したカバー画像生成スキル — mflux で背景を描き、HTML/CSS + Playwright でシャープなテキストをオーバーレイします。Apple Silicon 上で完全ローカル動作。

mflux-cover とは?

**haoyiyin/mflux-cover** は、AI エージェント(Claude Code、Cursor、Codex など)向けのカバー画像生成スキルです。ユーザーが「カバー画像を生成して」「サムネイルを作成して」「バナーをデザインして」などとリクエストした際に起動します。このスキルは2段階のパイプラインで動作します。まず mflux(FLUX.2 4ビット、Apple MLX)がプロンプトから背景画像を生成し、次に HTML/CSS + Playwright Chromium がその上にシャープなテキスト(タイトルなど)をレンダリングします。Apple Silicon(M1+)必須、16 GB 以上の RAM 推奨。初回のみ FLUX.2 モデル(2~4 GB)をダウンロードしますが、以降は完全オフラインで動作します。YouTube サムネイル、ブログカバー、SNS バナーなど、プリセット寸法が豊富に用意されており、レイアウトやグラデーションもカスタマイズ可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add haoyiyin/mflux-cover

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

使用するタイミング

ユーザーがテキスト説明からカバー画像、サムネイル、バナー、ポスター、ヘッダーを生成するよう依頼した場合に使用します。トリガーとなるリクエスト例:「カバーを生成して」「サムネイルを作成して」「バナーを作って」「設計封面」「生成封面図」など、指定寸法で画像を生成するよう求めるもの全般。

このスキルは2段階のパイプラインを使用します:

  1. mflux(FLUX.2 4ビット、Apple MLX)が AI 背景画像を生成
  2. HTML/CSS + Playwright Chromium が上にシャープなテキストをレンダリング

テキストオーバーレイのない一般的な画像生成、画像編集、アップスケーリング、カバー以外の用途には使用しないでください。

要件

  • macOS かつ Apple Silicon(M1+)
  • 16 GB 以上の RAM 推奨(8 GB でも解像度を下げれば動作する場合あり)
  • mflux:brew install uv && uv tool install mflux
  • Playwright:pip install playwright && playwright install chromium
  • 初回実行時に FLUX.2 モデル(約2~4 GB)をダウンロード。その後は完全オフライン

手順

  1. 前提条件の確認:python3 cover_generator.py --detect — mflux と Playwright+Chromium の両方に ✓ が表示されることを確認
  2. 寸法の決定:プリセットまたは正確な W×H を指定:
    • youtube-thumbnail(1280×720)、twitter-header(1500×500)、blog-cover(1200×630)
    • instagram-post(1080×1080)、facebook-cover(1640×624)、linkedin-banner(1584×396)
    • podcast-cover(3000×3000)、github-social(1280×640)、story(1080×1920)
  3. レイアウトの選択:--layout bottom(デフォルト)、centered、hero、top
  4. グラデーションの選択:--gradient dark(デフォルト)、subtle、light、none
  5. 生成:python3 cover_generator.py -p "説明文" --preset blog-cover
  6. プロンプトの最適化:--prompt(AI背景)には英語を使用し、--title(表示テキスト)には元の言語をそのまま使用
  7. 確認:出力ファイルが存在し、寸法が正しいことを確認

落とし穴

  • mflux は Apple Silicon(M1+)必須 — Intel Mac では実行不可
  • Playwright は Chromium を別途インストール(約300 MB のダウンロード)
  • 初回の mflux 実行で FLUX.2 モデル(約2~4 GB)をダウンロード。以降はオフライン
  • AI プロンプトに中国語テキストを使用すると背景品質が低下する可能性あり — --prompt には英語を使用し、--title に表示する中国語テキストを指定
  • 非常に大きな寸法(3840 px 超)は処理が遅くなる可能性あり。A4 印刷(3508 px)の場合、レンダリングに3~5秒を見込む
  • プロンプトの質が背景に大きく影響:スタイルを具体的に指定する(例:「ミニマルな水彩画」「ダークシネマティック」「クリーンな抽象グラデーション」)
  • mflux は寸法を64の倍数に丸めるため、背景画像は要求よりわずかに小さくなる場合あり。最終的なオーバーレイ処理で正確な寸法に補正

確認

  1. python3 cover_generator.py --detect — mflux ✓、Playwright+Chromium ✓
  2. パイプライン全体のテスト:python3 cover_generator.py -p 'A serene mountain lake at dawn' -o test.png
  3. 出力寸法が入力と一致することを確認
  4. 生モードテスト:python3 cover_generator.py -p 'test' --preset youtube-thumbnail --no-overlay -o raw.png

関連スキル