Communitygithub.com

個人サイト作成/Gyschuaner/from-idea-to-personal-site

ユーザーがプレーンなHTML、CSS、JavaScriptを使い、ゼロ依存の個人サイト、ブログ、ポートフォリオ、研究ホームページなどを新規作成・実装・リデザイン・更新する際に使用します。テーマの方向性が決まった後、またはブラウザで直接開け、静的ファイルとしてデプロイできるノーフレームワークサイトをユーザーが希望する場合に使用します。

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

このスキルは、フレームワークやビルドツール、パッケージに一切依存しない、プレーンな静的サイト(HTML/CSS/JavaScript)の個人サイトを作成・リデザインするためのものです。ユーザーがテーマの方向性を選んだ後の実装ステップとして機能し、テーマの提案、ユーザープロフィール、サンプル記事、既存の静的フォルダなどを、すぐに動作する個人サイトに変換します。 このスキルが特に役立つのは、ユーザーがシンプルで依存関係のないサイトを求めている場合、既存の静的サイトを依存関係を保ったままリデザインしたい場合、または`search-blog-theme`で出力されたテーマの方向性を実装したい場合です。主な成果物は、`index.html`を直接開いてプレビューできる静的フォルダ(生成されたHTML/CSS/JSファイルやアセットを含む)と、将来の編集を容易にするための`EDITING.md`です。 スキルは明確なパイプラインに従い、まずサイトの目的とページ構成を明確にし、共有シェル(ヘッダー、ナビゲーション、CSS変数)を構築し、各種ページ(ホーム、アバウト、ブログ、プロジェクトなど)を作成し、最後にページ相対パスでのリンク互換性とHTTP経由でのローカル検証を行います。パスは`index.html`の直接開封、ローカルHTTPサーバー、および一般的な静的ホスティングサービスで正しく動作するように設定されます。 このスキルは、Next.jsやAstroのような特定のフレームワークをユーザーが明示的に要求した場合や、特定のウェブサイトを詳細に模倣する必要がある場合(その場合は`copy-website-style`を使用)、大規模なコンテンツ移行が必要な場合(`add-blog-posts`を使用)、またはデプロイ作業が必要な場合(`publish-static-site`を使用)には使用すべきではありません。

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

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

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

ドキュメント

個人サイトを作成する

目標

個人ウェブサイトをプレーンな静的ファイル(HTML、CSS、必要に応じてバニラJavaScript)として作成またはリデザインします。

このスキルは、視覚的な方向性が決まった後の実装ステップです。テーマの推奨、ユーザープロフィール、メモ、サンプル記事、プロジェクトの説明、または既存の静的サイトフォルダを、実際に動作する個人サイトに変換します。

核となる約束:

  • フレームワーク不要。
  • ビルドステップ不要。
  • パッケージインストール不要。
  • ランタイム依存関係なし。
  • index.htmlを直接開いて手動プレビュー可能。
  • ページ相対リンクとアセットを使用し、直接ファイルを開く、ローカルHTTP、静的ホスティングのすべてで動作。
  • フォルダを静的ホスティングにデプロイ可能。

自動ブラウザQAの場合は、file:// URLではなく、静的フォルダをローカルHTTPで提供します。

契約

入力:

  • テーマの方向性、ユーザープロフィール素材、必要なページ、サンプルコンテンツ、または既存の静的フォルダ。
  • 高忠実度の再現を要求せずにスタイルのガイドとなるオプションの参考資料。
  • 希望する出力フォルダと静的ファイルの制約。

出力:

  • HTML、CSS、オプションのバニラJavaScript、ローカルアセット、代表的なページタイプを含むプレーンな静的サイトフォルダ。
  • 新しいサイトまたは大幅なリデザインを作成した場合の将来の編集のためのEDITING.md。
  • ローカルプレビュー手順と検証サマリー。

