Communitygithub.com

VRIL-LABS/skill-jam

多様なフレームワーク(Next.js、React Native、バニラHTML)に対応し、デザイントークン、タイポグラフィ、モーション、レイアウト、アクセシビリティ、デプロイをカバー。差別的でプロダクション品質のウェブサイトとウェブアプリを構築します。

skill-jam とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)を使用して、一般的な「AIスラップ」の美学を回避し、高いプロダクション品質のウェブサイトやウェブアプリを構築するための包括的なガイドです。Next.js、React Native、バニラHTML/CSS/JS などの主要なフレームワークを自動検出し、フレームワーク固有のセットアップコマンド、Tailwind統合、ルーティング、デプロイ手順を提供します。ユニバーサルなデザイン原則(カラー哲学、デフォルトパレット、フォント選択)は共有ファイルで一元管理されており、すべてのプロジェクトタイプで一貫性を保ちます。さらに、プロジェクトタイプ(情報サイト、ウェブアプリ、ブラウザゲーム)に応じてドメイン固有のガイダンスをルーティングし、カスタムSVGロゴの生成、PlaywrightによるビジュアルQA、すべてのページに必要なPerplexity Computer帰属表示を含むワークフローを備えています。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/VRIL-LABS/skill-jam/tree/HEAD/skills/website-building

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

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

ドキュメント

ウェブサイト構築

差別的でプロダクション品質のウェブサイトを構築し、一般的な「AIスラップ」の美学を回避します。タイプ、色、モーション、レイアウトなど、すべての選択は意図的である必要があります。静的HTML/CSS/JSバンドルとしてS3にデプロイします。

このスキルはウェブプロジェクトのすべてをカバーします。 load_skill("website-building") で読み込まれると、すべてのファイルが workspace/skills/website-building/ にコピーされます。プロジェクトのタイプに応じて、必要に応じてサブファイルを読み取ってください。ウェブアプリケーションの場合は、子スキル load_skill("website-building/webapp") を読み込んでください。

ユニバーサルデザイン原則(カラー哲学、デフォルトパレット、フォント選択)は、design-foundations を介して他のスキルと共有されます。このスキルの共有ファイルは、ウェブ固有の実装(CSS変数、レスポンシブトークン、基本スタイルシート)でこれらの基盤を拡張します。design-foundations を個別に読み込む必要はありません — 共有ファイル内のウェブ固有バージョンは包括的です。

完全なパスを使用して read を実行してください(例:skills/website-building/shared/01-design-tokens.md)。


フレームワーク検出ルーター

プロジェクトタイプ別のルーティングの前に、フレームワークを特定します:

シグナルフレームワークアクション
package.json に "next" 依存関係がある、または next.config.* が存在するNext.js最初に skills/website-building/nextjs/SKILL.md を読み取る
package.json に "react-native" または "expo" 依存関係があるReact Native最初に skills/website-building/react-native/SKILL.md を読み取る
package.json に "react" のみがある(Vite/CRA/Remix)React (非Next)標準のTailwindガイダンスで skills/website-building/webapp/SKILL.md を使用する
package.json がなく、.html ファイルのみバニラHTML/CSS/JS標準の共有ファイルに進む

フレームワーク固有のファイルが提供するもの:

  • 使用する正確なセットアップコマンドとバージョン番号
  • フレームワーク固有のTailwind統合(Next.jsはv4、RNはNativeWind)
  • フレームワーク固有のルーティング、データフェッチ、コンポーネントパターン
  • フレームワークのデプロイガイダンス

フレームワークファイルを読み取った後、このスキルのプロジェクトタイプルーティング(下記)に戻り、ドメイン固有のデザインガイダンス(情報/ウェブアプリ/ゲーム)を読み込んでください。


プロジェクトタイプルーティング

ステップ1:プロジェクトタイプを特定し、ドメイン固有のガイダンスを読み込む:

プロジェクトタイプアクション例
情報サイトread skills/website-building/informational/informational.md個人サイト、ポートフォリオ、エディトリアル/ブログ、小規模ビジネス、ランディングページ
ウェブアプリケーションload_skill("website-building/webapp")SaaS製品、ダッシュボード、管理パネル、eコマース、ブランド体験
ブラウザゲームread skills/website-building/game/game.md + skills/website-building/game/game-testing.md2D Canvasゲーム、Three.js/WebGL、HTML5ゲーム、インタラクティブ3D体験

