Communitygithub.com

サイトの一部を編集

このスキルは、生成済みの静的Webサイト(個人ブログ、ポートフォリオ、デジタルガーデン、スタイル再現など)に対して、ページセクション、コンポーネント、ビジュアル詳細、コピーブロック、レスポンシブ問題、軽量インタラクションなど、影響範囲を限定した小規模な編集を行います。サイト全体を再構築せずに、特定の部分だけを調整したい場合に使用します。

サイトの一部を編集 とは?

このスキルは、既存の静的サイトの一部分に限定した編集を安全かつ正確に行うためのものです。ユーザーからの「ヒーローブロックの変更」「カードレイアウトの調整」「モバイルメニューの修正」「配色の変更」「アニメーションの強度調整」「特定のテキストの書き換え」といったリクエストに対して、サイト全体の再生成や大規模な変更を伴わずに目的の編集を実現します。 主な特徴として、編集前にブラウザで対象領域を確認し、対象のHTML/CSS/JSファイルを特定した後、最小限の変更にとどめます。デスクトップ/モバイルのレスポンシブ確認やインタラクションの動作検証も行い、編集後には変更箇所と検証結果を報告します。既存のデザイン言語を尊重し、`EDITING.md`がある場合はそれに従います。インタラクティブブラウザツールが利用可能な場合はそれを優先的に使用し、利用できない場合はPlaywrightやソース検査にフォールバックします。 このスキルは、Claude Code、Codex、Cursorなど、ブラウザ操作やファイル編集が可能なAIエージェント向けに設計されています。全サイトの再生成、テーマ変更、記事の一括インポート、デプロイ、フレームワーク変換などには使用しないでください。編集の影響が共有ナビゲーションや複数ページに及ぶ場合は、代わりに`review-static-site`の実行を提案します。

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

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

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

ドキュメント

サイトの一部を編集 は何をしますか?

目標

既存の静的サイトの特定部分に対して、影響範囲を限定した改善を行い、サイトの他の部分はそのまま維持します。

このスキルは、サイトがすでに存在した後の反復的な調整のためのものです。新しい生成パスではなく、注意深いローカル編集のように機能します。

契約

入力:

  • 既存の静的サイトフォルダ、ターゲットページ、スクリーンショット/ローカルURL、またはターゲット領域の自然言語による説明。
  • EDITING.md および関連するHTML/CSS/JSファイル。
  • 望ましい変更前/変更後のテキスト、スタイル、レスポンシブ動作、または小さなインタラクションの変更。

出力:

  • 影響を受けるページセクション、コンポーネント、コピーブロック、スタイルルール、または軽量インタラクションへの限定された編集。
  • 将来の編集指示を変更する必要がある場合にのみ EDITING.md を更新。
  • 変更が行われた場所、変更されたファイル、実行された検証の簡単なレポート。

境界:

  • サイト全体を再構築したり、テーマの方向性を変更したり、投稿をインポートしたり、複数のフィールドを個人化したり、公開したりしないでください。
  • 無関係なページ/アセットには触れないでください。
  • 依存関係、ビルドステップ、またはルート絶対パスのサイトローカルパスを導入しないでください。

成功条件:

  • リクエストされたローカル変更が、編集前に確認されたと同じブラウザ領域で表示されること。
  • 影響を受ける面に対して、デスクトップ/モバイルまたはインタラクションチェックに合格すること。
  • 無関係なレイアウトやナビゲーションの変更が導入されていないこと。

条件失敗時:

  • ブラウザ領域をソースに再マッピングし、最小限の修正編集を行います。
  • 問題が共有ナビゲーション、多数のページ、アセット、エンコーディング、または公開準備に影響する場合は、review-static-site を実行または提案します。

使用する場合

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

  • 1つのセクション、カード、ブロック、コンポーネント、またはページ領域を変更する。
  • ビジュアル詳細をより小さく、落ち着いた、密度の高い、クリーンな、遊び心のある、より技術的な、または邪魔にならないようにする。
  • モバイルレイアウトの問題、テキストオーバーフロー、スペーシングの問題、または不自然な配置を修正する。
  • ホバー、テーマトグル、メニュー動作、コピーボタン、フィルター、タブ、アニメーションなどの小さなインタラクションを調整する。
  • 特定の可視テキストを書き換えたり短くしたりする。
  • 局所的な領域について、スクリーンショットやユーザーのコメントに一致させる。