境界:

  • 特定のターゲットウェブサイトを厳密に再作成しないでください。copy-website-styleを使用してください。
  • 大規模な文章アーカイブをインポートしないでください。add-blog-postsを使用してください。
  • 公開やホスティング設定を行わないでください。publish-static-siteを使用してください。
  • ユーザーが明示的に要求しない限り、フレームワーク、パッケージインストール、バックエンド、CMS、認証、データベースを導入しないでください。

成功ゲート:

  • 必須のページタイプが存在し、ナビゲーションが実際の相対パスを指していること。
  • サイトがビルドステップなしでプレーンな静的ファイルとして動作すること。
  • ソースがUTF-8で読み取り可能であり、プレースホルダーが明確であり、review-static-siteが合格するか、承認された制限のみを報告すること。

ゲートに失敗した場合:

  • 不足しているページタイプ、パス、アセット、エンコーディング、プレースホルダー、またはブラウザの問題をこのスキル内で修正します。
  • 失敗がユーザーのアイデンティティ/コンテンツの欠落である場合は、personalize-siteを使用します。
  • 修正後、再度review-static-siteを使用します。

簡易パイプライン

個人サイトの新規作成作業には、以下のパイプラインに従ってください:

  1. サイトの目的、テーマの方向性、利用可能なコンテンツ、ページ範囲を明確にします。
  2. コーディング前に、静的ページマップとプレースホルダー戦略を決定します。
  3. 最初に共有シェル(ヘッダー、ナビゲーション、メインレイアウト、フッター、グローバルCSS変数、共有インタラクション)を構築します。
  4. ホームページと、要求されたまたは暗示されるすべてのページタイプを実装します。
  5. ユーザーのコンテンツまたは明確に置き換え可能なプレースホルダーを使用します。詳細な個人情報を捏造しないでください。
  6. 将来のモデル/ユーザーによる編集のための編集ガイドを追加します。
  7. 相対リンクとアセットを使用した直接開封パスの互換性を確認します。
  8. 実際のブラウザでHTTP経由でローカル検証します。
  9. 最終納品前に、リンク、アセット、ページタイプ、UTF-8ソースの読みやすさを確認します。

使用する場合

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

  • ユーザーがプレーンなHTML/CSS/JSの個人サイト、ブログ、ホームページ、ポートフォリオ、研究ホームページ、または静的ウェブサイトを希望する場合。
  • search-blog-themeで生成されたテーマの方向性を実装するように依頼された場合。
  • 検査、編集、デプロイが簡単なシンプルなノーフレームワークサイトを希望する場合。
  • 依存関係のない状態を保ちながら、既存の静的サイトをリデザインしたい場合。
  • 大まかな視覚的参考資料を提供するが、高忠実度の再現を必要としない場合。

使用しない場合

以下の場合にはこのスキルを使用しないでください:

  • ユーザーがテーマを検索したり、視覚的な参考資料を比較したいだけの場合。search-blog-themeを使用してください。
  • 特定のウェブサイトの見た目、レイアウト、動き、または操作感を厳密に再現したい場合。copy-website-styleを使用してください。
  • 多数の記事を移行したり、Obsidianノートを変換したり、フロントマターを修復したり、大規模なコンテンツアーカイブを移動したい場合。add-blog-postsを使用してください。
  • デプロイ、DNS、GitHub Pages、Cloudflare Pages、Cloudflare Pages Direct Upload、Netlify、Vercelのヘルプのみを希望する場合。publish-static-siteを使用してください。
  • ユーザーがNext.js、Astro、Hugo、Jekyll、Quartz、Reactなどのフレームワークプロジェクトを明示的に要求した場合。
  • ユーザーがバックエンド、データベース、認証、CMS、コメントシステム、または動的サーバー動作を要求した場合。

入力

ユーザーが提供するものを使用します。詳細が不足していてもブロックしないでください。

