Communitygithub.com

turtleneck

Web/アプリUIのためのデザインスキル。構築中のものを検出し(ランディングページ、プロダクトページ、アプリUI、ダッシュボード、ドキュメント、ショップ、ポートフォリオ、ゲームなど)、5つの大手サイトをブレンドしたスタイルプリセット(keynote, enterprise, cinema, vibe, power, devtool, lab, journey, market, vault, drive)を選択します。HTML/CSS、Tailwind(v3/v4, shadcn)、SwiftUIのレシピを提供。

turtleneck とは?

turtleneckは、WebサイトやアプリケーションのUIに対して、適切なビジュアルスタイルを自動検出し、強固なデザインシステムに基づいて実装するためのAIエージェントスキルです。このスキルは、Claude CodeやClineなどのAIコーディングエージェントで使用することを想定して設計されており、ランディングページ、SaaS、ダッシュボード、ドキュメントサイトなど、さまざまな種類のプロジェクトに適用できます。 最大の特徴は、プロジェクトのタイプ(例:ストリーミングサービスなら「cinema」、開発ツールなら「devtool」)を自動判別し、それに最適化された11のプリセット(keynote, enterprise, cinema, vibe, power, devtool, lab, journey, market, vault, drive)から1つを選択することです。各プリセットは、カテゴリ内の5つの大手リファレンスサイトをブレンドしたものであり、単一のサイトをコピーしたものではありません。 プリセットは、変数オーバーライドの仕組みで動作し、コアとなる`tokens.css`に定義された共有コンポーネント(タイプスケール、ボタン、タイル、グリッド、レール、統計情報、リビールアニメーション)を、プリセットごとの`styles/<preset>.css`がカスタマイズします。TailwindやSwiftUI向けの同等のトークンも提供されています。 さらに、このスキルはアクセシビリティ(AAコントラスト比準拠)、レスポンシブデザイン(320pxから2560pxまでのテスト幅)、モーション、タイポグラフィ、カラーシステムに関する厳格なルールを強制します。これにより、「Apple風」「Netflix風」「OpenAI風」といった抽象的なリクエストを、一貫性のある高品質な実装に変換できます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/n-stau/turtleneck/tree/main/skills/turtleneck

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

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

ドキュメント

turtleneck は何をしますか?

アプリに適したルックを選び、規律を持って構築します。すべてのルックはプリセットです。共有のコアの上に変数オーバーライドを適用した1つのファイルです。デフォルトのプリセットkeynoteは、コアそのものです。他のすべてのプリセットは、あるカテゴリの5つの大手サイトをブレンドしたものであり、それらのうちの1つをコピーしたものではありません。

このスキルがアクティブな場合、矛盾が生じる箇所では、一般的な「AIデフォルトを避ける」スキル(frontend-designなど)をオーバーライドします。keynoteでは、システムフォント、文頭大文字のアイブロー、トーングラデーションの見出しが正しいものです。

このファイルの隣にあるファイル:

  • tokens.css: コアとkeynoteの値。すべての色は light-dark(light, dark) です。color-scheme を :root、.a-dark、.a-light、または data-theme に設定すると、どちらの半分が選択されます。すべてのプリセットフックはその :root にリストされています。共有コンポーネント(タイプスケール、ボタン、タイル、.a-grid、.a-rail、.a-stats、.a-reveal)もそこにあります。
  • styles/<preset>.css: 変数オーバーライドと、プリセット固有の少数のルール。tokens.css の後に読み込みます。
  • styles/<preset>.md: プリセットごとに1ページ:使用するタイミング、トークンテーブル、ルール、コンポーネントの差分、フォント、避けるべきこと、チェックリスト。
  • recipes-html.md: ページスケルトン、ナビゲーション、ヒーロー、タイル、ベントー、ギャラリー、比較、フッター(スマホではアコーディオン)、リビール、および共有プリセットパターン(反転バンド、検索ヒーロー、レール、スペックテーブル、プランカード、コードフレーム)。
  • tailwind.md、swiftui.md: それらのスタック向けの同じトークン。
  • test-widths.html?src=<url>[&h=800][&full=1]: ページを320/375/414で横に並べ、オーバーフローレポートを表示します。full=1 は各フレームをドキュメントの高さまで拡大し、全画面のスマホスクリーンショットを撮ります。
  • example.html および ../../demos/ (agent-skillsリポジトリ内): 完成したページ。