このスキルは、全サイト生成、テーマ検索、新しいリファレンスサイトのクローズ再現、大規模なパーソナルコンテンツ置換、記事移行、デプロイ、またはフレームワーク変換には使用しないでください。

入力

ユーザーが提供するものを使用します:

  • サイトルートフォルダとターゲットページ。
  • 問題のスクリーンショット、ブラウザビュー、ローカルURL、または自然言語による説明。
  • 変更する正確なテキスト、セクション名、クラス名、またはビジュアル領域。
  • 存在する場合は EDITING.md。
  • 既存のHTML/CSS/JSファイル。
  • 変更前/変更後の文言やスタイルの方向性の希望。

ターゲット領域が不明瞭な場合は、サイトを検査し、最も小さな合理的な解釈を行います。複数の可能性のある編集が非常に異なる結果を生む場合にのみ、短い確認を求めます。

ワークフロー

  1. 編集前に、ブラウザを使用してターゲットページとターゲット領域を確認します。
  2. EDITING.md が存在する場合はそれを読み、関連するHTML/CSS/JSを検査します。
  3. 検索を使用して、一致する可視テキスト、ID、クラス、データブロック、またはコンポーネントのようなマークアップを見つけます。
  4. 確認されたブラウザ領域を関連するソースファイル、セレクタ、データブロック、またはイベントハンドラにマッピングします。
  5. リクエストを満たす最小の一貫性のある編集を行います。
  6. ユーザーが明示的に変更を依頼しない限り、既存のデザイン言語を維持します。
  7. 編集後、ブラウザで同じページと領域に戻り、変更をそこで確認します。
  8. 何が変更されたかを報告し、必要なフォローアップ検証があれば言及します。

スコープ制御

編集を局所的に保ちます。

  • パラレルな重複を作成するのではなく、既存のセクション、クラス、またはデータオブジェクトを編集することを優先します。
  • セクションレベルの変更で十分な場合は、ページ全体の書き換えを避けます。
  • ユーザーがサイト全体のスタイル変更を望まない限り、共有CSS変数の変更を避けます。
  • 無関係なページ、アセット、またはコンテンツに触れないでください。
  • ナビゲーション、ページマップ、プレースホルダー戦略、および EDITING.md の規則を維持します。
  • サイトのパス戦略を維持します。ローカル編集時に、/assets/...、/posts/...、/images/...、/data/... などのルート絶対パスのサイトローカルパスを導入しないでください。
  • 小さなリクエストがより大きな構造的問題を明らかにした場合は、広範な変更を行う前にトレードオフを説明します。

ユーザーが複数ページにわたる広範なビジュアルシフトを要求した場合は、このスキルを拡張するのではなく、より大規模な生成または再デザインのスキルを提案します。

正しい場所の特定

階層的なルックアップを使用します:

  1. 可視テキストまたは近くのラベルを検索します。
  2. EDITING.md でセクション/ページマップを検索します。
  3. ナビゲーションリンクとページファイル名を検査します。
  4. header、main、section、article、aside、footer などのセマンティックタグを検査します。
  5. CSSセレクタとJavaScriptイベントフックを検査します。
  6. ソースの場所が明らかでない場合は、ブラウザの開発ツールまたはスクリーンショットを使用します。

繰り返しコンテンツがデータからレンダリングされている場合は、生成されたように見えるマークアップだけではなく、ソースデータを編集します。

デザインの保存

編集を現在のサイトに適合させます。

  • 既存のスペーシング、タイポグラフィ、色、境界線、影、アイコン、およびモーションパターンを再利用します。
  • テキストをデスクトップとモバイルの両方でコンテナ内に収めます。
  • 装飾効果が読書の妨げにならないようにします。
  • アニメーションを変更する場合は、prefers-reduced-motion を尊重します。
  • ユーザーが別の要望をしない限り、記事/詳細ページは高度にスタイル設定されたホームページよりも落ち着いたものにします。
  • 個人のウェブサイトやブログに、マーケティングスタイルのヒーローや無関係な装飾セクションを追加しないでください。