有用な入力例:

  • テーマの方向性: プライベートコードアーカイブ、研究ログダッシュボード、デジタルガーデン、ベントーポートフォリオ、フィールドノートブック、パーソナルオペレーティングシステムなど。
  • ユーザープロフィール: 名前、短い経歴、役割、場所、ソーシャルリンク、アバター、履歴書、出版物、プロジェクト。
  • 必要なページ: ホーム、アバウト、ブログ、プロジェクト、ノート、出版物、お問い合わせ。
  • サンプルコンテンツ: 1~3件の記事、プロジェクトの説明、Markdownスニペット、古いHTMLページ。
  • 既存のサイトフォルダ: 維持またはリファクタリングする現在のHTML/CSS/JSファイル。
  • 大まかな参考資料: v0、Figma、GitHubテーマ、フレームワークテンプレート、スクリーンショット、ムード参考資料。

参考資料ルール

参考資料はどのスタックからでも提供される可能性があります。これらを実装の選択ではなく、視覚的および構造的な参考資料として扱います。ユーザーがそのフレームワークの使用を明示的に要求した場合を除きます。

プレーンな静的サイトの場合、参考資料を次のように変換します:

  • React、Next、Astroコンポーネント -> 再利用可能なCSSクラスを持つ繰り返しHTMLセクション。
  • Tailwindユーティリティクラス -> assets/style.css内の通常のCSSルール。
  • フレームワークルート -> リンクされた.htmlファイル。
  • コンテンツコレクションまたはCMSデータ -> 静的HTMLリストまたは小さなJSONファイル。
  • テーマ設定 -> CSSカスタムプロパティ。
  • シンプルなインタラクション -> 有用な場合にのみバニラJavaScript。

ユーザーが特定のウェブサイトを厳密に一致させたい場合は、大まかな参考資料として扱う代わりに、copy-website-styleに引き継ぎます。

デフォルトのサイト構造

新しいサイトの場合、ユーザーが別の指定をしない限り、以下の構造を推奨します:

site/
  index.html
  EDITING.md
  about.html
  blog.html
  projects.html
  posts/
    first-post.html
  assets/
    style.css
    script.js
    images/
  data/
    posts.json
    profile.json

既存のサイトの場合は、実用的な範囲でユーザーの現在の構造を維持します。要求された作業を明確に改善する場合を除き、サイトの大部分をリネームしたり再編成したりしないでください。

ページの期待

ユーザーの要求に必要なページのみを作成します。完全な個人サイトスターターの場合、以下を含めます:

  • ホーム: アイデンティティ、短い紹介、テーマ固有のヒーローエリア、最近の投稿、厳選プロジェクト。
  • アバウト: 経歴、関心、スキル、お問い合わせ、ソーシャルリンク、オプションの履歴書/出版物。
  • ブログインデックス: タイトル、日付、タグ、サマリー付きの記事リスト。
  • 記事ページ: タイトル、日付、タグ、コンテンツ、ブログインデックスへのナビゲーションを備えた読みやすい記事レイアウト。
  • プロジェクト: 説明、スタック、リンク、成果を備えたプロジェクトカードまたは行。

最初の画面を有用に保ちます。ユーザーが個人サイトやブログを要求したのに、マーケティング用ランディングページを作成しないでください。

完全な個人サイトまたはブログスターターの場合、単一のホームページで停止しないでください。コンテンツがプレースホルダーのみの場合でも、動作する代表的なページタイプを作成します:

  • ブログの場合は少なくとも1つの記事/詳細ページ。
  • サイトの一部に記事、ノート、プロジェクト、出版物が含まれる場合は、リストまたはアーカイブページ。
  • ホームページがアイデンティティや背景詳細にリンクしている場合は、プロフィール/アバウトページ。
  • 選択されたコンセプトによって暗示される特別なページ(ノート、リンク、ガーデン、Now、Uses、出版物、実験など)。

大規模な将来のコンテンツコレクションの場合は、完全なアーカイブを捏造するのではなく、構造と少数の代表的なプレースホルダーエントリを作成します。

パス互換性ルール

生成されたプレーンな静的サイトは、ユーザーがindex.htmlを直接開いた場合、ローカルHTTPで提供された場合、一般的な静的ホストにデプロイされた場合に動作する必要があります。

