mcpField
S
Skywork Design

Skywork Design

github.com/skyworkaiクリエイティブ・メディア207351 回インストール30 週間前に更新
リポジトリ

Skywork Design について

Skywork Designは、バックエンド画像APIを使って画像を生成・編集するスキルです。参照画像、複数のアスペクト比と解像度、用途別ガイドに対応し、SKYWORK_API_KEYが必要です。

主な機能

  1. 01プロンプトから画像を生成
  2. 02既存画像の編集
  3. 03複数の参照画像の利用
  4. 04アスペクト比と解像度の選択
  5. 05ポスターやブランディングなどの用途別ガイド

活用シーン

  1. 01説明文からイラスト、ポスター、インフォグラフィックを作成
  2. 02既存画像のスタイルや色を変更
  3. 03参照画像のビジュアルスタイルを組み合わせ

インストール

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

$npx skills add https://github.com/skyworkai/skywork-skills --skill skywork-design

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
apikey-fetch.md
scenarios/
poster.md
social-media.md
storyboard.md
branding.md
e-commerce.md
infographic.md
brochure.md
logo.md
scripts/
constant.py
skywork_auth.py
generate_image.py

詳細

ビジュアルデザイン — 画像の生成と編集

バックエンドの画像 API を使って、新しい画像を生成したり、既存の画像を編集したりできます。 画像の生成には毎回約 2 分かかりますので、しばらくお待ちください。

前提条件

API キーの設定（最初に必須）

このスキルを利用するには、OpenClaw で SKYWORK_API_KEY を設定する必要があります。

まだ API キーをお持ちでない場合は、こちらをご覧ください： https://skywork.ai

詳しい設定手順は、こちらをご覧ください： references/apikey-fetch.md

使い方

絶対パスを使ってスクリプトを実行してください（スキルディレクトリに cd しないでください）。

新しい画像を生成：

python3 <SKILL_DIR>/scripts/generate_image.py --prompt "description" --filename "output.png" [--aspect-ratio 3:4] [--resolution 1K|2K|4K]

既存の画像を編集：

python3 <SKILL_DIR>/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" --input-image "source.png" [--aspect-ratio 3:4] [--resolution 2K]

複数の参照画像を使って編集：

python3 <SKILL_DIR>/scripts/generate_image.py --prompt "combine these styles" --filename "output.png" -i "ref1.png" -i "ref2.png"

画像がユーザーの作業ディレクトリに保存されるよう、必ずそのディレクトリから実行してください。

生成と編集の使い分け

  • 生成（--prompt のみ）：ポスター、ロゴ、イラスト、写真、インフォグラフィックなど、新しい画像を一から作成します。
  • 編集（--prompt + --input-image）：ユーザーが既存の画像を提供し、変更を希望する場合に使用します。スタイルの変更、要素の追加・削除、色の調整、形式の変換などが可能です。
    • 注意：編集 API では、1 つのワークフローで最大 4 人のキャラクターの類似性と、最大 10 個のオブジェクトの忠実度に対応しています。

ユーザーが画像をアップロードまたは参照し、変更を希望する場合は、必ず --input-image を使用してください。

解像度

  • 1K — 約 1024px、高速な下書き向け
  • 2K（デフォルト）— 約 2048px、ほとんどの成果物に適しています
  • 4K — 約 4096px、最終的な高解像度出力向け

ユーザーの指定に応じて、次のように設定します：「low/draft」→ 1K、「normal/medium/2K」→ 2K、「high-res/hi-res/4K/ultra」→ 4K。

アスペクト比

対応する比率：1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。

選択の目安：

  • 1:1 — ソーシャルメディアのアバター、アイコン、アルバムカバー
  • 3:4 / 4:3 — 一般的なポスター、プレゼンテーション
  • 4:5 / 5:4 — Instagram の投稿、ポートレート
  • 9:16 / 16:9 — モバイルストーリー／デスクトップの壁紙、動画カバー
  • 2:3 / 3:2 — 印刷用ポスター、ブックカバー
  • 21:9 — ウルトラワイドバナー、シネマ形式

ユーザーが指定しない場合は、--aspect-ratio を省略し、API に任せてください。

ファイル名の規則

形式：yyyy-mm-dd-hh-mm-ss-descriptive-name.png

