Communitygithub.com

Niltra/web-assets-reales

実際のWebサイト向けにリアルな画像を取得・加工します。Playwrightを使ったプロジェクトのライブキャプチャ、ブラウザセッションからのプロフィール写真ダウンロード、Simple Iconsによるテクノロジーロゴ、Design DNAに沿った一貫性のあるビジュアル処理を行います。画像、ロゴ、キャプチャ、写真、フレームシーケンスが不足している場合に使用します。

web-assets-reales とは?

このスキルは、AIエージェント(例:Claude Code, Cursor, Codex)がWebプロジェクトにリアルな画像アセットを生成・統合するための包括的なガイドです。Playwrightを使用して実際のプロジェクト(本番ビルド、リポジトリページ)のスクリーンショットを、viewport 1440x900、deviceScaleFactor 2の設定でキャプチャします。また、デバッグポート経由でChromeブラウザセッションからプロフィール写真を直接ダウンロードし、Simple Iconsライブラリからテクノロジーロゴを取得します。Visual Studio Code、Cursor、odex、GitHub Copilotなどほとんどの主要なAIエージェントプラットフォームで使用可能であり、Node.js(sharp, Playwright, simple-iconsパッケージ)が必要です。このスキルの核心は「ゼロストックフォト」の原則にあり、架空のレンダリングやAI生成画像を避け、実際の製品、実際のターミナル出力、実際の写真のみを使用します。すべてのアセットにはDesign DNAに基づいたデュオトーン処理、グライン効果、統一されたボーダー・シャドウスタイルが適用され、各画像は300KB以下に圧縮されます。さらに、各アセットの出典とライセンスを`docs/assets.md`に記録することで、著作権と透明性を保証します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Niltra/agent-skills-web/tree/HEAD/skills/web-assets-reales

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

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

ドキュメント

リアルアセット、ストックフォトはゼロ

原則:画像が再現不可能な場合、WebサイトはAIが作ったようには見えません。実際の製品、実際のターミナル、実際の写真。ストックフォト、汎用レンダリング、および代替品としてのAI生成は禁止です。

プロジェクトのスクリーンショット(Playwright)

  • 常にプロジェクトの本番ビルドを、viewport 1440x900、deviceScaleFactor: 2 でキャプチャします。
  • 何かを伝える状態(データがあるダッシュボード、クエリ結果、実行中のパイプライン)を選択し、空のホームページは避けます。
  • スクリーンショットを撮る前に、networkidle とフォントの読み込み完了を待ちます。邪魔になる場合はCookie/バナーを非表示にします。
  • public/shots/<プロジェクト>/<状態>.png に保存し、sharp で圧縮します(Web用にはAVIF/WebP、透過が必要な場合のみPNG)。
  • デモのないリポジトリの場合:リポジトリページのスクリーンショット(レンダリングされたREADME)をキャプチャし、モックアップは使用しません。

プロフィール写真

  • すでに開いているブラウザセッション(デバッグポートを使用したChrome)からプロフィール写真をダウンロードします。切り抜いたスクリーンショットは使用しません。
  • オリジナルを public/me.jpg(または public/me.webp)に保存し、切り抜きバージョンも用意します。変形や肌/アイデンティティの修正は絶対に行いません。
  • すでにプロジェクトにポートレートがある場合は、再ダウンロードする前にそれを再利用します。

テクノロジーロゴ

  • Simple Icons(npm i simple-icons)を使用して、単色SVGを取得します(ライブラリはMIT/CC0。ロゴは各所有者の商標であり、情報提供目的の公正な使用です)。
  • デフォルトではDesign DNAのインク色でインライン表示します。ホバーの詳細情報で意味がある場合のみ、ブランドカラーを使用します。
  • ツールがSimple Iconsにない場合(一部のAIツールなど)、一貫性のあるタイポグラフィックモノグラム(等幅フォントの頭文字)を使用します。Google画像検索から取得した画像や、でっち上げの画像は使用しません。

ターミナル/コード

  • 「ターミナルの証拠」が必要な場合:等幅フォントのHTMLブロックを作成し、プロジェクトの実際のコマンドを実行し、Playwrightでキャプチャします。偽の出力は絶対に作成しません。
  • コマンドとバージョンは真実であり、検証可能でなければなりません。

処理と一貫性

  • Design DNAのパレットにマッピングされたソフトなデュオトーン、オプションで軽いグレイン効果。すべてのキャプチャに同じ処理を適用します。
  • ボーダー/角丸とシャドウは、画像ごとではなく、プロジェクトのトークンに従います。
  • 目標サイズ:各画像300KB以下。next/image を正しい sizes とともに使用し、priority は最初の画像のみに設定します。
  • すべてのアセットには説明的な alt 属性を設定し、装飾的な場合は alt="" とします。

整合性ルール

  • キャプチャ内にでっち上げのメトリクスはゼロ(グラフが本物でない場合はキャプチャしません)。
  • 透かし、著作権が疑わしい画像、主要コンテンツとしての生成AIはゼロ。
  • 各アセットの出典とライセンスを docs/assets.md に記録します。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル