Communitygithub.com

Gyschuaner/from-idea-to-personal-site

個人サイトやブログのスタイル方向性が大まかに決まっているが、まだ実装前の段階で使用します。選択した方向性に合った実際のWebサイト、テンプレート、ポートフォリオ、ブログ、スクリーンショット、デザイン例を検索し、利用可能なブラウザやスクリーンショットツールで調査し、その結果を`make-personal-site`のための実用的なデザインリファレンスブリーフにまとめます。自然なテクニカルブログ、居心地の良い研究ホームページ、ブルータリストポートフォリオ、デジタルガーデン、ミニマルなメモサイトなど、まだ具体的な例が必要な任意のビジュアル方向性のリファレンスを見つけるリクエストに使用します。

from-idea-to-personal-site とは?

このスキルは、個人サイトやブログのスタイル方向性が大まかに決まった後、実際の実装に入る前の調査とデザインブリーフ作成に特化しています。ユーザーが選んだ方向性(例:自然なテクニカルブログ、ブルータリストポートフォリオ、デジタルガーデンなど)に基づき、複数の角度から実際のWebサイト、テンプレート、ポートフォリオ、デザイン例を検索します。検索結果から有望なリファレンスをピックアップし、ブラウザやスクリーンショットツールなど利用可能なツールで詳細を調査し、レイアウト、ナビゲーション、色彩、タイポグラフィ、インタラクション、レスポンシブ動作などのデザインパターンを抽出します。最終的には、`make-personal-site`でそのまま使える実践的なデザインブリーフを作成し、どのデザイン要素を採用すべきか、どの要素をコピーすべきでないかを明確にします。このスキルはあくまでリファレンス調査とブリーフ作成に留まり、実際のサイト構築や単一ターゲットの複製は行いません。複数のリファレンスを調査し、抽象的な方向性を具体的なデザイン言語に落とし込むことで、質の高い個人サイト制作を支援します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/find-style-references

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

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

ドキュメント

スタイルリファレンスを探す

目標

選んだ、または大まかに決めた個人サイトのスタイルを、実装に入る前に具体的で検証済みのデザインリファレンスに変換します。

このスキルはリサーチおよびデザインブリーフ作成のスキルです。サイトを構築したり、単一のターゲットWebサイトを複製したりはしません。複数の実際のリファレンスを見つけ、調査し、再利用可能なデザインパターンを抽出し、make-personal-siteで構築可能なブリーフを生成します。

契約

入力:

  • ユーザーのスタイル方向性、テーマワード、サイトタイプ、オーディエンス、コンテンツ範囲、リファレンス、または制約。
  • 含める/避けるべきオプションの例、優先するプラットフォーム/テンプレートソース、ターゲットサイト構造。

出力:

  • 利用可能な場合、4~8個の関連リファレンス候補(ソースURLと簡単な選定理由付き)。
  • ツールが利用可能な場合、選定されたリファレンスに対するブラウザまたはスクリーンショットの観察結果。
  • レイアウト、ナビゲーション、ファーストビュー、記事一覧、記事詳細、プロジェクト/アバウト領域、カラー、タイポグラフィ、画像、モーション、インタラクション、レスポンシブ動作をカバーする実用的なリファレンスブリーフ。
  • 「採用」と「避ける」に関する明確な注記。
  • make-personal-siteへの最終的な構築ハンドオフ。

境界:

  • Webサイトを実装しない。
  • 保護されたソースコード、画像、個人情報、アナリティクスID、ブランドアセットをコピーしない。
  • 1つのリファレンスを複製ターゲットとして扱わない。ユーザーが特定のサイトのコピーを希望する場合は、copy-website-styleにルーティングする。
  • フレームワークのインストールや構築の実現可能性に時間を費やさない。このスキルはデザインリファレンスの調査のみを行う。

成功ゲート:

  • 方向性が具体的なリファレンスに基づいており、make-personal-siteがオリジナルの静的サイトを構築するのに十分具体的である。
  • リファレンス調査に複数の検索角度を使用しており、単一のキーワードではない。
  • ユーザーが明示的に迅速なドラフトを要求した場合を除き、可能な限り少なくとも3つの強力なリファレンスが調査された。
  • 最終ブリーフが、コピーすべきでないコンテンツ/アイデンティティから、再利用可能なデザイン言語を分離している。