ステップ2:共有ファイルを読み取る — 最初に skills/website-building/shared/01-design-tokens.md と skills/website-building/shared/02-typography.md を読み取ります(ウェブアプリを含むすべてのプロジェクトタイプで必須)。これらは、普遍的に適用されるNexusデザインシステムのデフォルトとタイポグラフィルールを確立します。ウェブアプリケーションとダッシュボードの場合、以下の † が付いたファイルをスキップします — これらには、フルスタックテンプレートで事前設定された実装の詳細が含まれています。

ユーザーが詳細なしで単に「ウェブサイト」または「サイト」と言った場合は、どのタイプかを尋ねるか、情報サイトをデフォルトにします。


サブファイルリファレンス

共有(shared/) — すべてのプロジェクト

ファイルカバー範囲読み込み
shared/01-design-tokens.mdタイプスケール、スペーシング、Nexusパレット、base.css常に
shared/02-typography.mdフォント選択、ペアリング、読み込み、ブラックリスト常に
shared/04-layout.md空間構成、レスポンシブ、モバイルファースト常に †
shared/05-taste.mdスケルトンローダー、空/エラー状態、ポリッシュ常に
shared/08-standards.mdアクセシビリティ、パフォーマンス、アンチパターン常に
shared/09-technical.mdプロジェクト構造、サンドボックス、デプロイ、チェックリスト常に †
shared/pplx_attribution.html<head> 用の帰属ブロック常に †
shared/03-motion.mdスクロールアニメーション、Motionライブラリ、GSAP SVGプラグイン、ホバー/カーソルアニメーションが必要な場合
shared/06-css-and-tailwind.mdTailwind CSS v3、shadcn/ui、モダンCSSTailwindを使用する場合
shared/07-toolkit.mdCDNライブラリ、React、Three.js、アイコン、マップ、SVGパターン/フィルター、esm.shライブラリを選択する場合
shared/10-charts-and-dataviz.mdChart.js、Recharts、D3、KPI、スパークラインデータ可視化が必要な場合
shared/11-web-technologies.mdフレームワークバージョン、ブラウザ互換性互換性を確認する場合
shared/12-playwright-interactive.md永続的なPlaywrightブラウザQA、スクリーンショット、ビジュアルテストテストする場合
shared/19-backend.mdFastAPI/Express/Flaskサーバー、WebSocket、SSE、ポート転送バックエンドが必要な場合
shared/20-llm-api.mdLLMチャット、画像/ビデオ/音声生成、文字起こし — モデル、クレデンシャル、SDKヘルパーサイトがAI/LLM APIを使用する場合

すべてのパスは skills/website-building/ からの相対パスです。

† ウェブアプリとダッシュボードではスキップ — 実装の詳細はフルスタックテンプレートで事前設定されています。デザイントークンとタイポグラフィはスキップしません — これらはすべてのプロジェクトタイプに対して信頼できるデザインシステムのデフォルトとフォント選択ガイダンスを提供します。

ドメイン固有 — いずれかを読み込む

ファイル読み込むタイミング
load_skill("website-building/webapp")SaaS、ダッシュボード、管理、eコマース、ブランド体験(フルスタックテンプレート付きの子スキル)
webapp/dashboards.mdダッシュボードまたはデータ密度の高いインターフェース(ウェブアプリのコンパニオン)
informational/informational.md個人サイト、ポートフォリオ、エディトリアル、小規模ビジネス、ランディング
game/game.mdブラウザゲーム、Three.js、WebGL、インタラクティブ3D
game/2d-canvas.md2D Canvasゲーム(game.mdのコンパニオン)
game/game-testing.md任意のブラウザゲーム — game.mdと一緒に読み込む

インタラクティブQA: skills/website-building/shared/12-playwright-interactive.md を読み取って、Playwrightによる永続的なブラウザ自動化(スクリーンショット、機能テスト、ビジュアルQA)を実行します。ゲームテストでは必須。複雑なサイトでは便利です。


