Community画像github.com

インタラクティブグリーティングカード

写真とメッセージを、WebGLで動く折りたたみ式3Dグリーティングカードに変換します。箔や厚塗りの絵の具が光を受けて輝き、タップで開くと手書きのメッセージが現れ、裏返しもできます。オフラインでも使える自己完結型のHTMLファイルを1つ生成し、送信やホスティングも自由自在。誕生日、クリスマス、バレンタインなど、あらゆるグリーティングカード作成に対応します。

インタラクティブグリーティングカード とは?

このスキルは、写真やメッセージからインタラクティブな3Dグリーティングカードを生成するためのツールです。カードはWebGLを使用してブラウザ上でレンダリングされ、折りたたみ式で、表面の箔や絵の具が動く光を反射し、タップで開くと手書き風のメッセージが表示され、裏返すこともできます。スノーやハート、ホタルなどのエフェクトを追加でき、さらにタップに反応する発光や揺れなど、高度なアニメーションも可能です。すべてが1つのHTMLファイルに埋め込まれているため、オフラインでも動作し、GitHub PagesやNetlifyなどの静的ホストにそのままデプロイできます。このツールは、Claude CodeやCursorなどのAIエージェントと組み合わせて使用することを想定しており、ユーザーが「グリーティングカードが欲しい」と依頼した際に、AIが自動的にカードを生成・カスタマイズできます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/annnguyentt/interactive-greeting-card-skill/tree/HEAD/interactive-greeting-card

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

インタラクティブグリーティングカード は何をしますか?

思わず触りたくなるカードを作りましょう。写真を表面にあしらった折りたたみカードがページ上でゆらめき、箔や絵の具が動く光を反射し、タップで開くと手書きのメッセージが現れ、裏返すと裏面も見えます。短時間のビルドで、写真、フォント、レンダラーをすべて内部に含む 1つのHTMLファイル が生成されるので、ファイルから直接開け、オフラインでも動作し、そのままどんなWebホストにもアップロードできます。

このスキルに含まれるもの:

  • scripts/make_card.py - カードデータ(JSON)からページをビルドします。データをチェックし、エラーがあれば説明してから書き出します。
  • scripts/grid.py - 画像上にラベル付きピクセルグリッドを描画します。カードのカットラインと正確に一致するので、位置の読み取りに使えます(エフェクトやカラーピッカーにのみ必要)。
  • scripts/foil_preview.py - 箔になる部分をマゼンタで正確にプレビュー表示します。ビルド前に箔の設定を調整できます(numpyが必要)。
  • scripts/snapshot.mjs(オプション、NodeとPlaywrightが必要) - 表面、内部、裏面のスクリーンショットを撮影します。--live オプションで、動くカードの内容や各タップの動作を確認できます。
  • references/options.md - すべての設定項目を記載しています。references/living-cards.md - カードを生き生きと動かす方法を説明しています。必要なときに読んでください。

カードの作り方

1. 画像とメッセージを入手する

必要なのは、表面に使う画像と、内部に書くメッセージの2つだけです。どちらかが不足している場合は、相手に依頼するか、代わりにメッセージを書くことを提案してください(誰宛で、誰からのメッセージかを尋ねます)。その他の設定にはすべて適切なデフォルト値があるため、相手にアンケートに答えるよう求める必要はありません。適切に選択し、選択した内容を相手に伝えて変更できるようにしましょう。

メッセージは相手が提示したまま使用してください。相手が依頼しない限り、言葉を磨く必要はありません。ただし、手書きカードに適した位置で改行を入れてください(挨拶は独立した行に、結びの言葉は最後に)。行が長すぎると、約20文字で自動的に折り返されます。約60語までが大きく読みやすく、それ以上長いと文字は小さくなり、収まりきらない部分はカットされるため、長すぎるメッセージは短くするよう提案してください。

複数の画像がある場合は、1ページに複数のカードが並び、ドックで切り替えられます。カードのセットや、複数のデザインから選べる1枚のカードに適しています。

2. 画像を確認し、仕上げを選ぶ

仕上げによって、表面の光の反射の仕方が決まります。選択する前に画像を確認してください。

画像の種類仕上げ備考
筆跡のある絵画(油彩、ガッシュ、アクリル、厚塗り水彩)paint絵の具の筆跡が立体的に浮かび上がり、光の下で輝きます。金の絵の具がある場合は、それも光るようにします: foil.on: "colour" で金色を選択。
イラスト、線画、レタリング、フラットデザイン(特に無地の紙)foilon: "details" で線や暗いディテールを箔押し。"colour" で選択した1色(例:金のレタリング)を箔押し。"darks" で最も暗い形状(シルエット)を箔押し。
写真printマットなカードに印刷。薄い箔の border で上品に仕上がります。写真のディテールに箔を施すと、ノイズのように見えることが多いです。

箔の色: gold(クラシックで暖かみのある)、silver(冬、結婚式、クールなパレット)、rose(ロマンチック)、copper(秋、素朴な雰囲気)、pink(遊び心)、holo(ホログラフィック、誕生日)。画像のパレットと機会に合わせて選んでください。

ビルドする前に foil_preview.py で箔を確認してください(カードデータを書いた後、ステップ5)。意図した部分だけが箔になり、それ以外に影響がないことを確認します。よくある問題:

  • 箔にしたい部分が、したくない部分と色や暗さを共有している場合(例:花の金色の中心の上にある金のレタリング)。foil.area で箔を適用する範囲を四角形で囲んで制限します。
  • 標準の金は淡くクラシック。もっと濃い金で描かれたアートワークは、独自のインクを持たせることができるため、箔がそれに合います。

references/options.mdのFoilセクションに、インク、各モードでの amount の動作、および area の説明があります。