ゲート失敗時:

  • より広い、または代替のキーワードで検索する。
  • より少ない、より強力なリファレンスのセットを調査する。
  • 方向性自体がまだ不明確な場合は、search-blog-themeに戻る。
  • 複数のリファレンスファミリーが大きく異なるサイトにつながる場合にのみ、簡潔な好みの質問を1つ行う。

使用すべき時

このスキルは以下の場合に使用します:

  • ユーザーがすでに「自然なテクニカルブログ」「静かな研究ホームページ」「レトロターミナルアーカイブ」「居心地の良いメモサイト」「ブルータリストポートフォリオ」などの大まかな方向性を示している。
  • search-blog-themeが方向性を推奨したが、構築前に実際の例が必要である。
  • from-idea-to-personal-siteが具体的なリファレンスURLではなく、テイストワードからオリジナルサイトを構築しようとしている。
  • make-personal-siteの前にエージェントがより多くのビジュアル的根拠を必要としている。

このスキルは以下の場合には使用しません:

  • ユーザーがまだ方向性を選択していない。search-blog-themeを使用します。
  • ユーザーが1つのターゲットURLを提供し、それを忠実に再現したい。copy-website-styleを使用します。
  • サイトがすでに存在し、小さな変更のみが必要である。edit-site-partを使用します。

ワークフロー

  1. スタイルの方向性を内部で検索可能なキーワードに言い換える。 入力: ユーザーのテイストとサイトの目的。 出力: 複数の角度からの5~10の検索フレーズ。 ゲート: 検索フレーズが、ムード、サイトタイプ、ビジュアルシステム、構造、そして少なくとも1つの代替表現をカバーしている。

  2. 実際のリファレンスを検索する。 入力: 検索フレーズ。 出力: 候補となるWebサイト、テンプレート、ポートフォリオ、ブログ、デザインページ、またはGitHubデモ。 ゲート: ユーザーが明示的に迅速なドラフトを要求した場合を除き、リファレンスを確定する前に少なくとも3つの異なる検索角度を使用する。

  3. 選択したリファレンスを調査する。 入力: 最有力候補。 出力: ブラウザ/スクリーンショットの観察結果。 ゲート: 可能な限り少なくとも3つの強力なリファレンスが調査される。方向性が広い場合は4~6を使用する。

  4. デザインパターンを抽出する。 入力: 調査済みリファレンス。 出力: 再利用可能なパターンとアンチパターン。 ゲート: 注記が、単なる雰囲気ではなく、レイアウト、階層、インタラクション、タイポグラフィ、カラー、コンテンツ密度、レスポンシブ動作に関するものである。

  5. 1つの構築ブリーフを合成する。 入力: リファレンスパターンとユーザーの制約。 出力: make-personal-siteのための簡潔なデザインブリーフ。 ゲート: ブリーフが、追加の調査パスなしで実装できるほど具体的である。

検索ガイダンス

以下の組み合わせから検索を構築します:

  • サイトタイプ: 個人Webサイト、個人ブログ、ポートフォリオ、研究ホームページ、デジタルガーデン、メモサイト、開発者ブログ。
  • ムード: 自然、落ち着いた、エディトリアル、居心地が良い、生々しい、ブルータリスト、ターミナル、アーカイブ、ノートブック、ガーデン、ミニマル、遊び心がある、科学的。
  • 構造: ブログホームページ、記事インデックス、プロジェクトグリッド、サイドナビゲーション、bento、タイムライン、メモアーカイブ、nowページ。
  • ソース: v0テンプレート、Figmaコミュニティ、GitHubテーマ、個人Webサイト、Astro/Hugo/Jekyll/Quartzの例、デザインインスピレーションサイト。

漠然としたフレーズよりも具体的なフレーズを優先します。例:

  • natural developer personal website
  • calm technical blog personal site
  • digital garden nature inspired design
  • research homepage personal website minimal
  • personal blog template notes projects

1つの検索フレーズや最初の魅力的な結果で止まらないでください。サイバーパンクなテクニカルホームページのような方向性の場合、複数の角度から検索してください。例:

  • cyberpunk developer personal website
  • futuristic technical blog personal site
  • terminal cyberpunk portfolio website
  • neon brutalist personal website
  • sci fi interface personal homepage

テンプレート、ポートフォリオ、デザイン例は時間とともに変化するため、現在のWeb検索を使用してリファレンスを検索します。

ブラウザ調査

