Communitygithub.com

kubai-book-cards

カードにホバーまたはフォーカスすると、本のように開いて内側のページが表示されます。静止時は外観が変わりません。通常カード、擬物精装本、極簡ドキュメントの3スタイルに対応。ドキュメント、ナレッジベース、ポートフォリオ、テンプレートマーケットに最適です。

kubai-book-cards とは?

このスキルは、既存のカードコンポーネントを改造し、ホバーまたはフォーカス時に本のように開くアニメーションを追加するものです。静止時は元の外観を完全に維持し、操作時にのみページが現れるため、視覚的な驚きと情報の階層表現を両立します。3つのスタイル(通常のプロダクトカード、装丁風ハードカバー、ミニマルなドキュメント)を用意し、開く角度やページ数、ヒンジの位置、影の強さ、モーションの感触など、ほぼすべてのパラメータを細かくカスタマイズ可能です。対応プラットフォームは主にWebフロントエンドで、Reactなどのコンポーネントベースのフレームワークを想定しています。CSSトランスフォームと3Dレイヤーを駆使し、パフォーマンスにも配慮した設計で、アクセシビリティやタップ操作にも対応します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-book-cards

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

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

ドキュメント

ホバー時に本のように開くカード

『999の小ワザで、あなたのプロダクトの質感を上げる』第006号・@kubai087

ユーザーのプロジェクトで以下の指示に従って改造してください。指示はユーザーの立場で書かれています:文中のI、me、myはユーザーを指します。「必ず先に確認」と書かれている箇所は、一度止まってユーザーに尋ねてから進めてください。

改造指示

自分のプロダクトのカードを、ホバー時に本のように少し開くようにしてください。 静止時はカードが現在の見た目と完全に同じである必要があります。ホバーまたはフォーカス時にのみ、内側にページがある小さな本であることが明らかになります。

0. 既存のものから始める

  • 自分が指定するカードコンポーネント(またはグリッドやリストで使われているもの)を見つけ、その場で改造します。そのマークアップ、デザイントークン、角丸、影、モーションやスプリングのユーティリティを再利用します。
  • カードのフットプリント、パディング、コンテンツ、レイアウトは変更しません。カードの周りのものは動いてはいけません。
  • 代わりに新しいカードを依頼する場合は、以下で選んだスタイルで、新しい正方形のカード(約280×280)を構築します。
  • 自分が設定しなかったオプションは、デフォルト(* 印)が使われます。

1. スタイルを選ぶ

デフォルト*:通常のプロダクトカード。ホバーされるまでは普通のカードとまったく同じ。

  • 表面:無地の白(または自分のカード表面トークン)、テクスチャなし。
  • エッジ:ボーダーカラーで1pxのヘアライン。
  • 影:薄い、ニュートラルなクールグレー、強さ半分。
  • タイポグラフィ:プロダクトのサンセリフ。タイトル24/600、説明15 muted、メタ14 muted。
  • カバー:既存のカードUI:48pxのアイコンタイル、右上の↗矢印、タイトル、説明、ヘアラインの下のメタフッター。
  • 壁:通常のページ背景。
  • ページ:白、背表紙に向かって薄い陰影、小さな見出しと4~6行のグレーのテキスト。

擬物装丁(Skeuomorphic):ギャラリーの壁に飾られたハードカバーの本。

  • 表面:深いカバーカラーの上に、細かい布のテクスチャ。
  • エッジ:光を受けたベベル:上部のエッジが明るく、下部が暗い。
  • 影:暖かみのある、ほぼニュートラルなグレー(オレンジは不可)、フル強度。
  • タイポグラフィ:セリフ体のタイトル1行のみ、左下。カバーには他には何も置かない。
  • カバー:フルブリードの画像またはアニメーションASCIIシーン、上部にソフトグロス、下部に陰影。
  • 壁:温かみのある漆喰風、細かいテクスチャと各本の上にスポットライト。
  • ページ:クリーム色の紙、テクスチャあり、斜体の章見出し、両端揃えの行、天のこばに沿った薄いページエッジ。

ミニマルドキュメント(Minimal):ドキュメントのボリューム。

  • 表面:フラットなオフホワイト、ライトグレーまたはグラファイト、カードごとに1トーン。
  • エッジ:かすかなベベルまたはヘアライン。
  • 影:クールなニュートラルグレー。
  • タイポグラフィ:モノスペースのセクション番号とバージョンが上部、ヘアラインの罫線の上;2行のサンセリフタイトルと下部の小さなグレーのラベル。
  • カバー:1つの小さなグレーの線画ダイアグラム、インクカラーの1要素のみ。
  • 壁:クールグレー、かすかな24pxのドットグリッドと上部からの柔らかな光。
  • ページ:クールホワイト、サンセリフの見出しとグレーの行。

