mcpField
P
punk-avatar

punk-avatar

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

punk-avatar について

punk-avatarは、人物、ペット、物のアバター画像プロンプトを作るワークフロースキルです。限られたスタイル群から一つを選び、被写体やトリミング、背景の要件を統合します。

主な機能

  1. 01限定カタログからスタイルを一つ選択
  2. 02人物、ペット、物を識別
  3. 03画像またはテキスト説明に対応
  4. 04既定の縦横比は1:1
  5. 05本人らしさ、構図、トリミングを統合

活用シーン

  1. 01人物写真をスタイル化したアバターに変換
  2. 02ペットのアバターや記念カードを作成
  3. 03説明文から架空のアバターを生成

インストール

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

$npx skills add https://github.com/adrianpunk/punk-skill --skill punk-avatar

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

同梱ファイル

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

agents/
openai.yaml
references/
avatar-prompt-blueprint.md
style-catalog.md

詳細

パンクアバター

基本ルール

punk-avatar はアバターの形状に関するワークフローであり、スタイルを決めるものではありません。リポジトリレベルの styles/ ライブラリから再利用可能なスタイルを1つだけ選び、そのスタイルの要素をアバターの形状に適用してください。

最終的な画像プロンプトは、「アバターの指示+スタイルの指示」を単純につなぎ合わせたものではありません。選択したスタイルを、プロフィール画像、ポートレートアバター、オブジェクトアバター、ペットアバター、またはアバターをもとにした記念カードに適用する、アバター専用の統合プロンプトにする必要があります。

入力は次の3つです。

  1. punk-avatar のタスクフィールド:被写体の種類、元画像またはテキストによる説明、用途、似せ方の方針、アバターの構図、アスペクト比、背景の簡略化、トリミング時の安全性、全般的な出力制約。
  2. 選択したスタイルの META.md メタデータと、再利用可能なビジュアルスタイル要素を定義する STYLE.md。
  3. アバタープロンプトの全体的な形式を定義する references/avatar-prompt-blueprint.md。

スタイルファイルは、再利用可能なビジュアル表現を定義します。アバターの設計図は、出力形式を定義します。最終プロンプトでは、両者を統合して、アバター生成用の完全なプロンプトにする必要があります。

リソース

  • アバタースタイルを一覧表示または選択するには、references/style-catalog.md を読みます。
  • 最終プロンプトを作成する前に、references/avatar-prompt-blueprint.md を読みます。
  • 選択したスタイルについて、次の両方を読みます。
    • ../../styles/{style-id}/META.md
    • ../../styles/{style-id}/STYLE.md
  • punk-avatar のメニューには、次の7つのスタイルのみを表示します。
    • pixel-avatar
    • grotesque-soul-sketch
    • messy-crayon-pet-portrait
    • fashion-sketch-observation
    • polaroid-keepsake
    • minimal-paper-acrylic-block-illustration
    • surreal-pop-up-paper-landscape
  • surreal-pop-up-paper-landscape には2つの出力モードがあります。META.md と STYLE.md を読んだあと、ユーザーが選択したモードのリファレンスを1つだけ読みます。
    • ../../styles/surreal-pop-up-paper-landscape/references/before-after.md
    • ../../styles/surreal-pop-up-paper-landscape/references/final-artwork.md
  • punk-avatar のメニューに、カバーやポスターのスタイルを表示しないでください。
  • アバターの処理では、punk-cover のリファレンスやテンプレートを読まないでください。

