Communitygithub.com

静的サイト公開スキル

完成した静的個人ウェブサイト、ブログ、ポートフォリオ、またはスタイルの再現をGitHub Pages、Cloudflare Pages、Netlify、Vercelで公開、デプロイ、または準備します。

静的サイト公開スキル とは?

このスキルは、静的サイトを公開またはデプロイ準備するための包括的なガイドを提供します。対応するプラットフォームはGitHub Pages、Cloudflare Pages、Netlify、Vercelで、`site/`、`dist/`、`out/`、`public/`、`docs/`などのフォルダを直接扱います。ユーザーの好みやプロジェクトの状況に応じて、最も適切なプラットフォームとデプロイ方法(Git連携、直接アップロード、ガイダンスのみ)を選択します。デプロイ前には、`review-static-site`による徹底的なチェック(アセットパス、プライバシー、エンコーディングなど)を推奨し、問題があれば適切な子スキルにルーティングします。デプロイ後は、実際のURLに対してブラウザで検証を行い、ホームページやサブページの表示、リソースの読み込み、コンソールエラーがないことを確認します。このスキルは、サイトのビルドやデザイン変更は行わず、あくまで公開とデプロイ設定に特化しています。

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

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

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

ドキュメント

静的サイトの公開

目標

完成した静的ウェブサイトの公開またはデプロイ準備を行います。

このスキルは、site/、dist/、out/、public/、docs/ などのデプロイ可能なHTML/CSS/JS出力を対象とします。フレームワークプロジェクトが静的出力フォルダを生成した後であれば、それも公開できます。ただし、単なる静的サイトをデプロイするためだけに、フレームワークプロジェクトに変換してはいけません。

デフォルトの姿勢:

  • フレームワーク固有のデプロイよりも、シンプルな静的ホスティングを優先します。
  • ユーザーが今後も編集を続けるサイトには、Gitベースのデプロイを優先します。
  • 迅速な単発公開の場合にのみ、直接アップロードを優先します。
  • ユーザーが明示的に要求しない限り、リモートリポジトリの作成、コードのプッシュ、DNSの変更、ドメインの追加、有料アカウントへのデプロイは行いません。

契約

入力:

  • site/、dist/、out/、public/、docs/、またはリポジトリルートなどの静的デプロイルート。
  • 優先プラットフォームまたはターゲット: GitHub Pages、Cloudflare Pages、Netlify、Vercel、カスタムドメイン、ガイダンスのみ、またはライブデプロイ。
  • 現在のGit/リポジトリの状態、プラットフォームアカウントへのアクセス、CLI/ブラウザログイン、およびデプロイに関する制約。

出力:

  • 具体的なデプロイ設定: プラットフォーム、ブランチ、ビルドコマンド、ベースディレクトリ、公開/出力ディレクトリ、および必要に応じた設定ファイル。
  • オプションのプラットフォーム固有設定: GitHub Pagesワークフロー、netlify.toml、vercel.json、.nojekyll、CNAME。
  • ライブURLと、デプロイが実際に実行された場合のデプロイ後検証。
  • 認証情報やアカウントアクセスがない場合の手動ダッシュボード手順。

境界:

  • サイトのビルドや再デザインは行いません。欠陥は適切な子スキルにルーティングします。
  • 明示的に許可されていない限り、プッシュ、リポジトリ/プロジェクトの作成、アップロード、ドメインのバインド、DNSの変更、有料リソースの使用は行いません。
  • ユーザーがサーバールートのみの動作を明示的に承諾しない限り、壊れたローカル/静的パスの互換性の回避策としてデプロイを使用しないでください。

成功ゲート:

  • review-static-site が合格しているか、未解決のリスクが明示されていること。
  • デプロイルートに index.html が含まれており、プラットフォームが正しいフォルダを公開すること。
  • デプロイ後、オンラインURLでホームページ、アセット、ナビゲーション、代表的なサブページが読み込まれること。

ゲートが失敗した場合:

  • デプロイ前に、パス、アセット、エンコーディング、またはページタイプのブロッカーを修正します。
  • コンテンツ/デザイン/インポートの問題を personalize-site、edit-site-part、add-blog-posts、make-personal-site、または copy-website-style にルーティングします。
  • review-static-site を再実行し、デプロイ設定を再試行または更新します。

参考文献

選択したプラットフォームまたは問題に必要な参照のみを読み込みます:

  • パス戦略と直接開く互換性: references/path-strategy.md。
  • Cloudflare Pages Git連携と直接アップロード: references/cloudflare-pages.md。
  • GitHub Pages ブランチソースとActionsワークフロー: references/github-pages.md。
  • Netlify ダッシュボードと netlify.toml: references/netlify.md。
  • Vercel ダッシュボードと vercel.json: references/vercel.md。

公式ドキュメント:

デプロイモード