例：

  • 「穏やかな日本庭園」→ 2026-03-10-14-23-05-japanese-garden.png
  • 「山々に沈む夕日」→ 2026-03-10-15-30-12-sunset-mountains.png
  • 文脈が不明な場合 → 2026-03-10-17-12-48-x9k2.png

実行前の確認

  • command -v python3（存在する必要があります）
  • 編集する場合：各 --input-image ファイルが存在することを確認してください

よくあるエラー

  • Error: Input image not found: → パスが間違っています。--input-image ファイルが存在することを確認してください
  • HTTP error 500 → バックエンドサービスのエラーです。再試行するか、サーバーの状態を確認してください
  • Request failed: Connection refused → バックエンドサービスを利用できません。サービスが起動していることを確認してください
  • 特典の不足：スクリプトやログに Insufficient benefit. Please upgrade your account at {url} のようなメッセージが表示される場合があります。これは、ユーザーの特典レベルがこのスキルの要件を満たしていないことを意味します。
特典が不足している場合の返信方法

上記を検出した場合は、ユーザーが現在使っている言語で返信してください。英語のメッセージをそのまま繰り返さないでください。次の形式を使います。

  • 「申し訳ありません。画像の生成に失敗しました。このスキルを利用するには、Skywork のメンバーシップをアップグレードする必要があります」という内容を伝え、行動を促すリンクを 1 つだけ付けます。
  • 形式：ユーザーの言語で短い文を 1 つ + [今すぐアップグレード →](url) またはその言語での同等のリンク。
  • URL：ログまたはスクリプトの出力からアップグレード URL を抽出します（例：at https://... の部分）。

注：アップグレードを提案するのは、エラーが Insufficient benefit の場合に限ります。NO_TOKEN／INVALID_TOKEN／401／「invalid API key」などの認証エラーの場合は、エラーコード／生のメッセージをそのまま伝え、SKYWORK_API_KEY を更新するよう案内してください。メンバーシップのアップグレードは提案しないでください。

出力

  • スクリプトはローカルファイルのパスと OSS URL を出力します。
  • プラットフォームに応じて、画像を最適な方法で配信してください（例：画像メッセージとして送信する、インラインで表示する、URL を出力する）。デフォルトでは、ローカルパスと OSS URL の両方をユーザーに返します。OSS URL により、プラットフォームを問わずアクセスできます。

デザインシナリオ

ユーザーのリクエストに合ったシナリオを選び、専門的なワークフローについては対応するファイルを参照してください。

プロンプトエンジニアリング

プロンプト作成のベストプラクティス

画像 API を使って画像を生成または編集する際、質の高いプロンプトを作成するために、次の原則に従ってください。

  • キーワードを並べるのではなく、シーンを描写してください。 つながりのない単語よりも、物語性のある描写的な段落のほうが、はるかに良い結果が得られます。モデルの強みは、高度な言語理解にあります。
    • 弱い例：「猫、夕日、ビーチ」
    • 良い例：「ゴールデンアワーの砂浜に座り、カメラを向いている茶トラ猫。柔らかく暖かな逆光で照らされ、被写界深度は浅く、背景の海の波はぼけている」
  • できるだけ具体的にしてください。 詳細を多く指定するほど、出力を細かく制御できます。スタイル、色、構図、照明、背景、質感など、視覚的な要素をすべて含めてください。
  • 背景や意図を伝えてください。 画像の目的を説明してください。文脈に対するモデルの理解は、出力に影響します。
  • 複雑で要素の多いシーンには、段階的な指示を使ってください。 プロンプトを前景、中景、背景のレイヤーに分けてください。
  • 「意味的なネガティブプロンプト」を使ってください。 「車がない」ではなく、「交通の気配がない、無人の閑散とした通り」のように肯定的に描写してください。
  • カメラを指定してください。 「広角撮影」「マクロ撮影」「ローアングル」「鳥瞰図」「三分割法」「浅い被写界深度」など、写真や映画で使われる用語を使ってください。
  • 時間の認識を指定してください。 結果にリアルタイム性が必要な場合は、プロンプトに現在の時間に関する文脈を含めてください。
  • 画像内のテキスト。 テキストの内容は二重引用符で囲んでください。

    上部に大きな銀色のメタリックな文字でタイトル「INCEPTION」が入った映画ポスター

  • 変更が必要な要素を明確に指定し、強調してください。参照画像はファイル名ではなく、順番（1 枚目、2 枚目）で説明してください。

コメント

Markdown 対応