Communitygithub.com

Gyschuaner/from-idea-to-personal-site

このスキルを使うと、生成された静的パーソナルサイト、ブログ、ポートフォリオ、デジタルガーデン、スタイル再現サイトを、プレースホルダーのアイデンティティ、プロフィールコピー、リンク、プロジェクト、おすすめアイテム、連絡先詳細、メタデータ、デモページのコンテンツを置き換えて、ユーザー自身のサイトに変えることができます。make-personal-site や copy-website-style の後、またはユーザーが既存の静的サイトフォルダと、経歴、履歴書、README、GitHubプロフィール、古いホームページ、Markdownノート、ソーシャルリンクなどの個人素材を提供した場合に使用します。

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

このスキルは、テンプレートやデモから生成された静的サイトを、ユーザー自身のパーソナルサイトに完全にパーソナライズするための包括的なガイドラインを提供します。主な目的は、サイトの外観スタイルやレイアウトを変更するのではなく、表示されるコンテンツ、メタデータ、リンク、画像、プロフィール情報をユーザーの実際の情報に置き換えることです。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント環境で動作し、`EDITING.md`やページマップなどのハンドオフノートを活用して、生成されたサイトフォルダを編集します。ユーザーから提供された経歴、履歴書、GitHub README、ソーシャルリンク、プロジェクトリストなどの素材を入力として受け取り、それらをサイトの既存のスタイルとレイアウトに適応させます。スキルは、プレースホルダーやソースサイト由来のコンテンツを体系的に特定して置き換え、サイトのリンク構造(相対パス)を維持し、最終的にはブラウザ表示の確認や`review-static-site`による検証を推奨します。

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

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

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

ドキュメント

サイトのパーソナライズ

目標

生成済みの静的サイトを、テンプレート、デモ、またはコピーした参考サイトではなく、ユーザー自身のサイトのように感じられるようパーソナライズします。

このスキルはコンテンツとメタデータを編集します。テーマの選択、レイアウトの再設計、参考サイトの再作成、大規模な記事アーカイブの移行、サイトの公開、またはプロジェクトの別のフレームワークへの変換は行いません。

契約

入力:

  • 既存の生成済み静的サイトフォルダ、EDITING.md、ページマップ、またはハンドオフノート。
  • ユーザーが提供するアイデンティティ/コンテンツ: 経歴、履歴書、GitHub README、古いホームページ、ソーシャルリンク、プロジェクト、アバター/ロゴ、連絡先詳細、または特定の置換指示。
  • 置き換える既存のデータファイル、JavaScriptデータブロック、メタデータ、プレースホルダー/ソースサイトのコンテンツ。

出力:

  • パーソナライズされた表示コンテンツ、メタデータ、リンク、画像、ソースレベルのアイデンティティフィールド。
  • テンプレート/デモ/ソースサイトの残骸の削除または置換。
  • 入力済みフィールド、残りのプレースホルダー、コンテンツの場所を説明する更新済みのEDITING.md。

境界:

  • 新しいテーマの選択、レイアウトの再設計、新しい参考サイトの再作成、大規模な書き物アーカイブのインポート、公開、またはフレームワークの変換は行わないこと。
  • 特定の個人の事実、雇用主、学校、賞、日付、場所、または指標をでっち上げないこと。
  • 最終レポートにユーザーの個人データを不必要に貼り付けないこと。

成功条件:

  • ユーザーが提供したアイデンティティ/コンテンツが、ブラウザで表示される正しい場所に表示される。
  • 重要なプレースホルダーとソースサイトのアイデンティティが削除されているか、意図的に文書化されている。
  • 変更された内部リンク/アセットがページ相対のままで有効である。
  • review-static-siteが合格するか、許容可能な制限のみを報告する。

条件が満たされない場合:

  • HTML、メタデータ、データファイル、JavaScriptでレンダリングされたコンテンツを再インベントリする。
  • 見逃したプレースホルダー/ソース文字列を置き換える。
  • 新しいコンテンツが原因で発生した小さなレイアウトの問題にはedit-site-partを使用する。
  • 修正後、再度review-static-siteを使用する。

1. 入力

