Communitygithub.com

Gyschuaner/アイデアから個人サイトへ

このスキルを使用して、既存の静的個人ウェブサイトやブログに、1つ以上のブログ記事、メモ、エッセイ、記事、Markdownファイル、Word文書、またはリッチコンテンツのフォルダを追加、インポート、または移行します。サイトの現在の記事スタイル、コンテンツ構造、ナビゲーション、インデックス、アーカイブ、タグ、アセット、数式、リンク、表、コードブロック、埋め込み、ホームページのエントリポイントを維持しながら行います。貼り付けられた投稿、ローカルのMarkdownファイル、Obsidianノート、.docxドラフト、古い静的HTML投稿、エクスポートされたブログコンテンツ、またはサイト作成後の中規模バッチの投稿に使用します。

アイデアから個人サイトへ とは?

このスキルは、AIエージェントが既存の静的サイトに、新しい投稿をサイトの既存のスタイルと構造に完全に一致させながら追加するためのものです。新しいブログシステムを強制するのではなく、既存の投稿システム(例:ファイル構造、インデックス、テンプレート)を理解し、Markdown、Obsidianノート、Word文書、古いHTML、貼り付けられたテキストなど、さまざまなソースからのコンテンツを変換します。 主な機能には、ソースコンテンツからのメタデータ(タイトル、日付、タグなど)の抽出、数式(KaTeX)、コードブロックの構文強調表示、表、脚注、コールアウト、リンク、画像などのリッチコンテンツフォーマットの保持が含まれます。また、画像や添付ファイルを適切なページ相対パスでコピー/再リンクし、ブログインデックス、アーカイブ、タグ/カテゴリページ、ホームページの最近の投稿、RSS/サイトマップなどのエントリポイントを更新します。 このスキルは、Claude Code、Coder、または任意のAIコーディングエージェント向けに設計されており、サイトの再設計、新しい投稿システムの作成、またはサイトの公開は行いません。成功のゲートは、新しい投稿が既存のスタイルでレンダリングされ、適切なインデックスからアクセス可能であり、画像、数式、コード、リンクが機能するか、未解決の項目が明示的に報告されることです。

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

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

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

ドキュメント

ブログ投稿の追加

目標

ユーザーのコンテンツを既存の静的ブログに追加し、新しいブログシステムを強制しないこと。

このスキルは、まず現在のサイトがどのように投稿を表現しているかを理解し、次にそのスタイルで新しいコンテンツを追加する必要があります。これは、汎用的なMarkdownからHTMLへのコンバーターではありません。

契約

入力:

  • 既存の静的サイトフォルダと、その現在の投稿/インデックス/テンプレートシステム。
  • 1つ以上のソース投稿: Markdown、Obsidianノート、Word文書、古いHTML、貼り付けられたテキスト、画像、添付ファイル、またはコンテンツフォルダ。
  • オプションのメタデータ (タイトル、日付、タグ、概要、スラッグ、カバー画像、インポート範囲など)。

出力:

  • サイトの既存の記事スタイルに一致する新しい記事/詳細ページ。
  • ブログインデックス、アーカイブ、タグ/カテゴリ、ホームページの最近の投稿、検索データ、RSS、またはサイトマップなど、既存のシステムがある場合、更新されたエントリポイント。
  • ページ相対パスでコピー/再リンクされたローカル画像と添付ファイル。
  • 該当する場合、更新された EDITING.md 投稿指示。

境界:

  • サイトを再設計したり、既存のものが明確な場合に新しい投稿システムを作成したりしないでください。
  • ソースがサポートしていないメタデータ、日付、著者、または主張をでっち上げないでください。
  • リモートの数式/CDN依存関係を黙って追加しないでください。
  • 公開しないでください。publish-static-site を使用してください。