コピーを変更する場合は、既存の声とユーザーの言語に一致させます。

インタラクション編集

JavaScriptまたはインタラクション変更の場合:

  • 新しいイベントリスナーを追加する前に、既存のイベントリスナーと状態の規則を見つけます。
  • サイトがプレーンな静的サイトの場合は、バニラJavaScriptを維持します。
  • 依存関係やビルドステップの導入を避けます。
  • JavaScriptでリンク、検索結果、画像URL、またはナビゲーション項目を生成する場合は、影響を受けるページの深さから機能するページ相対パスを使用します。
  • 関連する場合は、クリック、キーボード、モバイル、および繰り返し使用の状態をテストします。
  • フォーカス、ラベル、およびモーション軽減動作などのアクセシビリティの基本を維持します。

レスポンシブ修正

レイアウトまたはモバイルの問題の場合:

  • デスクトップとモバイルの両方の幅を確認します。
  • デスクトップレイアウトを維持しながら狭い画面を修正するCSS変更を優先します。
  • 安定したサイズ、ラッピング、最小/最大幅、グリッド/フレックス調整、およびオーバーフロー制御を使用します。
  • レイアウトを収めるためだけに、モバイルで重要なコンテンツを非表示にしないでください。

編集ガイド

変更が将来の編集方法に影響を与える場合は、EDITING.md を更新します。

次の場合に更新します:

  • 新しいセクション、クラス、データフィールド、またはインタラクションパターンが導入された場合。
  • コンテンツストレージが新しいファイルまたはデータオブジェクトに移動した場合。
  • ユーザーが将来のエージェントが保持する必要がある変更をリクエストした場合。

小さなコピーやスペーシングの変更については、ガイドが誤解を招く場合を除き、EDITING.md を更新しないでください。

検証

影響を受ける面を検証します。サイト全体を検証する必要は必ずしもありません。

編集前に、実際に利用可能なインタラクティブブラウザツールを使用してターゲットページと領域を確認します。「利用可能」とは、現在のターンで呼び出し可能なツールリストに公開されていることを意味します。Codexでは、これがターンにルーティングされた場合のブラウザ/アプリ内ブラウザプラグインである可能性があります。他のエージェントでは、同等の可視ブラウザ、ブラウザ使用ツール、または開発ツールバックのブラウザである可能性があります。編集後、インタラクティブブラウザで同じページと領域に戻り、結果を確認します。

インタラクティブブラウザツールが呼び出し可能でない場合は、変更前/変更後のブラウザ確認が行われたふりをしないでください。編集がビジュアル領域のマッピングに依存する場合は、ユーザーにブラウザツールの有効化または呼び出しを依頼します。Codexの場合、それは @browser を明示的に言及するリクエストを送信することを意味する場合があります。ユーザーが再ルーティングしない場合、またはクライアントにそのようなツールがない場合は、Playwright、スクリーンショット、またはソース検査にフォールバックし、その制限を明記します。

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

ビジュアル、レスポンシブ、またはインタラクティブな編集の場合は、関連するデスクトップ/モバイルビューポートで変更された領域を確認し、変更されたインタラクションを実行します。

影響が共有ナビゲーション、グローバルレイアウト、多数のページ、アセットパス、ソースエンコーディング、または公開準備に及ぶ場合にのみ、review-static-site を実行または提案します。

編集が href、src、CSS url(...)、画像、フォント、ファビコン、データファイル、またはJavaScriptで生成されたURLに触れる場合は、影響を受けるページがページ相対パスで引き続き機能し、静的ファイルを直接開いてもCSS、JS、または画像が失われないことを確認します。

出力

ローカル編集の場合、以下だけを報告します:

  • 変更が行われた場所。
  • どのファイルが変更されたか。
  • どのような検証が行われたか。

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

関連スキル