ワークフロー

  1. 元の素材を分析します。

    • ユーザーが1枚以上の画像を提供した場合は、画像を主要な入力として扱います。
    • 主な被写体の種類を特定します。person、pet、object、unclear のいずれかです。
    • アバターに必要な簡潔な視覚的特徴のみを抽出します。顔や頭の形、髪や毛並み、目、表情、姿勢、特徴的な色、服装、アクセサリー、物体のシルエット、必ず残すべき模様などです。
    • テキストは補足情報として使います。名前、気質、用途、希望する背景色、残す要素、避ける要素などです。
    • 画像がなく、ユーザーが架空のアバターを説明している場合は、説明に基づいて生成します。実在する写真に似せると約束してはいけません。
  2. アスペクト比を決定します。

    • punk-avatar 内では、常にデフォルトの比率を 1:1 とします。
    • ユーザーが 3:4、4:5、16:9、または任意のカスタム比率を指定した場合は、ユーザーの指定をそのまま維持します。
    • 選択したスタイルのメタデータにある default_ratio を、アバターのデフォルトとして使用しないでください。
    • polaroid-keepsake では、punk-avatar 内のデフォルトを 1:1 とします。ユーザーが縦向きの比率を明示的に求めた場合に限り、縦向きのポラロイドカードを生成します。
    • surreal-pop-up-paper-landscape では、ユーザーが比率を指定しない場合、before-after モードには 3:2 を、final-artwork モードには 3:4 を使用します。ユーザーが比率を指定した場合は、その指定をそのまま維持します。
    • ユーザーが比率を指定しなかった場合、比率について質問しないでください。
  3. プロンプトを生成する前に、スタイルを確認します。

    • ユーザーがカタログスタイルを指定している場合は、それを使用します。
    • ユーザーが、极简纸感丙烯色块插画 または 立体人物扁平景色纸艺 のブリーフを含む、カタログスタイルに合致したビジュアルの方向性をすべて提示している場合は、そのスタイルが指定されたものとして扱い、スタイルアトムを使用します。ユーザーにスタイルを再度指定するよう求めないでください。
    • スタイルが指定されていない場合は、被写体の種類に基づいて適切なスタイルを2〜3個提案し、ユーザーに選択を求めます。
    • スタイルが未指定の場合は、質問した時点で停止します。スタイルファイルへの入力、プロンプトファイルの保存、画像の生成は行わないでください。
    • ユーザーがすべてを自動で決定するよう明示的に指定した場合に限り、スタイルを自動選択します。
    • surreal-pop-up-paper-landscape の場合は、出力モードも確認します。前后对比图、对比图、before/after、comparison の指定は before-after に、效果图、单张效果图、成品图、final artwork、single image の指定は final-artwork に対応させます。
    • ユーザーが surreal-pop-up-paper-landscape を選択し、モードを指定していない場合は、2つのモードのどちらを使用するかだけを尋ね、その時点で停止します。ユーザーが両方を明示的にリクエストしない限り、両方を生成しないでください。
  4. 推薦ルール:

    • ペットが被写体の場合は、凌乱蜡笔宠物肖像、拍立得纪念卡、怪诞灵魂手绘 を推薦します。アイコン風のアバターが合いそうな場合は、像素头像 も含めます。
    • 人物が被写体の場合は、怪诞灵魂手绘、时尚速写观察页、像素头像 を推薦します。
    • 物体が被写体の場合、または被写体が不明な場合は、まず 像素头像 を推薦します。
    • 小さな象徴的な被写体、ざらつきのある白い紙、透明感のあるアクリルブロック、大きな余白が必要な写真やテーマには、极简纸感丙烯色块插画 を推薦します。
    • 周囲の情景が認識できる人物写真を、平坦化した紙の風景から立ち上がる写実的な直立人物にしたい場合は、立体人物扁平景色纸艺 を推薦します。
    • 人物には messy-crayon-pet-portrait を推薦しないでください。
    • ユーザーが明示的にそのスタイルを求めない限り、ペットや物体には fashion-sketch-observation を推薦しないでください。
    • 人物や物体には polaroid-keepsake を推薦しないでください。
  5. 次の確認手順に従います。

    • スタイルが未指定の場合:スタイルの選択を尋ね、その時点で停止します。
    • 比率が未指定の場合:ステップ2で解決したデフォルトを、確認なしで使用します。
    • スタイルが判明している場合:質問せずに続行します。
    • surreal-pop-up-paper-landscape でモードが未指定の場合:前后对比图 または 单张效果图 のどちらにするかを尋ね、その時点で停止します。
    • スタイルと被写体が判明しており、進行に十分な情報がそろっている場合は、プロンプトを作成します。
  6. 最終的な画像プロンプトをまとめます:

    • references/avatar-prompt-blueprint.md を、prompts/avatar.md の必須構成として使用してください。
    • ../../styles/{style-id}/STYLE.md から、選択したスタイルのビジュアル要素をちょうど1つ読み取ってください。
    • 選択したスタイルのメタデータを ../../styles/{style-id}/META.md から読み取ってください。
    • surreal-pop-up-paper-landscape の場合は、選択したモードのリファレンスをちょうど1つ読み取り、プロンプトに反映してください。モードのリファレンスは、結果を並列比較にするか、単独のアートワークにするかを決定します。この2つの出力仕様を混在させないでください。
    • 選択したスタイルの譲れない視覚的要素を抽出してください。対象の表現方法、構図、背景の扱い、線やテクスチャの表現方法、配色の考え方、タイポグラフィや手書き文字の扱い、似姿に関する制約、禁止事項が含まれます。
    • アバターのタスク項目とスタイルの要素を組み合わせ、完全なアバタープロンプトを作成してください。最終プロンプトは、無関係なプロンプトの断片を2つ貼り合わせたものではなく、アバター生成のための完成された指示書として読める内容にしてください。
    • 役割/タスク、入力項目、ソースの解釈、対象のアイデンティティ、似姿の方針、アバターの構図、トリミング時の安全性、背景、スタイルの適用、色/素材/テクスチャ、任意のテキスト/名前の扱い、禁止事項、最終基準の各セクションを含めてください。
    • STYLE.md の内容を独立した第2セクションとして、そのまま追加しないでください。スタイルの要素をアバターの設計図に合わせて書き換え、適用してください。
    • 複数のスタイルを組み合わせたり、独自のスタイルセクションを追加したりしないでください。
    • 選択したスタイルファイル内に明示されたプレースホルダーは、すべて置換または解決してください。
    • 画像を入力に使う場合は、選択したスタイルが写実的な構造を必要とする場合を除き、写実的なコピーを作成せずに、対象が見分けられるアイデンティティを保ってください。
    • テキストのみで指定された架空のアバターの場合は、画像が説明に従うよう指示し、「写真の似姿を保つ」といった表現は避けてください。
    • 表紙タイトルの階層、記事の要約、プラットフォームへの展開ルール、ソーシャルメディア用カバーの構図をアバタープロンプトに含めないでください。
    • 最終プロンプトに分析を含めないでください。
  7. 画像生成の前にファイルを保存します:

    • 完成したプロンプトを punk-assets/punk-avatar/{slug}/prompts/avatar.md に作成してください。
    • 現在の実行に対して画像生成から明示的なローカルファイルパス、ダウンロード可能なURL、または画像バイト列が返された場合は、そのアーティファクトを punk-assets/punk-avatar/{slug}/avatar.png に保存してください。
    • 生成画像のディレクトリを広範囲に走査して、該当するアーティファクトを推測しないでください。他の実行で生成された無関係な画像が含まれている可能性があります。
    • 画像生成ツールが、現在の実行から取得可能なアーティファクトを返さず、インラインプレビューのみを返す場合は、偽の avatar.png を作成しないでください。
  8. プロンプトを保存した後、利用可能な画像生成ツール(image_gen など)があれば、デフォルトで画像を生成してください。インラインプレビューの生成は画像生成の成功として扱いますが、ローカルの avatar.png の保存は、ツールが現在の実行に対するアーティファクトを明示的に提供した場合にのみ成功として扱ってください。ユーザーがプロンプトのみを明示的に求めている場合、または現在の環境に画像生成ツールがない場合に限り、画像生成を省略してください。画像生成が利用できない場合は、プロンプトファイルのパスとプロンプト全文を返してください。