成功のゲート:

  • 新しい投稿が既存のスタイルでレンダリングされ、適切なインデックスからアクセスできること。
  • 画像、数式、リンク、コード、表、リッチコンテンツが機能するか、未解決のアイテムが明示的に報告されること。
  • パスが記事ページとインデックスページからページ相対であること。
  • 影響を受けるページがブラウザ検証に合格し、review-static-site が合格するか、受け入れられた制限のみを報告すること。

ゲートが失敗した場合:

  • このスキルで変換、メタデータ、パス、アセット、またはインデックスの配線を修正してください。
  • インポートによって引き起こされた小さな視覚的な修正には edit-site-part を使用してください。
  • 修正後、再度 review-static-site を使用してください。

使用するタイミング

ユーザーが次のことをしたい場合にこのスキルを使用します:

  • 1つの新しい記事、ノート、エッセイ、またはブログ投稿を追加する。
  • 複数のMarkdownファイルを静的サイトにインポートする。
  • 古いブログから新しい生成サイトに投稿を移動する。
  • 貼り付けられた記事テキストをサイトの記事ページに変換する。
  • ブログインデックス、アーカイブ、タグ、ホームページの最近の投稿、または関連するエントリポイントを更新する。
  • コンテンツを追加しながら、現在のサイトのビジュアル言語を維持する。

このスキルを使用して、テーマを選択したり、新しいサイトをゼロから構築したり、ウェブサイトのスタイルを再作成したり、プロフィール/アバウトコンテンツをパーソナライズしたり、小さな視覚的な微調整を行ったり、サイトを公開したり、プロジェクトをフレームワークに変換したりしないでください。

入力

利用可能なものは何でも使用します:

  • 静的サイトフォルダ、通常は site/、dist/、out/、または public/。
  • 1つ以上のMarkdownファイル、Word文書、貼り付けられた投稿、古いHTMLファイル、画像フォルダ、またはコンテンツフォルダ。
  • 以前のスキルからの EDITING.md、ページマップ、または引き継ぎメモ。
  • 既存の記事テンプレートページまたは代表的な投稿。
  • ユーザー提供のタイトル、日付、タグ、カテゴリ、概要、スラッグ、カバー画像、公開設定。
  • すべての投稿、選択されたサブセット、または最初に代表的なバッチをインポートするかどうか。

ソースコンテンツが大きい場合は、最初に構造を検査し、盲目的にすべてをインポートしないでください。

1. 既存の投稿システムを理解する

新しい投稿を書く前に、サイトが現在どのように機能しているかを検査します。