自分のプロダクトに合わせる(Match my product):表面、エッジ、影、タイポグラフィ、壁を自分のトークンから取得し、カバーは現在のカードのまま正確に保つ。

2. オプション(デフォルトは*印)

  • 強度(Intensity):微妙 (A = 24deg) | book* (A = 42deg) | dramatic (A = 60deg)。
  • ページ数(Pages):2 | 3 | 4* | 6。
  • ヒンジ(Hinge):left* | right | top。
  • トリガー(Trigger):hover* | press(押している間開く) | scroll into view(60%表示された時に一度開き、約1.2秒後に閉じる)。キーボードフォーカスでも常に開きます。
  • ページ表示内容(Pages show):blank paper | lines of text* | カードからの実際のプレビューコンテンツ(次のフィールド、短いリスト、チャートのサムネイル)。
  • カバー(Cover):existing card UI* | image | animated ASCII scene | solid colour。
  • 影の方向(Shadow direction):from above* | from top-left。
  • 影の強さ(Shadow strength):none | light | normal* | deep。
  • 角(Corners):match my tokens* | continuous(スーパー楕円)。
  • モーションの感触(Motion feel):snappy (k 320, damping 0.9) | default* (k 240, damping 0.86) | soft (k 160, damping 0.8)。いずれもほとんどオーバーシュートしません。
  • モーション抑制(Reduced motion):tiny lift* | nothing。
  • タッチ(Touch):press* | scroll into view | off。

3. レイヤー構成

  • カードのリンク内部で、カバーをtransform-style: preserve-3dのbody要素に配置します。その後ろにN枚のページと裏板を、すべて同じ正方形に絶対配置で積み重ねます。
  • 順序(前面から背面):カバー (n = 0)、ページ (n = 1..N)、裏板 (n = N + 1、動かない)。
  • カバーは既存のカードコンテンツをすべて保持します。ページと裏板は装飾用:aria-hidden、リンクなし、タブストップなし。
  • 静的要素のパースペクティブ:約1100px、原点はヒンジ方向(左ヒンジ:30% 50%、右ヒンジ:70% 50%、上ヒンジ:50% 30%)。
  • すべてのレイヤーのヒンジエッジのtransform-origin:左ヒンジ:0 50%、右ヒンジ:100% 50%、上ヒンジ:50% 0。backface-visibility: hidden。
  • レイヤーnをtranslateZ((N + 1 - n) x 0.6px)で持ち上げ、レイヤー同士が奥行きで干渉しないようにします。
  • ページはカバーの内側8px(背表紙側は4px)に配置し、本のブロックのようにします。角丸はカバーの角丸 − 8。
  • 裏板:フラットカード(デフォルト、ミニマル)ではカバーから約6px内側に配置し、角丸はカバーの角丸 − 6。これにより、カバーの遠近法で縮んだ角の外側に裏板がはみ出るのを防ぎます。擬物装丁では面一(flush)にし、カバーカラーを約28%暗くします。

4. モーション

  • レイヤーnは視聴者に向かって次の角度で回転します: angle(n) = A x 0.7^n そして次の遅延で開始します: delay(n) = 28ms x n カバーが先行し、ページがその後ろに扇状に広がります。
  • 方向:左ヒンジはrotateY(-angle)、右ヒンジはrotateY(+angle)、上ヒンジはrotateX(+angle)。
  • 各レイヤーは独自のスプリング(モーション感触参照)で動作し、約0.3秒で落ち着きます。
  • 閉じるときは逆順:最も内側のページから、遅延 = 28ms x (N - n)、0degに戻ります。
  • ポインターが途中で離れた場合は、現在の角度と速度から再ターゲットします。決してジャンプしません。
  • プロジェクトにスプリングヘルパーがない場合?CSSトランジションで十分です:transition: transformを約420ms、少しオーバーシュートするcubic-bezier(0.3, 1.2, 0.5, 1)などで設定し、transition-delayを開く状態では28ms x n、静止時(閉じている状態)では28ms x (N - n)に設定します(ターゲット状態の遅延が適用されるため、閉じる動作は逆順に実行されます)。