最初の応答形式

スタイルが指定されていない入力には、簡潔に次のように尋ねてください:

默认画幅:1:1。

请选择一个头像风格:
- `风格 A`:reason tied to the subject.
- `风格 B`:reason tied to the subject.
- `风格 C`:reason tied to the subject.

也可以回复 "auto" 让我自动选择。

ユーザーが比率の選択肢を明示的に求めていない限り、比率について尋ねないでください。

スタイル選択のヒューリスティクス

  • 人物、ペット、物、象徴的なアバター、アイコン風のプロフィール画像、対象が不明瞭な場合は、pixel-avatar を使用します。
  • 表情豊かで、ユーモラスなスケッチ風の、個性が感じられる人物やペットには、grotesque-soul-sketch を使用します。
  • messy-crayon-pet-portrait は、ペットとペットのポートレートアバターに限って使用します。
  • fashion-sketch-observation は人物に限って使用します。特に、ファッション、旅行、ストリートフォト、映画のワンシーン風、エディトリアルな人物ポートレートに適しています。
  • polaroid-keepsake はペットに限って使用します。特に、追悼用、コレクション用、名前入りのペットカード、アバターをもとにした記念カードに適しています。
  • シンプルな紙の質感、鮮やかなアクリル絵の具の色面、とても小さな被写体が必要な人物、ペット、物、風景、テーマには、minimal-paper-acrylic-block-illustration を使用します。
  • 実在の人物は直立した写実的な姿のままにしつつ、撮影された環境を浅い紙の立体風景へと折り畳む必要がある、画像ベースの人物ポートレートには、surreal-pop-up-paper-landscape を使用します。