強力なリファレンスごとに、実際に利用可能なインタラクティブブラウザツールを使用してライブページを調査します。「利用可能」とは、現在のターンで呼び出し可能なツールリストに公開されていることを意味します。Codexでは、ターンにルーティングされた場合、これはBrowser/アプリ内ブラウザプラグインである可能性があります。他のエージェントでは、同等の可視ブラウザ、browser-useツール、またはdevtools対応ブラウザである可能性があります。

インタラクティブブラウザツールが呼び出し可能でない場合、リファレンスがブラウザで視覚的に調査されたふりをしないでください。視覚的なリファレンスの忠実度が重要な場合は、ユーザーにブラウザツールを有効化または呼び出すよう依頼してください。Codexの場合、それは明示的に@browserに言及するリクエストを送信することを意味する可能性があります。ユーザーが再ルーティングしない、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、検索結果スニペット、ソースページ、または記述にフォールバックし、その制限を明記します。

インタラクティブブラウザツールが実際に呼び出し可能な場合、デフォルトでPlaywright、スクリーンショットのみのレビュー、または検索結果スニペットに頼らないでください。スクリーンショットはインタラクティブブラウザパスの後に証拠としてキャプチャできますが、インタラクティブ調査の代わりにはなりません。Playwrightは、インタラクティブブラウザツールが呼び出し可能でない場合、ユーザーが明示的に要求した場合、または繰り返し可能なスクリプト化された比較が特に必要な場合にのみ、フォールバックとして使用します。

チェック項目:

  • ファーストビューポート: すぐに何が役立つか?
  • ナビゲーション: トップナビ、サイドナビ、コマンド/メニュー、タグ、検索、アーカイブリンク。
  • コンテンツモデル: 投稿、メモ、プロジェクト、アバウト、リンク、レコード、now、ガーデン、履歴書。
  • 読みやすさ: 記事幅、タイポグラフィ、コードブロック、数式、画像、脚注、目次。
  • ビジュアルシステム: パレット、スペーシング、ボーダー半径、密度、カード、区切り線、テクスチャ、画像。
  • モーションとインタラクション: ホバー状態、テーマ切り替え、フィルター、検索、スクロール効果、ページトランジション。
  • レスポンシブ動作: モバイルではどうなるべきか?
  • リスク: 何が読みにくくなりすぎるか、一般的すぎるか、重くなりすぎるか、ソースに近くなりすぎるか?

ブラウザツールが利用できない場合は、ソースページ、検索結果スニペット、スクリーンショット、記述メモを使用し、視覚的調査が制限されたことを明記します。

出力形式

応答は自然で有用に保ちます。長い非表示のプロセスログを公開しないでください。

以下を含めます:

  • 簡単な推奨: 構築すべき最も強力な方向性。
  • リファレンス: 4~8項目(URL/ソースと、それぞれが重要である理由)。
  • 採用: 適応すべき具体的なパターン。
  • 避ける: コピーすべきでないもの、またはユーザーのサイトに悪影響を与えるもの。
  • 構築ブリーフ: make-personal-siteのための正確な方向性。
  • ハンドオフ: 推奨される次のスキルと、あればソース制約。

ユーザーが簡単な回答を求めた場合は、最良の3~5のリファレンスと1つのブリーフに出力を圧縮します。

構築ブリーフ要件

最終ブリーフは以下を指定する必要があります:

  • サイトアイデンティティ: サイトが一言でどのように感じられるべきか。
  • ページ範囲: ホーム、ブログインデックス、投稿詳細、プロジェクト、アバウト、メモ/レコード、リンク、またはその他のページ。
  • ファーストビュー: どのような有用なコンテンツがすぐに表示されるか。
  • レイアウト: ナビゲーション、コンテンツカラム、サイドバー、カード/リスト、アーカイブ構造。
  • ビジュアルシステム: カラーパレット、タイプスタイル、スペーシング、ボーダー、画像、アイコンスタイル。
  • インタラクション: テーマ切り替え、フィルター/検索、コピーボタン、ホバー状態、オプションのモーション。
  • レスポンシブ動作: モバイルナビゲーションとコンテンツの優先順位。
  • コピーしないもの: オリジナルの個人情報、記事、アセット、ロゴ、プロプライエタリコード、アナリティクス、または正確なブランド処理。

ハンドオフ

ブリーフの準備ができたら:

  • オリジナルサイトの構築はmake-personal-siteにルーティングします。
  • 単一サイトのクローン再現はcopy-website-styleにルーティングします。
  • 未解決の方向性の選択はsearch-blog-themeに戻します。

Individual skills in this repo

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

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

関連スキル