まず、ユーザーが実際に何を望んでいるかを判断します:

  • ガイダンスのみ: プラットフォームの選択と正確な設定を説明します。有用でない限り、ファイルは編集しません。
  • リポジトリの準備: 必要な設定ファイルを追加し、ホスティングダッシュボードで何をクリックすべきかをユーザーに伝えます。
  • 今すぐデプロイ: ユーザーが明示的に要求し、必要なCLI/auth/sessionが存在する場合にのみ、リモートアクションを実行します。
  • ライブURLの確認: デプロイされたURLをブラウザで開き、ローカルサイトと比較して確認します。

認証情報、アカウントアクセス、ブラウザログイン、またはCLI認証がない場合は、回避策を考案する代わりに、正確なダッシュボード手順を提供します。

ワークフロー

  1. 静的出力フォルダとユーザーの希望プラットフォーム(ある場合)を特定します。
  2. 公開前に review-static-site を呼び出すか、使用を提案します。
  3. デプロイルートに index.html が含まれていることを確認します。
  4. アセットパスを検査し、不注意によるルート絶対サイトローカルパスを公開前に変換します。パスの動作が不明な場合は、references/path-strategy.md を読み込みます。
  5. 最もシンプルなマッチングプラットフォームとデプロイモードを選択します。
  6. 選択したプラットフォームの参照を読み込み、そのプラットフォームに必要な設定ファイルのみを追加します。
  7. Git経由でデプロイする場合は、Gitステータスを確認し、無関係またはプライベートなファイルが含まれないようにします。
  8. ユーザーがリモートアクションを承認した場合は、合意した内容を正確にプッシュまたはデプロイします。
  9. 公開後、ライブURLを開き、ブラウザでデプロイされたサイトを確認します。

事前チェックリスト

デプロイ設定を記述したり、ユーザーに設定を伝えたりする前に、以下のチェックを実行します:

  • デプロイルート: index.html を直接含むフォルダを選択します。
  • エントリページ: index.html がデプロイルートのトップレベルに存在する必要があります。
  • 直接開くプレビュー: ユーザーが明示的にサーバーのみの動作を承諾しない限り、ルート index.html は、ファイルシステムから直接開いたときにCSS、JS、画像、およびナビゲーションを保持する必要があります。
  • ローカルHTTP: python -m http.server でデプロイルートを提供し、http://127.0.0.1:<port>/ で動作することを確認します。
  • 静的監査: リンク、UTF-8の可読性、プレースホルダーの残骸、ブラウザレンダリング、プライバシーの残骸、モバイルレイアウトについて、review-static-site を実行または推奨します。
  • アセットパス: href、src、srcset、CSS url(...)、フォント、ファビコン、カバー画像、RSS、サイトマップ、マニフェストリンクを検査します。
  • プライベートデータ: トークン、ローカルファイルシステムパス、ドラフトノート、ソースサイトのアイデンティティ、個人の機密情報が公開されていないことを確認します。
  • 出力の完全性: サブページ、投稿、画像、ベンダーフォント、KaTeX/数式アセット、コピーされたメディアがデプロイルート内にあることを確認します。

これらをブロッカーとして扱います:

  • デプロイルートに index.html がない。
  • ローカルCSS、JS、画像、フォント、RSS、サイトマップ、またはベンダーアセットパスが壊れている。
  • ソースファイルに文字化けや読めないエンコーディングが含まれている。
  • 生成された個人サイトに、置き換えられるべきコピー元のアイデンティティがまだ含まれている。
  • 生成されたプレーンな静的サイトに、/assets/...、/posts/...、/data/...、/images/... などの不注意によるルート絶対サイトローカルパスが残っている。
  • ルート絶対パスが 127.0.0.1 から提供されているため、サイトはローカルHTTPでのみ機能するが、直接ファイルを開いたりサブパスデプロイしたりするとCSS/JS/画像が失われる。
  • プライバシーに関わるファイルや機密情報がデプロイされる。
  • プラットフォームが間違ったフォルダをデプロイする。

プラットフォームの選択

プレーンな静的個人サイトには、以下のデフォルトランキングを使用します:

  1. Cloudflare Pages Git統合: 生成された site/ フォルダと将来の更新に最適なデフォルト。
  2. GitHub Pages with GitHub Actions: ユーザーがすべてをGitHub内で完結させたい場合に最適。
  3. Netlify: フレンドリーなプレビューとダッシュボード設定を備えたシンプルな静的ホスティング。
  4. Vercel: ユーザーがすでにVercelを使用しているか、後でNext.jsに移行する可能性がある場合に適していますが、プレーンHTMLのデフォルトではありません。

決定ルール:

  • ユーザーが最も手間をかけずに済ませたい場合、かつGitHubリポジトリがある場合: Cloudflare Pages Git統合。references/cloudflare-pages.md を読み込みます。
  • ユーザーがGitHubのみのホスティングを希望する場合: GitHub Pages。references/github-pages.md を読み込みます。
  • デプロイファイルがリポジトリルートまたは /docs にある場合: GitHub Pages ブランチソースは許容されます。
  • デプロイファイルが site/、dist/、out/、またはその他のカスタムフォルダにある場合: GitHub PagesにはGitHub Actionsを優先します。
  • ユーザーが今日手動でアップロードしたい場合: Cloudflare Direct Upload または Netlify の手動デプロイ。
  • ユーザーがすでにVercelアカウント/プロジェクトを持っている場合: 明示的な出力ディレクトリ設定でVercelを使用します。