アバタープロンプトの設計図

プロンプトの全体構成には、references/avatar-prompt-blueprint.md を使用します。以下のブロックは、最終的に統合されたプロンプトに含める必要がある、必須のタスクフィールドの内容としてのみ記載しています。

# punk-avatar task instructions

Create one single avatar image. Aspect ratio: {ratio}.

Use the following derived subject fields only:
- Subject type: {subject_type}
- Generation mode: {image_based_or_description_based}
- Subject identity: {subject_identity}
- Recognizable traits: {recognizable_traits}
- Name or text to include: {name_or_text}
- Intended use: {use_case}
- Background preference: {background_preference}
- Mood: {mood}
- Preserve: {preserve}
- Avoid: {avoid}

For image-based inputs, preserve the subject's most recognizable traits while translating them into the selected style. Do not claim exact biometric identity or photorealistic duplication.

For description-based inputs, create a fictional avatar from the description. Do not write that it preserves photo likeness.

The avatar must work as a profile image: readable at small size, centered or deliberately framed, clear silhouette, no important facial features or subject marks cropped out, simplified background, and one final output.

Generate only one final image. Do not output explanations, alternatives, grids, contact sheets, or multi-option compositions.

出力に関する規則

  • 最終的に生成するプロンプトは、アバターのタスクフィールド、references/avatar-prompt-blueprint.md、選択したスタイルアトム1つのみから構成した、アバターに特化した統合プロンプトにしてください。
  • 選択したスタイルの STYLE.md を、独立した2つ目のセクションとして貼り付けないでください。スタイルアトムをアバターの設計図に合わせて調整してください。
  • 最終プロンプトには、選択したスタイルの META.md と STYLE.md に定められた必須の要素を保持してください。
  • 無関係なユーザーテキストを最終プロンプトにコピーせず、簡潔な派生の被写体フィールドを使用してください。
  • プロンプトファイルにスタイル選択の理由を含めないでください。
  • 複数のスタイルを組み合わせないでください。
  • 表紙やポスターのタイトル階層、記事の要約、プラットフォームの表紙に関する規則を追加しないでください。

コメント