mcpField
A
avatar-portrait

avatar-portrait

github.com/b-open-ioクリエイティブ・メディア1254 回インストール5 週間前に更新
リポジトリ

avatar-portrait について

Gemini の画像生成を使い、参照写真からスタイル付きのアバターを作るスキルです。人物らしさと指定スタイルを両立するための指針や、生成後の調整方法を示します。

主な機能

  1. 01写真からスタイル付きアバターを生成
  2. 02顔の特徴を分かる形で維持
  3. 03スタイル調整と反復の指針
  4. 04背景スタイルの参考資料

活用シーン

  1. 01顔写真をドット絵やイラスト風に変換
  2. 02チームのプロフィール画像を同じ画風で作成
  3. 03確認後に画風や人物らしさを調整

インストール

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

$npx skills add https://github.com/b-open-io/gemskills --skill avatar-portrait

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

同梱ファイル.clawnet/unsigned-skill.json

詳細

アバターのポートレート

参照写真をもとに、Gemini の画像生成を使ってスタイリッシュなアバターのポートレートを作成します。認識できる本人らしさを保ちながら、指定されたビジュアルスタイルを適用します。

使用する場面

次のような依頼をユーザーから受けたときに、このスキルを使用します。

  • 写真からアバターを作成する
  • 特定のスタイルでチームメンバーのプロフィール画像を生成する
  • 顔写真をスタイリッシュなポートレート(ピクセル、レトロ、イラスト、モダン)に変換する
  • 実在の人物に似た、統一感のあるキャラクターポートレートを作成する

基本原則

本人らしさとスタイルのバランスを取る

重要な課題は、次の両方を実現することです。

  1. 認識できる本人らしさ - 元の人物に似ている必要があります
  2. 選択したスタイルへの忠実さ - 写実的な描写を求められている場合を除き、スタイルが明確に表れている必要があります

よくある失敗:

  • 写実的すぎる = 指定されたスタイルが反映されない
  • スタイル化しすぎる = 元の人物との類似性が失われる
入力ソースは1つだけ

入力には対象者の写真のみを使用します。スタイルの参照として別の人物の画像を使ってはいけません。顔が混ざり、本人らしさが失われる原因になります。

プロンプトのテンプレート

Generate a styled avatar portrait from the reference photo.

## INPUT IMAGE
[path to subject's photo] - USE ONLY THIS IMAGE

## CRITICAL: LIKENESS PRESERVATION
Capture the subject's EXACT features from the photo:
- Face shape and jawline
- Eye shape, spacing, and expression
- Nose shape and size
- Mouth/smile characteristics
- Hair texture, color, and style
- Facial hair pattern and coverage (if applicable)
The result must be RECOGNIZABLE as this specific person.

## STYLE REQUIREMENTS
- Style: [style requested by user, e.g. pixel art, painterly, anime, low-poly]
- Keep style cues consistent across linework, shading, and color treatment
- Stylized but maintains individual features
- NOT photorealistic unless explicitly requested

## APPEARANCE
- [Describe clothing from photo or as specified]
- [Describe expression]
- [Describe any accessories]

## BACKGROUND
- [Describe background style and colors]
- Background style should match the character style

## TECHNICAL
- NO TEXT on the image
- 512x512 output
- Portrait orientation, head and shoulders
- Square format

## OUTPUT
Save to: [output path]

例:個人用アバター

短い黒髪、ひげ、黒い V ネックの服を着た参照写真がある、チームメンバーの Dan の場合:

Generate a styled avatar portrait from the reference photo.

## INPUT IMAGE
/path/to/dan-photo.png - USE ONLY THIS IMAGE

## CRITICAL: LIKENESS PRESERVATION
Capture Dan's EXACT features from the photo:
- His specific face shape and jawline
- His eye shape and expression
- His nose shape
- His smile characteristics
- Short dark hair - exact texture and style from photo
- Full dark beard - exact pattern and coverage
The result must be RECOGNIZABLE as Dan.

## STYLE REQUIREMENTS
- Style: retro 16-bit pixel art
- Visible pixels but NOT a pixelated photo filter
- Clean lines, rich colors, consistent shading
- Stylized but maintains individual features

## APPEARANCE
- Black v-neck shirt
- Warm smile showing teeth
- Friendly, approachable expression

## BACKGROUND
- California sunset cityscape
- Warm oranges, pinks, teals
- Pixel art style matching the character

## TECHNICAL
- NO TEXT on the image
- 512x512 output
- Portrait orientation, head and shoulders

## OUTPUT
Save to: /path/to/output/dan-pixel.png

コンテキストの管理

生成したアバター画像をコンテキストに読み込まないでください。 スクリプトが出力するのはファイルパスのみです。ユーザーに結果を目視で確認してもらい、調整のためのフィードバックを求めてください。プログラムで確認する場合は、まず画像を最適化してください(optimize-images スキルを使用)。

反復作業のワークフロー

  1. 最初の試行:詳細なプロンプトで生成する
  2. 確認:本人らしさとスタイルの両方を確認する
  3. 必要に応じて調整する:
    • 写実的すぎる場合:「スタイリッシュなピクセルアートのキャラクター」を強調する
    • 本人らしさが失われている場合:元の写真から特徴の説明を詳しくする
    • 特徴が違う場合:再現する内容をより具体的に指定する

よくある問題

顔が元の写真と似ていない
  • 入力には対象者の写真のみを使用していることを確認する
  • 特徴をより具体的に説明する
  • 写真に写っている正確なディテールを参照する
写実的すぎる
  • スタイルの系統と重要な特徴を強調する
  • 「スタイリッシュ」と「イラストらしい雰囲気」を指定する
  • 写実的な描写を求められている場合を除き、写実的にしないことを明示する
漫画的すぎる/本人らしさが失われる
  • 本人らしさを保つ項目を強調する
  • 再現する特徴を具体的に列挙する
  • 「この人物だと認識できる」ことを強調する

参照ファイル

背景スタイルの参照:

  • references/background-styles.md - アバターによく使われる背景のアプローチ

コメント