入手可能な資料を使用する:

  • 静的サイトフォルダ。通常はsite/、dist/、out/、またはpublic/。
  • 別のスキルからのEDITING.md、ページマップ、またはハンドオフノート。
  • ユーザーが提供する経歴、履歴書、CV、GitHub README、古いホームページ、ソーシャルリンク、プロジェクトリスト、アバター、ロゴ、または連絡先詳細。
  • profile.json、posts.json、projects.jsonなどの既存のデータファイル、またはassets/script.js内のデータブロック。
  • ユーザーからの具体的な置換指示。

重要な情報が不足している場合は、個人的な事実をでっち上げるのではなく、明確なプレースホルダーを使用する。

2. コンテンツインベントリ

編集前に、パーソナルコンテンツやプレースホルダーコンテンツがどこにあるかを特定する。

確認する項目:

  • HTMLファイルとサブページ。
  • <title>、メタディスクリプション、Open Graph/Twitterメタデータ、ファビコン/ロゴ参照、表示見出し。
  • ヘッダー、ナビゲーション、ヒーロー、プロフィール/概要セクション、連絡先ブロック、フッター、サイドバー、カード、オーバーレイ。
  • JSONファイル、JavaScriptデータブロック、または繰り返されるHTMLリスト内の繰り返しコンテンツ。
  • 記事/詳細デモページ、プロジェクトページ、ノートページ、リンクページ、特別なページ。
  • EDITING.mdの指示と文書化されたコンテンツの場所。

your name、[email protected]、example.com、lorem ipsum、sample post、sample project、TODO、replace meなどの一般的なプレースホルダーやデモテキストを探す。

3. 個人アイデンティティの置換

表示およびソースレベルのアイデンティティフィールドを一貫して置き換える。

一般的なフィールド:

  • サイトタイトル、著者名、表示名、役割、タグライン、短い経歴、所在地、可用性/ステータス、関心事。
  • メール、ソーシャルリンク、GitHub、X/Twitter、LinkedIn、Bluesky、RSS、ニュースレター、履歴書/CV、その他ユーザーが提供したリンク。
  • アバター、ロゴ、ファビコン、altテキスト、画像キャプション、プロフィールラベル。
  • ホームページのヒーローコピー、アバウトページのコピー、コンタクトページのコピー、フッターテキスト、メタデータの説明。

特定の雇用主、学校、賞、出版物、指標、所在地、年をでっち上げないこと。ユーザーが何も提供していない場合は、ニュートラルで置き換えやすい状態を保つ。

リンクやアセットを置き換える際は、静的パスの互換性を維持する:

  • サイトローカルのリンクとアセットはページ相対パスに保ち、ルート絶対パスにしない。
  • ルートページからは、assets/avatar.png、about.html、posts/example.htmlのようなパスを使用する。
  • ネストされたページからは、../assets/avatar.pngや../index.htmlのように正しい深さを使用する。
  • 内部リンクに/assets/...、/posts/...、/images/...、/data/...、または/を導入しない。ただし、サイトが意図的にサーバールートのみであり、ユーザーが直接ファイルを開くと壊れることを承知している場合は除く。
  • GitHub、LinkedIn、メール、個人ドメインなどの外部リンクは絶対URLのままでよい。

4. ソースサイトとテンプレートのクリーンアップ

スタイル再現サイトをパーソナライズする場合、デフォルトで元のサイトのアイデンティティとソース固有のコンテンツを削除する。

置き換えるか削除するもの:

  • 元の著者名、ハンドル、ドメイン、メール、ソーシャルリンク、アナリティクスID、友人リンク、プライベートURL、ライセンステキスト、サイト統計、コミュニティリンク。
  • 元の記事カタログ、記事本文テキスト、プロジェクト名、個人の推薦文、個人の主張。
  • ダウンロードしたアバター、カバー画像、スクリーンショット、ロゴ、または元のサイトからのその他のアセット。ただし、ユーザーが所有しているか許可を得ている場合は除く。

視覚的な構造とインタラクションパターンは維持するが、コンテンツは明確にユーザーのものにするか、ニュートラルなプレースホルダーコンテンツのままにする。

5. コンテンツの適応

ユーザーの素材を、サイトの既存のスタイルとレイアウトに適応させる。生の長いテキストをそのまま貼り付けない。