デフォルトルール:

  • すべてのサイトローカルリンクとアセットにページ相対パスを使用します。
  • ルートページからは、CSS/JS/画像をassets/style.css、assets/script.js、assets/images/avatar.pngとしてリンクし、ページをabout.htmlまたはposts/example.htmlとしてリンクします。
  • posts/example.htmlなどのネストされたページからは、共有アセットを../assets/style.cssとして、ルートページを../blog.htmlまたは../index.htmlとしてリンクします。
  • ユーザーがサーバールートのみの動作を明示的に受け入れない限り、/assets/style.css、/assets/script.js、/posts/example.html、/data/posts.json、/images/foo.png、/などのルート絶対パスを使用しないでください。
  • CSS url(...)、ファビコン、Open Graph画像、カバー画像、フォント、KaTeX/数式ベンダーアセット、RSS/サイトマップリンク、JavaScript生成URLにも同じルールを適用します。
  • ページを移動または追加する場合、ルートページからリンクをコピーするのではなく、そのページのフォルダの深さに基づいてパスを再計算します。

サーバーのみの前提を避ける:

  • 直接開封プレビューが約束の一部である場合、コアナビゲーション、記事リスト、ホームページコンテンツにfetch("data/posts.json")などのローカルファイルフェッチに依存しないでください。
  • 繰り返しデータが有用な場合は、コンテンツを直接HTMLにレンダリングするか、相対<script src="assets/script.js">で読み込まれるローカルJavaScriptオブジェクトにデータを保存します。
  • オプションの拡張機能は、そのフェッチがなくてもページが正しく読み取りおよびナビゲートできる場合にのみ、データファイルを使用しても構いません。

スタイルルール

選択したテーマに視覚言語を導かせますが、サイトを読みやすく、保守しやすい状態に保ちます。

  • サイト全体のスタイルをassets/style.cssに配置します。
  • 色、スペーシング、境界線、タイポグラフィの選択にCSSカスタムプロパティを使用します。
  • 可能な限りセマンティックHTMLを使用します: header、nav、main、article、section、footer。
  • レスポンシブレイアウトルールを使用して、ページがモバイルとデスクトップで動作するようにします。
  • テーマが視覚的に強い場合は、記事ページをホームページよりも落ち着いたものにします。
  • ユーザーが特定のフォントを要求した場合、またはテーマが強く必要とする場合を除き、システムフォントを優先します。
  • ユーザーが提供するか、明確に許容できる場合を除き、リモートアセットに依存しないでください。
  • 装飾効果が読書、ナビゲーション、アクセシビリティを妨げないようにします。

インタラクションルール

明確な価値を追加する場合にのみ、バニラJavaScriptを使用します。

良い使用例:

  • モバイルナビゲーションの切り替え。
  • テーマの切り替え。
  • 軽量なタグまたは記事のフィルタリング。
  • コアな読書に影響を与えない小さなプログレッシブエフェクト。

避けるべきこと:

  • 重いアニメーションフレームワーク。
  • ユーザーが明示的に要求しない限り、キャンバスを多用した装飾。
  • 開発サーバーやパッケージインストールを必要とするエフェクト。
  • 読書を妨げる継続的なちらつき、攻撃的なグリッチ、またはスクロールエフェクト。

アニメーションテーマの場合は、prefers-reduced-motionを尊重します。

静的簡略化ルール