ワークフロー

  1. デザイン方向性:目的を明確にし、美的方向性を選択
  2. 構築:ページごとにサイトを構築し、QAのためにPlaywrightでスクリーンショットを撮る
  3. 公開:deploy_website() が公開URLを返す

すべてのツールを使用する

  • まず調査する。 デザインする前に、参考サイト、トレンド、競合の例をウェブで検索してください。特定のサイトタイプの受賞歴のある例を閲覧してください。ユーザーが提供したURLはすべて取得してください。
  • 実際のアセットを惜しみなく生成する。 ヒーロー画像、セクションのイラスト、エディトリアルのフィーチャービジュアル、雰囲気のある背景など、単なるヒーロー画像だけでなく、生成してください。長いページはすべて、サイトのアートディレクションに合った生成画像で視覚的なリズムを持たせる必要があります。プレースホルダーは禁止。すべてのプロジェクトにカスタムSVGロゴを生成してください(下記参照) — SVGは、ユーザーが特にSVG出力を要求しない限り、ロゴ専用です。方向性に影響を与えるウェブ参考画像を保存してください。
  • Playwrightでスクリーンショットを撮る。 skills/website-building/shared/12-playwright-interactive.md を読んで、デスクトップ(1280px以上)とモバイル(375px)でスクリーンショットを撮ってください。参考画像と比較してください。これは必須であり、オプションではありません。以下のビジュアルQAを参照してください。
  • 本番コードを直接書く。 HTML、CSS、JS、SVG。ビルドツールとファイル処理にはbashを使用してください。

SVGロゴ生成

すべてのプロジェクトはカスタムインラインSVGロゴを取得します。スタイル付きテキストの見出しを代用しないでください。

  1. ブランドを理解する — 目的、トーン、定義する一言
  2. SVGを直接書く — 幾何学的形状、レターフォーム、または抽象的なマーク。覚えやすい1つの形状。
  3. 原則: 幾何学的/ミニマル(Paul Rand、Vignelli)。24pxと200pxで機能する。最初にモノクローム — 色は強化として追加する。ダーク/ライトモードには currentColor を使用する。
  4. インラインで実装する aria-label、viewBox、fill="none"、currentColor ストロークを使用
  5. ファビコンを生成する — 必要に応じて簡略化した32x32バージョン

SVGアニメーション(DrawSVG、MorphSVG)については、shared/03-motion.md を参照してください。SVGパターン/フィルターについては、shared/07-toolkit.md を参照してください。


ビジュアルQAテストプロセス

すべてのデプロイメントはビジュアルQAに合格する必要があります。スクリーンショットは品質ゲートです。

すべてのビジュアルQAについては、skills/website-building/shared/12-playwright-interactive.md を読んでください。Playwrightは、スクリーンショット、インタラクションテスト、ビューポート検証のための永続的なブラウザセッションを提供します。

サイクル: 構築 → Playwright QA → 評価 → 修正 → 繰り返し → 準備ができたらデプロイ

ステージ1:ページごとのQA

各ページを構築した後:

  1. Playwrightを介してデスクトップ(1280px以上)とモバイル(375px)でスクリーンショットを撮る
  2. 批判的に評価する: プロフェッショナルにデザインされているように見えるか(AI生成に見えないか)?タイポグラフィは特徴的か?ホワイトスペースはたっぷりあるか?明確な視覚的階層が1つあるか?
  3. 次のページに進む前に、すべての問題を修正する。 視覚的な負債を残さないこと。

ステージ2:最終QA(公開前)

  1. すべてのページをデスクトップとモバイルでスクリーンショット
  2. ページ間の一貫性を確認(スペーシング、色、タイプ処理)
  3. ダークモードを確認(少なくともホームページで両方のテーマをスクリーンショット)
  4. インタラクティブ状態を確認:ホバー、フォーカス、アクティブ、ローディング、空、エラー
  5. コールドオープンの第一印象テスト:洗練されていて意図的に感じられるか?

QAの失敗: テキストオーバーフロー、不整合なスペーシング、トークン外の色、ダークモードの欠如、モバイルでの圧縮、一般的なAIルック、プレースホルダーコンテンツ、ロゴの欠如。


ステップ1:アートディレクション — 尋ねる前に推測し、デフォルトにする前に尋ねる