5. 光と陰影

  • 光は上から来るので、影は壁に下に落ちます。
  • 影はカードの背後にある2つのソリッドな形状で、それぞれぼかしが一度適用されています。静止時は通常のフラットカードのようにカードに密着します:
    • 接影(contact):小さくて濃い、下部に配置。カードの下半分、各辺から約4px内側、ぼかし約4px、下方向へ約2px、不透明度約22%。
    • 環境影(ambient):かすか。ぼかし約14px、下方向へ約6px、不透明度約12%。
  • 決してbox-shadowは使わない:それは中空のリングとなり、カバーがそれから離れると輪郭として現れます。
  • 色味:ニュートラルグレーに近く、壁の色に合わせます(暖かい壁には暖かいグレー、冷たい壁には冷たいグレー)。純粋な黒や彩度の高い色は不可。
  • 強さは両方の不透明度をスケーリング:light 0.5(デフォルトスタイル)、normal 1、deep 1.4。
  • 開く動作:2つ目の事前にぼかしたペアへクロスフェード。開いたペアはより長く柔らかい(接影:ぼかし約12px、下方向へ12px;環境影:ぼかし約38px、下方向へ26px)。さらに下方向に約14px、変形で約4%幅を広げます。これを1つの進行値o(0..1)で駆動し、独自のスプリング(k 200, damping 0.9)で動かします:静止ペアの不透明度 1 - o、開いたペアの不透明度 o。
  • ページの陰影:すべてのページに背表紙からのグラデーションオーバーレイを適用します(32%暗 → 55%で8% → 85%で0)。その不透明度は clamp(gap / 6, 0, 1) x max(0, 1 - gap / 30) ここでgap = 前面のリーフの角度 − このリーフの角度。ページは、前面のリーフがちょうどそこから浮き上がっている間は陰影が付き、分離すると明るくなります。
  • カバー(擬物装丁、ミニマル):上部エッジにソフトグロス、下部に少し陰影。

6. 角とエッジ

  • すべてのレイヤー(カバー、ページ、裏板)を1つのシェイプパスでクリップし、そのエッジ(ヘアラインまたはベベル)をその正確なパスに沿って描画します(例:レイヤー上にストロークしたSVGパス)。CSSのborderやinset box-shadowをクリップと混在させないでください。それらは角で不一致を起こし、レイヤーが分離したときに2本目のリムが表示されます。
  • トークンに合わせる:トークンの角丸を使用。ネストされた角丸 = 外側の角丸 − インセット。
  • 連続(Continuous):スーパー楕円の角 |x|^n + |y|^n = 1, n = 2^1.25(CSSのcorner-shape: superellipse(1.25)と同じ曲線)。レイヤーサイズごとにclip-path: path(...)を生成し、エッジのために再利用、リサイズ時に再生成します。

7. インタラクションとアクセシビリティ

  • ヒットテストは静止時のフットプリントで行います。静的要素のホバーをリッスンし、すべての動くレイヤーにpointer-events: noneを設定します。これにより、動くカバーがターゲットを移動させず、カードの端で開閉がちらつくのを防ぎます。
  • カーソル:カード全体にポインティングハンド。
  • カード全体は1つの<a>または<button>のままで、現在のアクセシブルな名前を保持します。ページはアクセシビリティツリーに何も追加しません。
  • :focus-visibleでホバーとまったく同様に開きます。フォーカスリングは外部要素に、静止時の形状に沿って配置します。
  • モーション抑制(Reduced motion):扇状展開も回転もしません。カバーが約2px浮き上がり、影が開いたペアにクロスフェードします。
  • タッチ:ホバーはありません。タッチオプションを使用します。タップは最初の試行でカードをアクティベートできる必要があります。

8. パフォーマンス

  • transformとopacityのみをアニメーション化します。blur、box-shadow、clip-path、width、height、top/leftは決してアニメーション化しません。
  • ぼかし半径をアニメーション化しない:各影を一度ぼかし、2つの事前にぼかしたバージョンをクロスフェードします。
  • すべてのカードに対して1つのrequestAnimationFrameループ。スプリングが静止しているカードはスキップし、何も動いていないときにループを停止します。
  • 値が変更されたときのみスタイルを書き込みます(要素ごとに最後の文字列をキャッシュ)。
  • フレームごとにレイアウト読み取りをしない:一度測定し、リサイズ時(ResizeObserver)に再度測定します。
  • アニメーションキャンバスカバー:最大約30fpsで描画し、画面外(IntersectionObserver)またはタブが非表示のときに一時停止します。

9. アニメーションASCIIカバー(選択した場合のみ)

  • 1文字セル(約6×9px)あたり1色で小さなシーンを描画します。
  • 各文字を明るさに応じて" .:-=+*#%@"から選びます。
  • 色の薄めたコピー(約40%)を下層に描画し、その上に色付き文字を重ねます。これにより、隙間がハーフトーンのように見えます。
  • 毎フレームテキストをレイアウトする代わりに、事前レンダリングされたグリフアトラスから文字をスタンプします。モーションをゆっくりとシームレスにループさせます。

10. 完了時

  • 変更または追加したすべてのファイルをリストアップします。
  • 使用したスタイルとすべてのオプションをリストアップし、どれがデフォルトだったかをマークします。
  • 静止時に元の見た目と異なる点があれば、それをメモします。

Individual skills in this repo

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

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-liquid-glass

为图片、壁纸或视频上方的卡片和面板添加液态玻璃材质:背景模糊与提亮、边缘折射与色散、根据背景自动调整的着色和文字颜色,深色和浅色模式下文字都清晰可读,布局保持不变(liquid glass, glassmorphism)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

関連スキル