Community画像github.com

share-cards

Webサイトの各ページにリンクプレビュー用のOpen Graph画像(1200x630)を生成し、ビルド時に各ページのHTMLにタイトル、説明、正規URL、OGタグを注入します。シングルページアプリケーションでもチャットやSNSで正しいプレビューが表示されるようにします。

share-cards とは?

このスキルは、静的サイトやシングルページアプリケーション(SPA)において、各ページが個別のOpen Graph画像とメタタグを持つようにするためのツールです。チャットアプリやSNS、検索エンジンのクローラーはJavaScriptを実行しないため、SPAではすべてのリンクが同じプレビューになってしまいます。share-cardsはこの問題を解決します。まず、HTMLテンプレートとページリストから、ヘッドレスブラウザを用いて各ページ専用の1200x630 JPEG画像をレンダリングします。次に、ビルド済みの`index.html`を基に、各ページごとに`<title>`、description、`og:*`、`twitter:*`タグを埋め込んだ個別のHTMLファイルを生成します。対応プラットフォームとしては、Viteプラグイン(`vite-plugin.mjs`)が提供されており、`vite build`後に自動で注入を行います。それ以外のフレームワークでは、ビルドコマンド後に`cards inject`を実行することで同様の処理が可能です。VercelやNetlifyなどのホスティングサービス向けの書き換えルールも生成でき、クローラーが正しいページを読めるようにします。このスキルは、OG画像がすべて同じになってしまう、リンクプレビューが正しく表示されない、という課題に対して、画像生成からメタタグ注入、CI/CDへの組み込みまでをワンストップで提供します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VinVirtual/share-cards/tree/HEAD

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

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

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

ドキュメント

share-cards は何をしますか?

プレビュークローラー(チャットアプリ、SNSサイト、検索エンジン)はサーバーが送信するHTMLを読み、JavaScriptは実行しません。シングルページアプリケーションはすべてのアドレスに同じHTMLを送信するため、すべてのリンクで同じプレビューが表示されます。share-cards はこの両方の問題を解決します。

  1. render: 1つのHTMLテンプレート + ページリスト → 各ページごとに1枚の1200x630 JPEGを、ヘッドレスブラウザで描画します。
  2. inject: ビルド済みの index.html → 各ページごとに1つのHTMLファイルへ。それぞれに独自の <title>、description、正規URL、og:* および twitter:* タグを埋め込みます。

スキルフォルダ: ~/.claude/skills/share-cards/(以下 $S と表記)。すべてのコマンドは $S/cards <command> [dir] で、[dir] には cards.config.json が格納されています。$S/cards help で一覧表示されます。

$S/cards                    コマンドラインインターフェース
$S/lib/                     設定、タグ注入、レンダリング、検証、プレビュー、リライト
$S/templates/               editorial.html、minimal.html、technical.html、runtime.js
$S/vite-plugin.mjs          `vite build` 後に inject を実行するプラグイン
$S/references/templates.md  スロット、変数、および独自テンプレートの作成方法
$S/examples/site/           4ページのサンプルサイトとそのカード、注入済みページ
$S/README.md                設定リファレンス、フレームワーク別注意点、制限事項

ワークフロー

  1. マシンを確認: $S/cards check。ブラウザが必要なのは render と preview のみです。
  2. ページを特定する: プロジェクトのルーターまたはコンテンツフォルダを読み取り、すべての公開アドレスをリストアップします。静的ファイルが提供されている場所(public/、static/)と、ビルドの出力先(dist/、build/、out/)を見つけます。
  3. スキャフォールド: $S/cards init <project>(ページリストをプロジェクトのルートやコンテンツデータから動的に生成する必要があり、ずれが生じないようにする場合は --mjs を追加します)。siteUrl(実際の https:// オリジン)、siteName、imageDir(静的フォルダ内、例: public/og)、imageUrlPath(そのフォルダが提供されるパス、例: /og)、dist を設定します。
  4. 各ページのエントリを作成する:
    • title: プレビューに表示される完全なページタイトル。
    • description: 一文、最大160文字。
    • cardTitle: カードに描画される単語。短く(約2〜6単語)。*stars* で囲むとアクセントカラーで描画されます。
    • cardDescription(オプション、カード用の短い行)、kicker(小さなラベル)、art(プロジェクト内の画像ファイル)、template(ページごとの上書き)。
    • 事実、数値、引用をでっち上げないでください。言葉はページ自体から取ってください。
  5. テンプレートとテーマを選ぶ: editorial(紙、太いセリフ体)、minimal(白、控えめ)、technical(ダーク、等幅フォント)。theme はプロジェクト自身の色に設定します。それ以外の場合は $S/cards eject <name> card.html を実行し、編集して "template": "./card.html" を設定します。references/templates.md を参照してください。
  6. レンダリング: $S/cards render <project>。すべての警告を読んでください:タイトルや説明が切れている場合は、テキストを短くする必要があります。
  7. 結果を確認する: $S/cards preview <project> で cards-preview/contact-sheet.png と chat-preview.png が書き出されます。両方のPNGを読んでください。各カードで、文字の切れ、混雑、コントラストの弱さ、テキストを隠すアートワークがないか確認します。修正して再レンダリングします。自分で確認しない限り、カードが正しいとユーザーに伝えないでください。
  8. ページシェルを準備する: inject は既存のタグを埋め、タグがない場合は失敗します。$S/cards tags <project> を実行し、ブロックをソース index.html の <head> に貼り付け、古い共有タグと置き換えます(または --add-missing を渡します)。
  9. ビルドに組み込む:
    • Vite: $S/vite-plugin.mjs から shareCards() を plugins に追加します(README参照)。
    • それ以外: ビルドコマンドの後に $S/cards inject <project> を実行します。
  10. ホストのルール: ホストが /index.html へのキャッチオールリライトを持っている場合、$S/cards rewrites vercel|netlify|netlify-toml <project> でページルールを出力し、それらを キャッチオールの前に 配置します。ルールをユーザーに表示します。明示せずにホスト設定を編集しないでください。
  11. 検証: サイトをビルドし、$S/cards verify <project> を実行します。All good. で終了する必要があります。
  12. ユーザーに残っている作業を伝える: デプロイし、実際のリンクを1つチャットアプリに貼り付けます。プレビューは各アプリによってキャッシュされ、場合によっては数日間保持されます。"versionImages": true を設定すると、カードが変更されるたびに画像アドレスが変わります。

ルール

  • siteUrl はプロダクションオリジンである必要があります。プレビュー画像には絶対的な https:// アドレスが必要です。
  • カードはビルドの前にレンダリングし、ビルドがそれらをコピーするようにし、カードと cards.lock.json をコミットします。これによりCIではブラウザが不要になります。
  • 設定で "allowNetwork": true が設定されていない限り、レンダリング中にネットワークから何も取得されません。Webフォントは fonts の下にリストされたローカルファイルである必要があります。
  • フォントはデフォルトでシステムスタックにフォールバックするため、別のマシンで描画されたカードは異なる場合があります。どこでも同一の出力を得るには、フォントファイルをプロジェクトに追加し(ライセンスを確認)、fonts の下にリストします。
  • 確認されなかったことを明確に伝えます: 各アプリの実際のクローラー、およびデプロイ後のホストのルーティング。

関連スキル