フレームワークの静的出力

サイトがプレーンなHTML/CSS/JSでない場合:

  • package.json、フレームワーク設定、既存のスクリプトを検査します。
  • プロジェクトの既存のビルドコマンドを使用します。npmワークフローを考案しないでください。
  • ソースフォルダではなく、最終的な静的出力フォルダを公開します。
  • 一般的な出力には、フレームワークに応じて dist、out、build、.output/public、public などがあります。
  • Next.js静的エクスポートの場合、out/ を最終出力として扱う前に、プロジェクトが実際に静的エクスポート用に設定されていることを確認します。
  • Vue/Vite/Astroスタイルのプロジェクトの場合、ビルド成功後に設定された出力ディレクトリを公開します。

ユーザーがプレーンな静的公開を要求し、フレームワークファイルが存在しない場合は、npmを導入しないでください。

設定ファイルポリシー

選択したプラットフォームに一致する設定ファイルのみを追加します:

  • GitHub Pages Actions: .github/workflows/pages.yml。
  • GitHub Pages カスタムドメイン: デプロイルートの CNAME。ユーザーがドメインを提供した場合のみ。
  • GitHub Pages Jekyllバイパス: 有用な場合、デプロイルートの .nojekyll。
  • Netlify: ダッシュボード設定で十分でない場合、またはユーザーがGitで設定を管理したい場合にのみ netlify.toml。
  • Vercel: Vercelが明示的な出力設定を必要とする場合にのみ vercel.json。
  • Cloudflare Pages: 通常、プレーンな静的サイトにはダッシュボード設定で十分です。

すべてのプラットフォームに一度にデプロイ設定を追加しないでください。

Gitとリモートの安全性

リモートアクションの前に、何が起こるかを述べ、ユーザーがそれを要求したことを確認します:

  • GitHubリポジトリを作成する。
  • リモートを追加する。
  • ファイルをステージングまたはコミットする。
  • リモートブランチにコミットをプッシュする。
  • GitHub Pagesを有効にする。
  • Cloudflare、Netlify、またはVercelプロジェクトを作成する。
  • ホスティングプロバイダーにファイルをアップロードする。
  • 環境変数を追加する。
  • カスタムドメインを追加するか、DNSレコードを変更する。

ステージングまたはプッシュの前に:

  • git status --short を実行します。
  • 生成されたサイトファイルと、無関係なユーザーの変更を区別します。
  • 無関係な変更をステージングしないでください。
  • プライベートノート、認証情報、ローカルパス、機密情報を含むスクリーンショット、または一時ファイルを公開しないでください。

機密情報、トークン、プライベートノート、またはローカルファイルシステムパスを静的サイトやデプロイ設定に入れないでください。

デプロイ後の検証

プラットフォームがライブURLを報告した後:

  • 実際に利用可能なインタラクティブブラウザツールを使用して、デプロイされたURLを開きます。「利用可能」とは、現在のターンの呼び出し可能なツールリストに公開されていることを意味します。Codexでは、これがターンにルーティングされた場合のBrowser/アプリ内ブラウザプラグインである可能性があります。
  • ホームページが404、空白ページ、またはディレクトリリストではないことを確認します。
  • CSS、JavaScript、画像、フォント、ファビコン、RSS、サイトマップ、ベンダーアセットがデプロイされたドメインから読み込まれることを確認します。
  • プライマリナビゲーションと、ページタイプごとに少なくとも1つの代表的なサブページをクリックします。
  • デスクトップとモバイルの幅をテストします。
  • ブラウザコンソールで、欠落しているアセットやJavaScriptエラーを確認します。
  • メタデータ、タイトル、説明、Open Graph画像、正規URL、RSS、サイトマップ、ロボットファイルが存在する場合は確認します。
  • GitHubプロジェクトPagesを使用している場合は、特にサブページと、リポジトリサブパス下のアセットURLを確認します。
  • カスタムドメインを使用している場合は、HTTPSとapexとwwwの間のリダイレクトを確認します(設定されている場合)。

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

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

デプロイされたサイトがローカルプレビューと異なる場合は、デザインコードを変更する前に、デプロイログ、出力ディレクトリ、アセットパス戦略を検査します。

出力

最終的なユーザー向けレポートは簡潔に保ちます:

  • 選択したプラットフォームとその理由。
  • 公開または準備された静的フォルダ。
  • デプロイモード: ガイダンス、準備された設定、Git統合、直接アップロード、またはライブデプロイ。
  • 使用された設定: ブランチ、ビルドコマンド、ベースディレクトリ、公開/出力ディレクトリ。
  • 変更された設定ファイル(ある場合)。
  • 選択したプラットフォームの公式ガイドURL。
  • ライブURL(デプロイが行われた場合)。
  • 実行された検証と残っている手動ステップ。

ガイダンスのみが要求された場合は、サイトがデプロイされたふりをしないでください。具体的なプラットフォーム設定と公式ガイドリンクを提供します。

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

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

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.

関連スキル