Communitygithub.com

zijieguo2003/blog-builder-skill

個人ブログをゼロから迅速にセットアップするためのガイド。フレームワーク選定(Hugo, Hexo, Astro, Next.js)、テーマ設定、フロントマター付きブログ記事テンプレート生成、GitHub Pages / Vercel / Cloudflare Pages へのデプロイ、SEO 設定(sitemap, robots.txt, Open Graph, canonical URL)をカバーします。

blog-builder-skill とは?

このスキルは、開発者が個人ブログを構想から公開・SEO 設定まで一貫して実現するための包括的なガイドです。ユーザーの技術レベルや好みに応じて最適な静的サイトフレームワーク(Hugo, Hexo, Astro, Next.js)を提案し、テーマ導入、フロントマター付き記事テンプレートの生成、GitHub Actions を使った CI/CD デプロイ(GitHub Pages, Vercel, Cloudflare Pages 対応)、そして sitemap, robots.txt, Open Graph タグ, canonical URL を含むフル SEO 設定までをステップバイステップで提供します。特に、抽象的な説明ではなく実際の設定ファイルやコードスニペットを提示することに重点を置き、初心者から中級者までが迷わず実装できるように設計されています。各フレームワーク固有の詳細は参照ファイル(references/以下)に分かれており、スキル本体は共通ワークフローと選択ロジックをまとめています。ブログ開設に関するあらゆる質問(「ブログが欲しい」「Hugo を試したい」「ポートフォリオサイトを作りたい」など)で自動的に起動し、具体的な手順を案内します。

対応~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

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

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

ドキュメント

Blog Builder

ユーザーが個人ブログを立ち上げるのを支援します。フレームワーク選定から、テーマ、記事テンプレート、デプロイ、適切な SEO 設定まで、ライブ公開までの全範囲をカバーします。

ワークフロー

Step 1 -- ユーザーの状況を把握する

質問する(または文脈から推測する):

  • 技術的なバックグラウンド?(非技術者 / JS 開発者 / Python 開発者 / など)
  • ゼロから始めるのか、既存サイトがあるのか?
  • 希望するデプロイ先:GitHub Pages、Vercel、Cloudflare Pages?
  • コンテンツの焦点:執筆、ポートフォリオ、チュートリアルブログ、ドキュメント?

Step 2 -- フレームワークを推奨する

状況推奨
非技術者、ただ書きたいだけHugo -- JS 不要、高速、豊富なテーマライブラリ
すでに JS/TS を書き、コンポーネント制御を希望Astro -- アイランドアーキテクチャ、優れた DX
テーマエコシステムが好き、Node に慣れているHexo -- 成熟したプラグインエコシステム
React 開発者、完全制御を希望Next.js -- App Router + MDX

短い理由とともに推奨を提示します。次に進む前に確認します。

Step 3 -- フレームワークのセットアップ

該当するリファレンスファイルを読み、インストールとスターターテーマの手順をユーザーに案内します:

フレームワークリファレンスファイル
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

Step 4 -- 記事テンプレートを生成する

完全なフロントマターを含む、すぐに使える記事テンプレートファイルを作成します。 assets/post-templates/ にあるアセットテンプレートは出発点です -- ユーザーの選んだテーマや好みに合わせてコピーして適応してください。

Step 5 -- デプロイ

references/deployment.md を読み、適切な CI/CD ワークフローを確認します。コミット可能な完全な GitHub Actions YAML を提供します。

重要な注意:

  • GitHub Pages:.github/workflows/deploy.yml にプッシュ;リポジトリ設定で Pages を有効化
  • Vercel:ダッシュボードでリポジトリを接続;フレームワークプリセットと出力ディレクトリを設定
  • Cloudflare Pages:build command = npm run build、output dir = dist(Astro/Hexo/Next.js) または public(Hugo)

Step 6 -- SEO 設定

すべてのブログに必要なもの:

  1. sitemap.xml -- フレームワーク固有;references/.md を参照
  2. robots.txt -- 説明だけでなく、実際のファイル内容を提供する
  3. Open Graph タグ -- og:title、og:description、og:image、og:url を実際のマークアップとして
  4. Canonical URL -- 設定で baseURL / site を設定し、sitemap と OG タグが正しく動作するようにする

常に注意:サイト URL をフレームワーク設定に設定しないと、sitemap は正しい絶対 URL を生成できません。

基本方針

  • 説明だけでなく、実際のファイル内容(コード、YAML、TOML)を提供する
  • 意味のあるフィールドのみを含め、圧倒的なボイラープレートは避ける
  • 人を惹きつける1〜2の落とし穴を指摘する(例:Hugo の baseURL、Astro の site フィールド)
  • コピペしてすぐに使える例を優先する

関連スキル