紙(内部、裏面、端): white、cream、blush、sage、sky、midnight、または任意の #rrggbb。画像が無地の紙に描かれている場合、カードはデフォルトでその紙の色になり、通常最も美しく見えます。

カードは画像の中央から形状に合わせて切り抜かれます: portrait(5:7、デフォルト)、square、landscape(7:5)、original(画像の元の形状、制限あり)。横長の画像には landscape を使用します。被写体が端に近い場合は、grid.py を実行して切り抜き後の範囲を確認してください。

3. 機会に合わせてエフェクトを追加する(オプション)

これらは位置指定が不要なので、カードに合う場合は自由に追加してください:

  • snow: 表面に雪の結晶が舞い降ります(冬、クリスマス)
  • hearts: 小さなハートが時々画像から浮かび上がります(恋愛、バレンタイン、母の日、結婚式)
  • fireflies: 柔らかな光が下部を漂います(夏の夜、夢のようなシーン)
  • shootingStars: 星が時々上部を横切ります(夜空)
  • sparkle: 箔のポイントが光を捉えてキラキラ輝きます(箔カード全般)

1〜2個のエフェクトで十分です。多すぎるとごちゃごちゃします。

4. カードに命を吹き込む(オプション、最高の部分)

カードはさらに多くのことができます。画像の中のランタンが光り、揺らめき、タップすると輝きが増す。太陽が光線を放つ。猫の尾が揺れ、撫でられるとハートが浮かび上がる。枝が揺れて雪を落とす。マフラーがポインターの風にひらひらと揺れる。これには画像上の位置指定が必要で、grid.py のグリッドから読み取ります。references/living-cards.md を読んで従ってください。

相手がカードにアニメーションやインタラクティブ性を求めている場合、または画像に明らかな光源(ろうそく、ランタン、太陽、月、明かりのついた窓)やキャラクターが含まれている場合にこれを行ってください。時間がかかるため、簡単なカードの場合は、次のステップとして提案するにとどめてください。

5. カードデータを書く

画像の隣にJSONとして保存します。1枚のカードの場合:

{
  "title": "Happy birthday, Ellie",
  "image": "ellie-birthday.jpg",
  "alt": "A watercolour of a fox in a meadow of poppies.",
  "name": "Fox and Poppies",
  "finish": "foil",
  "foil": { "colour": "rose", "on": "details", "amount": 0.12 },
  "paper": "cream",
  "message": "Dear Ellie,\nHappy birthday to my favourite person.\nHere's to your best year yet!\nLove, Nora",
  "signature": ["Made with love by", "Nora"],
  "effects": { "hearts": true, "sparkle": true }
}

alt はスクリーンリーダー向けの表面の説明です。必ず記述してください。name は、back や signature で特に指定がない限り、裏面に小さく印刷されます。複数のカードは "cards": [ {...}, {...} ] として、先頭に title と page を置きます。すべての設定は references/options.md にあります。

6. ビルドする

python scripts/make_card.py card.json --check      # データをチェックし、カードのピクセルサイズを表示
python scripts/make_card.py card.json -o card.html

JSON内のパスは、JSONファイルからの相対パスです。簡単なカード用の1行形式もあります:

python scripts/make_card.py --image front.jpg --message "Happy birthday!" --finish foil --foil gold -o card.html

スクリプトがエラーを報告した場合、何が問題で、どう修正すればよいかが示されます。警告(メッセージの欠落、不明な設定、カードから外れた位置など)でもビルドは行われますが、修正してください。

7. 確認する

NodeとPlaywrightが利用可能な場合は、カードを引き渡す前に確認してください:

node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live   # 動くカードの場合: 何が動くかも確認

これにより、表面、光を当てた表面(front-lit: 箔や絵の具が光を反射)、内部、裏面のPNGが書き出されます。これらを確認してください: メッセージは読みやすいか、箔は斑点状ではなくきれいに押されているか、画像は意図した位置でカットされているか。調整して再ビルドします。各サイクルは短時間です。ブラウザがない場合は、プレビューできなかったことを明確に伝えてください(箔プレビューは引き続き機能します)。

8. 引き渡す

相手にHTMLファイルを渡し、使い方を説明してください:

  • 任意のブラウザで開いてカードを表示します。タップする(またはOキーを押す)と開きます。横にドラッグする(またはTキーを押す)と裏返します。
  • 送信するには、オンラインに置いてリンクを共有します: GitHub Pages、Netlify Drop、または任意の静的ホストがそのままファイルを受け付けます。またはファイル自体を送信します。オフラインでも動作します。
  • ファイルサイズは1〜2メガバイトで、ほとんどは画像です。

選択した内容(仕上げ、箔、紙、エフェクト)を一文で伝え、相手が変更をリクエストできるようにしてください。

参考情報

  • スマートフォンの写真は正しい向きに回転され、大きな画像は縮小されます(Pillow使用)。透明部分は白になります。HEIC写真は、Pillowが読み取れない限り、事前にJPEGに変換する必要があります。
  • 手書きフォントはCaveatで、ページに埋め込まれています。ラテン文字、拡張ラテン文字、キリル文字に対応。その他の文字(ベトナム語、ギリシャ語、CJK)は、デバイス自身の手書きフォントにフォールバックします。
  • WebGLがない場合でも、ページは画像とメッセージをフラットに表示します。
  • ページはライトテーマでデザインされています。カードは白い背景に柔らかな影で配置されます。
  • これらの設定を超えてカードの見た目や動作を変更するには、レンダラーのソースがスキルのGitHubリポジトリ(renderer/)にあり、再ビルドすると assets/greeting-card.js が置き換えられます。

関連スキル