ステップ0: アプリタイプを検出する(必須、コードの前に)

  1. 既存のデザインシステムまたは明確なスタイルリクエストが優先されます。 プロジェクトトークン、コンポーネントライブラリのテーマ、ブランドガイド、または「ダークで赤くして」などのリクエストがある場合は、それを使用し、以下のコアルールのみを保持し、テーブルはスキップします。
  2. シグナルを読み取ります: リクエスト、README、依存関係(package.json、pyproject.toml、Podfile、Package.swift、Gemfile、*.csproj)、ルート、既存のCSS、プロダクトカテゴリとオーディエンス。
  3. 1つのプリセットを選択します:
カテゴリシグナル(リクエスト、プロダクト、依存関係、ルート)プリセット
プレミアムハードウェア物理製品、消費者向けデバイス、ライフスタイルガジェット、ローンチページ、「クリーン」、「ミニマル」、「プレミアム」、SwiftUIマーケティング画面、明確なシグナルなしkeynote
ビジネスソフトウェアオフィス/生産性、B2B、CRM/ERP、イントラネット、IT/コンプライアンス、ヘルスケア、依存関係 @fluentui/*、@microsoft/teams-js、office-addin-*、@azure/*、Blazor/.NET、ルート /admin、/settings、/reportsenterprise
ストリーミング動画、映画/TV、シリーズ、予告編、ライブイベント、VOD、依存関係 hls.js、video.js、shaka-player、@mux/*、react-player、ルート /watch、/browse、/titlecinema
音楽&ソーシャル音楽/オーディオ、プレイリスト、クリエイター、ソーシャルフィード、デート、フィットネスクラス、若者向けサブスクリプション、依存関係 howler、tone、wavesurfer.js、expo-av、ルート /player、/playlist、/profilevibe
ゲーミングハードウェアGPU/PCパーツ、コンソール、周辺機器、eスポーツ、ベンチマーク、ドライバー、「FPS」、依存関係 three、@react-three/fiber + チャートライブラリ、ルート /specs、/compare、/driverspower
デベロッパー&クラウドAPI、SDK、CLI、ホスティング、デプロイ、データベース、オブザーバビリティ、決済API、「開発者向け」、依存関係 next、@radix-ui/*、stripe、prisma、drizzle、trpc、turbo、ルート /docs、/changelog、/pricingdevtool
AIモデル、アシスタント、チャット、エージェント、「AI搭載」を製品とする、依存関係 openai、@anthropic-ai/sdk、ai、langchain、transformers、ルート /chat、/research、/modelslab
旅行宿泊、フライト、ライド、ホテル、予約、旅程、日付ピッカー、地図(leaflet、mapbox-gl)、ルート /search、/stays、/trips、/bookjourney
小売ショップ、ストア、カタログ、マーケットプレイス、カート、チェックアウト、セール、食料品、ファッション、依存関係 @shopify/*、@medusajs/*、@commercetools/*、snipcart、@stripe/stripe-js(製品カタログあり)、ルート /shop、/products、/p/、/cart、/checkout、/categorymarket
金融銀行、クレジットカード、決済、ウォレット、保険、貸付、貯蓄、投資、消費者向けアカウントダッシュボード、依存関係 plaid、react-plaid-link、@adyen/*、dinero.js、currency.js、ルート /accounts、/cards、/rates、/apply、/transfer(開発者に販売される決済APIは devtool)vault
自動車車、オートバイ、eバイク、EV充電、モビリティ、ディーラー、試乗、コンフィギュレーター、航続距離とスペックページ、ルート /models、/configure、/inventory、/test-drive、/dealersdrive
ページタイププリセット(タイブレーカー)
ドキュメントサイト、チェンジログdevtool
管理ダッシュボードビジネスユーザー向けは enterprise、開発者向けは devtool
ショップmarket、単一のプレミアム製品ページは keynote
ポートフォリオ製品/デザイン作品は keynote、映画/写真/モーションは cinema
モバイルアプリ画面ネイティブ感のあるユーティリティは keynote、コンシューマーメディアとソーシャルは vibe
ゲーム / ゲームスタジオ競技志向でハードウェア的なものは power、ストーリー主導で予告編中心は cinema
別製品内のAI機能その製品のカテゴリ、AIが製品そのものである場合のみ lab
別製品内の予約フロー検索と結果ページのみ journey

ユーザーのスタイルワードは直接マッピングされます: 「Apple風 / プレミアム / クリーン」 = keynote; 「Microsoft / Fluent」 = enterprise; 「Netflix風」 = cinema; 「Spotify風 / TikTok風」 = vibe; 「ゲーミング / NVIDIA風」 = power; 「Stripe / Vercel / GitHubスタイル」 = devtool; 「OpenAI / Anthropic風」 = lab; 「Airbnb / Booking風」 = journey; 「Amazon / IKEA風」 = market; 「銀行 / PayPal風」 = vault; 「Tesla / BMW風」 = drive。 結果はカテゴリのブレンドであり、その企業のサイトではありません(「商標とアセット」を参照)。

  1. シグナルが弱い、または競合する場合: keynote。
  2. 構築前に選択内容を1行で述べます。例:「スタイル: devtool (Next.js + Prisma、ルート /docs と /pricing、開発者向け販売)。」その後、styles/<preset>.md を完全に読みます(keynote の場合は styles/keynote.md)。

プリセットが変更できるもの

tokens.css(:root)の変数と、それ自身の少数のルールのみを通じて:

  • フォント(ディスプレイ、本文、モノ)とタイプスケール、ウェイト、トラッキング、行の高さ;
  • アイブローとイントロのスタイル、本文サイズ(UIは14px未満、読み取りテキストは16px未満にしない);
  • サーフェスとテキストの色、ライト/ダークのデフォルト、1つのアクセントカラーとその上のテキスト、リンクとフォーカスの色;
  • 角丸、境界線、シャドウ、タイルの塗りつぶし、ボタンの高さ、パディング、ウェイト、大文字/小文字;
  • ナビゲーションの高さ、塗りつぶしとブラー、コンテンツ幅、セクションとタイルの間隔;
  • イージング、持続時間、リビールの距離、ホバーとプレスのフィードバック;
  • イメージとコピーの傾向(そのmdファイル内)。

以下のすべての行は、すべてのプリセットに適用されます。

ワークフロー

  1. プロジェクトを尊重します。 tokens.css + styles/<preset>.css を読み込むか、Tailwindテーマをマージするか、SwiftUIパレットを追加します。プリセットは、そのmdファイルで指定された無料フォントにリンクする場合があります。ページはフォールバックスタックでも適切に見える必要があります。スタイリングのためにnpm依存関係を追加しないでください。
  2. ページ計画を3行で書きます: ページが売るもの、背景付きのセクション順序、そして1つの「見せ場」(反転した章、大きな統計ベントー、デモ、動画、スティッキースクロール)。
  3. 最初にコピーを書きます: 短い見出し(プリセットが長さを設定)、1行のサブ見出し、イントロは最大2行。
  4. レシピからセクションごとに構築します。
  5. すべてのテスト幅で検証します(レスポンシブ)。プリセットに両方がある場合はライトとダークで: スクリーンショット、オーバーフローチェック、チェックリスト。完了を報告する前に修正します。

コアルール

タイポグラフィ

  • UIには1ファミリー(実際のコード、キー、API値のみモノを追加)。ディスプレイのウェイトはプリセットから。
  • サイズが大きくなるにつれてトラッキングは狭くなります。本文のトラッキングが-0.022emを超えてマイナスになることはありません。
  • ディスプレイサイズは流動的 clamp(min, rem + vw, max) です。常に中央の項にremを混ぜます。
  • 読み取り用本文は16-17px、高密度UI、メタ行、フッターでのみ14px。本文の行の高さは1.45-1.6。
  • 見出しには text-wrap: balance を、長い単語は折り返します(overflow-wrap、hyphens)。
  • 重要な数字は大きく、表形式の数字を使用します。そのラベルは小さくします。

カラー

  • ブランドカラーが最優先。 ユーザーまたはプロジェクトからのブランドカラーがプリセットのアクセントを置き換えます。プリセットのアクセントはフォールバックにすぎません。プリセットはレイアウト、タイポグラフィ、角丸、密度、画像、モーションを決定します。
  • アクセントのレシピ(ブランドカラーまたは任意のアクセント変更)、:root に一度設定:
    • --a-blue: 塗りつぶし、つまり指定されたブランドカラー(古い名前を保持。「アクセント」を意味する)。
    • --a-on-accent: インクまたは白。塗りつぶし上で4.5:1に達する方。
    • --a-blue-hover: 一段階暗い(ダークデフォルトでは明るい)色で、ラベルが依然として基準を満たすもの。
    • --a-accent-text: light-dark(a, b)、ブランド色相を明度方向にシフトし、各テーマの --a-bg と --a-bg-alt 上で4.5:1に達するまで調整。リンク、アクセントアイブロー、フォーカスリング(>= 3:1)がこれを読み取ります。 インク色のプライマリボタンを持つプリセット(lab、journey)はインクを --a-button-* に保持します。ブランドは依然としてここに配置されます。
  • 1つのアクセント、小さなスコープ: プライマリCTA、フォーカス、リンク、ロゴマーク、小さなバッジ、「おすすめ」マーカー。プリセットが特に許可しない限り、大きなサーフェスや本文テキストには使用しません。ステータスカラーはステータスのみ。
  • ニュートラルなサーフェスは2〜4段階。分離はトーン、ヘアライン、または1つのソフトシャドウレベルで行います。プリセットの指示に従います。
  • テキストは白地に純粋な黒ではありません。本文グレーはAAコントラストを持つ実際のグレーです。
  • どこでもAA: テキストとボタンラベルの塗りつぶし上は4.5:1、大きなテキスト、アイコン、意味を持つ境界線は3:1。
  • ダークモードは反転したパレットではなく、異なるパレットです。浮き上がったサーフェスは1トーン明るく、奥行きにシャドウは使用しません。

レイアウトとリズム

  • コンテンツには上限があります: ワイドグリッド(--a-content-wide)内のテキストカラム(--a-content)、流動的なガター。
  • セクションはページカラーと代替カラーを交互に使用します。タイルはセクションとは反対の塗りつぶしを取ります。
  • プリセットがそう指示する場合は、中央配置のヒーローとセクションオープナー、タイル内のテキストと長いコピーは左揃え。
  • 1ページに1つの見せ場、最大1つの反転(ダークまたはライト)チャプター。ただし、プリセットがバンド上に構築されている場合は除く。

レスポンシブ(厳格なルール: すべての解像度、すべてのプリセット)

  • 流動的なタイポグラフィとスペーシングをクランプトークンから。小さい値は375px、大きい値は1440px。
  • 壊れる可能性のある固定幅や高さは禁止: max-width + ガター、min()、minmax(0, 1fr)、aspect-ratio、min-height。100vh は使用禁止(svh/dvh を使用)。テキストを含むFlex/グリッドの子要素は min-width: 0 を取得。
  • グリッドはスペースで再フロー: repeat(auto-fit, minmax(min(100%, 20rem), 1fr))、デバイスのブレークポイントではない。
  • メディアのスケール: max-width: 100%; height: auto、SVGは viewBox を保持。
  • ナビゲーション: 834px未満(または6つ以上のリンクが収まらなくなったらすぐに: コンテナクエリ)では、テキストリンクは全画面メニュー(ネイティブ popover、JS不要)に移動します。ベースのリンクスタイルを上書きするルールで <li> を隠します(レシピ: グローバルナビ)。マーク、検索、1つのアクションは表示したままにします。テキストリンクがない場合(検索、アカウント、カートのみ): ハンバーガーメニューは不要。
  • どの幅でも水平スクロールバーは禁止。意図的なスクローラーのみ(ギャラリー、レール、コード)が、自身のボックス内でオーバーフローします。
  • タッチターゲット >= 44x44px: 小さなピル、スウォッチ、パドル、ナビリンクは不可視のヒットエリア(.a-hit)を取得します。
  • セーフエリア: viewport-fit=cover、ガターと下部パディングは env(safe-area-inset-*) を使用。
  • 非常に大きな画面: タイポグラフィとコンテンツは上限で停止します。背景は全幅のまま。
  • スマホ横画面: ヒーローはビューポートの高さを必要としてはいけません。スティッキーなものは3分の1以上を覆ってはいけません。
  • 200%ズーム: 半分の幅のビューポートと同じになります。すべてが再フローし、何もクリップされません。

完了と言う前にテスト幅を確認(ブラウザペイン: 各幅に resize_window、スクリーンショット、さらに document.documentElement.scrollWidth === innerWidth と、ビューポートより広い要素のリスト):

幅意味
320小型スマホ、640の200%ズーム
375 / 414標準 / 大型スマホ
768 / 1024タブレット縦 / 横、小型ノートパソコン
1280 / 1440ノートパソコン / デスクトップ(リファレンス幅)
1920 / 2560フルHD / QHD、ウルトラワイド
812x375スマホ横画面
6401280pxの200%ズーム

幅ごとに報告: スクリーンショット撮影、オーバーフローあり/なし、修正内容。ヘッドレスChromeは500px未満のウィンドウをクランプします。スマホの幅はブラウザペインまたは test-widths.html?src=<page url>(同じhttpルート)でテストします。 ヘッドレスキャプチャ: <html> に `data-theme=

関連スキル