大まかな参考資料に複雑なまたはフレームワーク依存の機能がある場合、それらをより単純な静的同等物に変換します:

  • 3D地球儀 -> トピックマップ、ステータスパネル、プロジェクトコンステレーション、または静的な視覚ブロック。
  • アニメーションベントグリッド -> 微妙なホバー状態を持つレスポンシブCSSグリッド。
  • ターミナルシミュレーター -> テーマに沿ったナビゲーションとログ形式のコンテンツ。有用でない限り、偽のコマンドラインは使用しません。
  • ナレッジグラフ -> タグ、関連記事、トピックインデックス、または手動でキュレーションされたリンク。
  • 動的検索 -> シンプルなフィルター入力、静的タグページ、または最初のバージョンでは検索なし。
  • CMS駆動の記事 -> posts/*.html と data/posts.json。

過剰に構築された参考資料のコピーよりも、ユーザーの望む感覚を捉えたクリーンな静的バージョンを優先します。

既存サイトルール

既存のサイトを変更する場合:

  • 編集前に現在のファイル構造を確認します。
  • ユーザーのコンテンツと無関係なファイルを保持します。
  • 変更を要求されたページとアセットに限定します。
  • 既存の視覚的慣例がすでに機能している場合は、それを再利用します。
  • ユーザーが完全なリデザインを要求しない限り、サイト全体を置き換えないでください。
  • サイトにすでにstyle.cssまたはscript.jsがある場合は、競合する重複を作成する代わりに、それらを注意深く拡張します。

コンテンツルール

少量的なコンテンツの場合は、静的HTMLを直接記述します。

記事やプロジェクトなどの繰り返しコンテンツには、以下のいずれかを使用します:

  • リストが短い場合は、静的に繰り返しHTML。
  • 保守性が向上する場合は、ローカルJavaScriptデータオブジェクトとバニラJavaScriptレンダリング。
  • その機能にローカルHTTP/静的ホスティングが必要であることが許容され、コアページがそれなしでも動作する場合にのみ、小さなJSONファイル。

詳細な個人情報を捏造しないでください。ユーザーデータがない場合は、プレースホルダーを明確に使用します。

プレースホルダーを簡単に見つけて置き換えられるようにします。繰り返しコンテンツは、data/*.json、assets/script.js内の文書化されたデータブロック、または安定したクラス名を持つ繰り返しHTMLセクションなど、明確に名前が付けられた場所に保存することを優先します。

プレースホルダーのみのテキスト、デモ記事、サンプルプロジェクト、モックリンクを、ユーザーまたは将来のモデルが公開前に置き換えられるように、ファイルまたはEDITING.mdに明確にマークします。

編集ガイドルール

新しいサイトを作成するか、既存のサイトを大幅にリデザインする場合は、出力フォルダにEDITING.mdを含めます。

EDITING.mdは、主に後で生成されたサイトを変更する将来のモデルまたはエージェント向けです。簡潔でありながら具体的に保ちます。以下を説明します:

  • フォルダ階層と各ファイル/フォルダの目的。
  • サイトで使用されるファイル形式: HTML、CSS、JS、JSON/データブロック、画像。
  • ページマップ: どの生成ファイルがホーム、アバウト/プロフィール、ブログ/リスト、記事/詳細、プロジェクト、ノート、リンク、またはその他のページタイプであるか。
  • 共有レイアウト領域: ヘッダー、ナビゲーション、モバイルナビゲーション、メインコンテンツ、フッター、サイドバー、オーバーレイ、テーマコントロール。
  • 各主要ホームページ領域がindex.html内のどの場所にあるか(近くのセクション/クラス名を使用)。
  • 各サブページテンプレートの場所と、内部リンクがどのように接続されるか。
  • 繰り返しコンテンツが保存されている場所と、期待されるオブジェクト/マークアップ形式。
  • サイトタイトル、タグライン、アバター/ロゴ、ナビゲーション、注目記事、プロジェクトリスト、リンクリスト、画像、色、テーマ変数を変更する方法。
  • 公開前に置き換えるべきプレースホルダーのみのコンテンツ。

エンコーディング整合性ルール

生成されたソースファイルは、ブラウザのスクリーンショットで正しく見えるだけでなく、有効なUTF-8であり、ソース形式で人間が読み取り可能である必要があります。

中国語、日本語、韓国語、アクセント付きラテン文字、またはその他の非ASCIIコンテンツを含むページや編集ガイドの場合:

  • HTMLファイルに<meta charset="utf-8">を含めます。
  • ファイルをUTF-8として書き込みます。
  • 最終納品前に、UTF-8対応リーダーでソースの読みやすさを確認します。

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

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

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 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.

関連スキル