サイトのコンセプトを使用してコピーを形成する:

  • ミニマルサイト: 簡潔、落ち着いた、直接的。
  • ターミナル/アーカイブスタイル: プロフィール、ログ、ステータス、ディレクトリ、または設定のような表現。
  • ベントースタイル: 短いモジュール形式のスニペット。
  • 研究ホームページ: フォーマル、正確、プロジェクト/出版指向。
  • ブログまたはデジタルガーデン: 執筆トピック、最近のノート、タグ、読書パス。
  • ポートフォリオ: 厳選した作品、役割、成果、使用技術スタック、リンク。

テキストの長さは既存のコンテナに適したものにする。ユーザーが提供した段落がカードには長すぎる場合は、要約し、完全版はアバウトページに配置する。

既存の集中データソースを編集することを優先する。コンテンツがファイル間で繰り返されている場合は、すべての表示およびメタデータのコピーを一貫して更新する。

6. 検証

実際に利用可能なインタラクティブブラウザツールを最初の選択肢として使用し、ローカルプレビューを検査してパーソナライズされたコンテンツが適切な場所に実際に表示されていることを確認する。「利用可能」とは、現在のターンの呼び出し可能なツールリストに公開されていることを意味する。Codexでは、これはターンにルーティングされた場合のブラウザ/アプリ内ブラウザプラグインである可能性がある。他のエージェントでは、同等の表示可能なブラウザ、ブラウザ使用ツール、またはdevtoolsベースのブラウザである可能性がある。

インタラクティブブラウザツールが呼び出し可能でない場合、ブラウザ配置チェックが行われたふりをしてはならない。視覚的な配置が重要な場合は、ユーザーにブラウザツールを有効にするか呼び出すよう依頼する。Codexの場合、明示的に@browserに言及したリクエストを送信することを意味する場合がある。ユーザーがルーティングを変更しない場合、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、静的監査、またはソースチェックにフォールバックし、その制限を伝える。

インタラクティブブラウザツールが実際に呼び出し可能である場合、Playwrightまたはスクリーンショットのみの検証をデフォルトにしないでください。Playwrightは、インタラクティブブラウザツールが呼び出し可能でない場合、ユーザーが明示的に要求した場合、または繰り返し可能なスクリプト化された回帰テストが特に必要な場合にのみフォールバックとして使用する。

ユーザーの情報が表示されるべきページ(ホーム、アバウト/プロフィール、コンタクト、プロジェクト、リンク、代表的な記事/詳細ページなど)を確認する。ユーザーが提供した名前、タグライン、経歴、アバター/ロゴ、連絡先詳細、ソーシャルリンク、プロジェクト名、おすすめアイテムが期待される場所に表示されていることを確認する。

また、重要なプレースホルダーコンテンツやソースサイトのアイデンティティがブラウザにまだ表示されていないことも確認する。これはコンテンツ配置チェックであり、完全なビジュアルリデザインパスではない。

パーソナライゼーションによってアバター、ファビコン、ソーシャルアイコン、プロジェクトリンク、投稿リンク、またはデータ駆動型カードが変更された場合は、変更されたパスが影響を受けるページの深さから機能し、不用意なルート絶対サイトローカルパスが導入されていないことを確認する。

最後にreview-static-siteを呼び出すか、提案する。

編集ガイド

EDITING.mdが存在する場合は更新し、サイトが再利用可能であることを意図している場合は作成する。

記録する内容:

  • どの個人フィールドが入力されたか。
  • どのコンテンツがプレースホルダーのままか。
  • プロフィール、リンク、プロジェクト、おすすめアイテム、投稿、画像、テーマテキストが現在どこにあるか。
  • サイトにコピーされたユーザー提供のアセットと、それらがどこで参照されているか。
  • 意図的に削除または置換されたソースサイトのコンテンツ。

このガイドは将来のエージェントやユーザーのために残し、ウェブサイト内のマーケティングコピーとしてではなく、内部的な参考資料として保管する。

出力

完了したら、簡潔に報告する:

  • どの個人情報とページが更新されたか。
  • どのファイルが変更されたか。
  • どのプレースホルダーまたはソース固有の残骸が残っている場合、その詳細。
  • review-static-siteが実行されたか、次に実行すべきか。

ユーザーの個人データを不必要に貼り付けないこと。

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

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.

関連スキル