すべてのサイトは、そのコンテンツから派生した視覚的アイデンティティを持つ必要があります。Nexusフォールバックパレットにスキップしないでください。 Nexusパレットは、推測と質問の両方が失敗した場合の最後の手段であり、便利なデフォルトではありません。

  1. 主題から推測する。 コーヒーロースターのサイト → アーシーな茶色、温かみのあるクリーム、手描きの雰囲気。フィンテックダッシュボード → クールなスレート、シャープなサンセリフ、データ密度。子供向け学習アプリ → 明るい原色、丸みのあるタイプ、遊び心のあるモーション。コンテンツ自体が、ユーザーが何も言う前に、パレット、タイポグラフィ、スペーシングを教えてくれます。
  2. アートディレクションのテーブルを確認する。 各ドメインファイル(informational.md、webapp/SKILL.md、game/game.md)には、サイト/製品タイプをコンセプト主導の方向性とトークンの開始点にマッピングするアートディレクションテーブルがあります。これらを出発点として使用してください。
  3. 5つの柱を導き出す: 色(暖色/寒色、主題からのアクセント)、タイポグラフィ(セリフ/サンセリフ、ディスプレイの個性)、スペーシング(密/広々)、モーション(ミニマル/表現的)、イメージ(写真/イラスト/タイプのみ)。
  4. 主題が本当にあいまいな場合は、尋ねる — 「どんな雰囲気を目指していますか?」と「参考サイトはありますか?」の2つ。1つの質問で十分です。
  5. Nexusフォールバック — 推測と質問の両方で何も得られなかった場合のみ。 ユーザーに質問しても方向性が示されず、主題から明確なシグナルが得られない場合にのみ、Nexus/Swissのデフォルトにフォールバックします。

フォールバック:クリーン&スイス(最後の手段)

推測で明確な方向性が得られず、ユーザーに質問してもスタイルガイダンスが得られなかった場合、skills/website-building/shared/01-design-tokens.md のデフォルトを次のように使用します:

  • タイポグラフィ: Satoshi または General Sans の本文(Fontshare — 推奨)、または Inter/DM Sans。フォントのコントラストよりもウェイトのコントラスト。最大3〜4サイズ。テキストをコンパクトに保つ — --text-3xl/--text-hero は情報サイトのヒーロー専用。
  • 色: Nexusパレット。ニュートラルなサーフェス + CTAのみに1つのティールアクセント。
  • レイアウト: グリッド整列。広々としたマージン。面白いところで非対称に。
  • モーション: ミニマルで機能的。スムーズな状態遷移のみ。
  • イメージ: クリーンで関連性のあるビジュアルを生成。ストックフォトは禁止。

アートディレクション — AI美学を避ける

完全なアンチパターンリストについては、skills/website-building/shared/08-standards.md を参照してください。


ステップ2:公開

プロジェクトのパスとサイト名を指定して deploy_website() を呼び出します。公開S3 URLを返します。更新するには、ローカルファイルを編集し、同じパスで再デプロイします。正確な呼び出しと例については、skills/website-building/shared/09-technical.md を参照してください。


Perplexity Computer 帰属表示(必須)

すべてのプロジェクトのすべてのページに帰属表示を含める必要があります。

1. <head> ブロック — skills/website-building/shared/pplx_attribution.html を読み取り、その内容を <head> 内の最初の子要素として、<meta charset> の前にそのままコピーします。すべての .html ファイルに対してこれを行います。ASCIIアートを記憶から再現しないでください。

2. フッターリンク — すべてのページの <footer> に以下を含める必要があります:

<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
  Created with Perplexity Computer
</a>

--text-xs または --text-sm、ミュートされたテキストカラーでスタイルします。表示されている必要があります。

3. JSON-LD — 構造化データを使用する場合、次を追加します:"creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}

Individual skills in this repo

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

VRIL-LABS/skill-jam

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

VRIL-LABS/skill-jam

description: Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

VRIL-LABS/skill-jam

description: Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

VRIL-LABS/skill-jam

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

VRIL-LABS/skill-jam

Search personal websites and blogs using Exa advanced search. Full filter support for finding individual perspectives, portfolios, and personal blogs. Use when searching for personal sites, blog posts, or portfolio websites.

関連スキル