以下を確認します:

  • posts/*.html、notes/*.html、articles/*.html、またはネストされたルートフォルダなどの投稿ファイル。
  • blog.html、archive/index.html、notes/index.html、tags/index.html、または category/index.html などのインデックスページ。
  • data/posts.json、data/notes.json、data/site.json、または profile.json などのデータファイル。
  • assets/script.js または類似のファイル内のJavaScriptデータ配列。
  • 最近の投稿、注目の投稿、ノート、読書リスト、またはライティングハイライトのためのホームページセクション。
  • テンプレートとして使用できる既存の記事/詳細ページ。
  • テンプレートが ../assets/style.css などのページ相対リンクを使用するか、/assets/style.css などのサーバールートリンクを使用するかなど、既存のパス戦略。
  • すでに存在する場合、RSS、Atom、サイトマップ、検索インデックス、またはタグ/カテゴリページ。
  • 投稿を追加するための EDITING.md の指示。
  • assets/images/posts/、同じ場所にある投稿フォルダ、カバーフィールド、フィギュアクラス、ライトボックスマークアップ、キャプション、またはレスポンシブ画像ラッパーなど、既存の画像と添付ファイルの規則。
  • 数式レンダリング、コードハイライト、表、脚注、コールアウト、見出しアンカー、目次、リンクカード、埋め込み、図、引用/参照セクションなど、既存のリッチコンテンツの規則。

既存の構造に従ってください。サイトにすでに投稿システムがある場合、新しい投稿システムを発明しないでください。

2. 投稿メタデータを抽出する

各ソース投稿について、以下を抽出または導出します:

  • タイトル。
  • 日付。
  • スラッグ。
  • タグまたはカテゴリ。
  • 概要または抜粋。
  • カバー画像またはヒーロー画像(存在し使用可能な場合)。
  • ソースパス。
  • 読書時間(現在のサイトがすでに使用しているか、一貫して計算するのが簡単な場合のみ)。

フロントマターが存在する場合はそれを使用します。それ以外の場合は、最初の見出し、ファイル名、周囲のフォルダ、表示されている日付テキスト、または最初の段落から推測します。

特定の日付、タグ、著者、または主張をでっち上げないでください。フィールドが欠落していて推測できない場合は、明確なプレースホルダーを使用するか、サイトスタイルで許可されている場合はフィールドを省略します。

3. コンテンツをサイトのスタイルに変換する

既存の記事テンプレートと読書体験に一致するように新しい記事ページを作成します。

以下を保持します:

  • ヘッダー、ナビゲーション、フッター、サイドバー、共有シェル。
  • 記事のタイポグラフィ、間隔、メタデータレイアウト、タグ、バックリンク、関連リンク。
  • ログエントリ、フィールドノート、カード、ターミナル/アーカイブフレーミング、またはミニマルエッセイなど、特別なテーマ言語。
  • 既存のCSSクラス規則とデータ構造。

Markdownの場合:

  • 見出し、段落、ブロッククォート、リスト、タスクリスト、表、コードブロック、リンク、脚注、コールアウト、画像をセマンティックHTMLに変換します。
  • 利用可能な場合はコード言語ラベルを保持します。
  • 画像参照をページ相対に保ち、必要な場合のみローカル画像をコピーします。
  • 中国語、日本語、韓国語、アクセント付きラテン文字、その他の非ASCIIテキストを読み取り可能なUTF-8として保持します。

古いHTMLの場合:

  • 記事本文とメタデータを抽出します。
  • 古いサイトのクロム、アナリティクス、コメント、無関係なナビゲーション、ソースサイトのアイデンティティを削除します。
  • コンテンツを新しいサイトの記事テンプレートに再ラップします。

3.5. 静的パスの互換性を維持する

投稿を追加するときは、生成された各ページの場所からパスを計算します。index.html からパスを盲目的にネストされた記事ページにコピーしないでください。

デフォルトのルール:

  • 新しい記事ページは、共有CSS、JavaScript、フォント、画像、ナビゲーションにページ相対リンクを使用する必要があります。
  • 投稿が posts/my-post.html に生成される場合、共有アセットは通常 ../assets/style.css、../assets/script.js、および ../assets/images/posts/my-post/figure.png などの投稿画像を必要とします。
  • ルートページから投稿へのリンクは、通常 posts/my-post.html である必要があります。
  • 投稿からルートページへのリンクは、構造に応じて、通常 ../index.html、../blog.html、または ../archive/index.html である必要があります。
  • 既存のサイトが意図的にルート絶対パスを使用しており、ユーザーが直接の file:// オープンとサブパスホスティングが壊れる可能性があることを受け入れない限り、/assets/...、/posts/...、/data/...、/images/... などのルート絶対パスを導入しないでください。
  • JavaScript生成リンク、検索結果、タグフィルター、関連投稿リンク、カバーパス、RSS/サイトマップエントリ、およびデータファイルを同じパス戦略で更新します。
  • 既存のサイトに誤ってルート絶対リンクがすでにある場合は、それを報告し、問題を拡大するのではなく、影響を受けるパスを修正することを優先します。

ローカルファイルのフェッチ問題を回避します:

  • 新しく追加された投稿が、記事本文のためにローカルのJSON/Markdownの fetch() に依存しないようにします。
  • インデックスがデータからレンダリングされる場合は、重要な投稿リンクをHTMLで表示するか、直接オープンプレビューで機能する相対的なJavaScriptデータオブジェクトを使用します。

4. リッチコンテンツフォーマットを処理する

リッチコンテンツを意図的に保持し、すべてをプレーンな段落にフラット化しないでください。

まず、現在のサイトがすでに以下をサポートしているかどうかを検査します:

  • KaTeX、MathJax、カスタムCSS、または生のTeXブロックによる数式レンダリング。
  • コードハイライト、言語ラベル、コピーボタン、またはターミナルスタイルのコードフレーム。
  • 表、レスポンシブテーブルラッパー、脚注、コールアウト、アドモニション、引用、タスクリスト。
  • 見出しアンカー、目次、バックリンク、関連ノート、またはセクションリンク。
  • リンクカード、ブックマークリスト、URLインデックスページ、引用、参照リスト、または参考文献セクション。
  • ビデオ、オーディオ、PDF、iframe、Mermaid図、Excalidraw/SVG図、またはダウンロード可能な添付ファイルなどの埋め込みメディア。

既存のパターンがある場合はそれに従います。パターンがない場合は、シンプルなセマンティックHTMLを使用し、追加のレンダラーが必要な機能を報告します。

数式とフォーミュラ:

  • $...$、$$...$$、\(...\)、\[...\]、またはWordの数式エクスポートからのインラインおよび表示数式を保持します。
  • 存在する場合は、サイトの既存の数式レンダラーを使用します。
  • ソースに多くの数式が含まれており、レンダラーが存在しない場合は、プレーンな静的サイトにはローカルのKaTeX統合を優先します: KaTeX CSS/JS/フォントをローカルのベンダーフォルダの下に保存し、小さなローカルレンダリングスクリプトを追加し、CDNに依存しないでください。
  • それ以外は依存関係のないサイトに、リモートのMathJax/KaTeX依存関係を黙って追加しないでください。
  • フォールバックとして、数式マークされた要素内に元のTeXを保持し、それをブラウザでレンダリングします。数式のレンダリングが失敗した場合、読み取り可能なTeXフォールバックがページを壊す代わりに表示されたままになるようにします。
  • KaTeXが必要とする明らかなソース構文を正規化します。例: softmax矢印、\cdot、\times、誤って数式に混入した句読点、一般的なQ/K/V表現。
  • 数式レンダラーが追加された場合、数式の多い投稿をコードのように見えるTeXボックスとして残さないでください。
  • 数式をソースとブラウザのフォールバックの両方で読み取り可能に保ちます。

コードブロック:

  • フェンス付きコード言語名を保持します。
  • コードブロック内のHTMLをエスケープします。
  • 長いコード行は、ページレイアウトを壊すのではなく、スクロール可能に保ちます。
  • 既存のコードブロックスタイル、コピーボタン、シンタックスハイライトの規則を再利用します。
  • 投稿からソースコードを実行しないでください。

表:

  • Markdown、Word、またはHTMLの表をセマンティックテーブルに変換します。
  • 幅の広い表は、サイトの既存のレスポンシブテーブルコンテナにラップするか、小さなローカルラッパーを追加します。
  • ヘッダー行、配置の意図、利用可能な場合はキャプションを保持します。

リンク、URLインデックス、内部参照:

  • 明確なリンクテキストで外部リンクを保持します。
  • 相対リンクとMarkdown .md リンクを、ターゲットの投稿がインポートされたときに生成された静的HTMLパスに変換します。
  • Obsidianのウィキリンク(例: [[Note]]、[[Note#Heading]]、[[Note|Alias]])を、ターゲットを解決できる場合は通常のリンクに変換します。
  • 未解決の内部リンクは、表示可能なプレースホルダーまたはプレーンテキストとして保持し、報告します。
  • サイトがアンカーリンクまたは目次を使用する場合、安定した見出しIDを生成します。
  • URLインデックス、ブックマーク、またはリンクラウンドアップの投稿の場合、リスト構造を保持します。存在する場合はサイトの既存のリンクカード/リストスタイルを使用します。ユーザーが要求しない限り、リモートメタデータをフェッチする必要があるプレビューカードを発明しないでください。

脚注、引用、参照:

  • Markdownの脚注を、存在する場合はサイトの既存のスタイルを使用して脚注セクションに変換します。
  • 引用ラベル、参考文献エントリ、参照リンクを保持します。
  • ソーステキストが [@paper2024] などの未解決の引用キーを使用する場合、それらを表示したままにし、参考文献ファイルが提供されない限り、引用メタデータが欠落していることを報告します。

コールアウト、アドモニション、ブロックタイプ:

  • Obsidian/GitHubスタイルのコールアウト(例: > [!NOTE]、> [!TIP]、> [!WARNING]、> [!IMPORTANT])を、サイトに最も近いコールアウト/カード/ブロッククォートパターンに変換します。
  • 現在のサイトにチェックリストスタイルがある場合は、タスクリストをチェックリストとして保持します。それ以外の場合は、無効なチェックボックスマークアップまたはプレーンリストを使用します。

埋め込みと添付ファイル:

  • PDF、スライド、データセット、ダウンロード、オーディオ、ビデオについては、サイトがすでにそのメディアタイプを埋め込んでいない限り、明確なリンクまたはダウンロードカードを優先します。
  • ユーザーによって提供された場合のみ、ローカルの添付ファイルをコピーします。
  • ユーザーが所有しているか、意図的に参照している場合のみ、リモートの埋め込みを保持します。
  • Mermaidまたは図ブロックについては、存在する場合は既存のレンダラーを使用します。レンダラーが存在しない場合は、ソースブロックを保持して報告するか、実用的で適切な場合にのみ静的SVG/PNGに変換します。

5. 投稿画像とアセットを処理する

現在のサイトのアセット規則に従って画像を処理します。

まず、既存の投稿が画像をどのように保存しレンダリングしているかを検査します:

  • assets/images/posts/<slug>/ などの共有アセットフォルダ。
  • posts/<slug>/images/ などの同じ場所にある投稿アセット。
  • cover、heroImage、thumbnail、images などのデータフィールド。
  • フィギュアマークアップ、キャプション、ライトボックスリンク、遅延読み込み、幅/高さ属性、レスポンシブCSSクラス。

既存のパターンを優先します。パターンがない場合は、次のようなシンプルな静的規則を使用します:

assets/images/posts/<post-slug>/

Markdownソースの場合:

  • Markdownファイルのフォルダから相対画像リンクを解決します。
  • 必要な場合、ローカル画像をサイトの投稿画像フォルダにコピーします。
  • Markdown画像参照を新しい相対サイトパスに書き換えます。
  • ネストされた記事ページの場合、画像パスに正しい ../ の深さを含めます。
  • Markdownの代替テキストが存在する場合は保持します。
  • ソースが近くのイタリックテキスト、タイトル属性、またはObsidianスタイルの埋め込みを使用している場合、画像キャプションを変換します。
  • 絶対ローカルディスクパスを指すリンクを残さないでください。

Obsidianノートの場合:

  • ![[image.png]] や相対添付ファイルフォルダなどの一般的な埋め込みをサポートします。
  • ノートの近くにある可能性のある添付ファイルフォルダ(attachments/、assets/、images/、または表示されている場合、 vaultの設定された添付ファイルフォルダ)を検索します。
  • 埋め込みを通常のHTML画像またはフィギュアマークアップに書き換えます。

Word .docx ソースの場合:

  • ドキュメントパッケージから埋め込み画像を抽出するか、利用可能なドキュメントツールを使用します。
  • 可能であれば、周囲のテキストに対する画像の順序を保持します。
  • 抽出された画像を、安定した名前で投稿画像フォルダの下に保存します。

...(翻訳が切り詰められました、翻訳を続けてください)

Individual skills in this repo

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

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

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.

関連スキル