Communitygithub.com

Gyschuaner/從靈感到個人網站

使用此技能,將生成的靜態個人網站、部落格、作品集、數位花園或風格重現的網站,透過替換佔位身份、個人簡介、連結、專案、精選項目、聯絡資訊、元資料和示範頁面內容,轉變為使用者自己的網站。請在執行 make-personal-site 或 copy-website-style 之後,或當使用者提供現有靜態網站資料夾及個人資料(如自傳、履歷、README、GitHub 個人檔案、舊首頁、Markdown 筆記或社交連結)時使用。

從靈感到個人網站 是什麼?

此技能旨在將已經生成的靜態網站(例如個人網站、部落格、作品集、數位花園或風格複製的範本)個人化,使其看起來像是使用者自己的網站,而非範本或展示版。它會替換所有可見的內容和元資料,包括網站標題、作者姓名、個人簡介、社交連結、專案清單、精選項目、聯絡資訊、頭像、標誌、以及 favicon 等,同時清理來源網站或範本中殘留的佔位文字和身份資訊。此技能支援任何包含 HTML、JSON 資料檔、JavaScript 資料區塊以及 EDITING.md 檔案的靜態網站資料夾。其運作方式是先盤點內容,然後系統性地替換使用者提供的個人資訊,並根據網站的既有風格調整文字長度,最後使用互動式瀏覽器工具或 Playwright 驗證所有內容是否正確顯示。此技能不會選擇新主題、重新設計版面、轉換框架或發佈網站。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

個人化網站

目標

將已生成的靜態網站個人化,使其感覺像使用者自己的網站,而非範本、展示版或複製的參考網站。

此技能編輯內容和元資料。它不會選擇主題、重新設計版面、重現參考網站、遷移大量文章存檔、發佈網站,或將專案轉換到另一個框架。

合約

輸入:

  • 現有已生成的靜態網站資料夾、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 元資料、favicon/標誌參考以及可見標題。
  • 頁首、導航、英雄區、個人資料/關於區塊、聯絡區塊、頁尾、側邊欄、卡片和覆蓋層。
  • 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 以及使用者提供的其他連結。
  • 頭像、標誌、favicon、替代文字、圖片說明和个人檔案標籤。
  • 首頁英雄區文案、關於頁面文案、聯絡頁面文案、頁尾文字以及中繼描述。

不要虛構特定的雇主、學校、獎項、出版物、指標、地點或年份。如果使用者未提供某項資訊,請保持中立且易於替換。

替換連結或資源時,請保持靜態路徑相容性:

  • 保持網站內部連結和資源為頁面相對路徑,而非根目錄絕對路徑。
  • 從根頁面,使用像 assets/avatar.png、about.html 和 posts/example.html 這樣的路徑。
  • 從巢狀頁面,使用正確的深度,例如 ../assets/avatar.png 和 ../index.html。
  • 除非網站有意設計為僅伺服器根目錄,且使用者接受直接開啟檔案可能中斷,否則不要為內部連結引入 /assets/...、/posts/...、/images/...、/data/... 或 /。
  • 外部連結(例如 GitHub、LinkedIn、電子郵件和個人網域)可以保留為絕對 URL。

4. 來源網站和範本清理

在個人化風格重現的網站時,預設情況下應移除原始網站的身份和特定來源內容。

替換或移除:

  • 原始作者姓名、帳號、網域、電子郵件、社交連結、分析 ID、朋友連結、私人 URL、授權文字、網站統計資料和社群連結。
  • 原始文章目錄、文章正文、專案名稱、個人推薦和個人宣稱。
  • 從原始網站下載的頭像、封面、螢幕截圖、標誌或其他資源,除非使用者擁有或獲得許可。

保留視覺結構和互動模式,但讓內容明顯屬於使用者,或保持為中立的佔位內容。

5. 內容改編

將使用者的材料改編為網站既有的風格和版面,而不是到處貼上冗長的原始文字。

使用網站的概念來塑造文案:

  • 極簡網站:簡潔、平靜、直接。
  • 終端機/存檔風格:個人檔案、記錄、狀態、目錄或類似配置的用語。
  • Bento 風格:簡短的模組化片段。
  • 研究首頁:正式、精確、以專案/出版物為導向。
  • 部落格或數位花園:寫作主題、近期筆記、標籤和閱讀路徑。
  • 作品集:精選作品、角色、成果、技術棧和連結。

保持文字長度適合現有的容器。如果使用者提供的段落對於卡片來說太長,請進行摘要,並將完整版本放在關於頁面。

優先編輯集中存在的資料來源。如果內容在檔案間重複,請一致地更新所有可見和元資料的副本。

6. 驗證

使用實際可用的互動式瀏覽器工具作為檢查本機預覽並確認個人化內容確實出現在正確位置的首要方法。"可用"意味著它在當前輪次的可用工具清單中。在 Codex 中,這可能是 Browser/應用內瀏覽器外掛(當被路由到該輪次時);在其他代理程式中,可能是等效的可見瀏覽器、browser-use 工具或 devtools 支援的瀏覽器。

如果沒有可呼叫的互動式瀏覽器工具,請不要假設瀏覽器放置檢查已完成。如果視覺放置很重要,請要求使用者啟用或呼叫瀏覽器工具;對於 Codex,可能意味著發送一個明確提及 @browser 的請求。如果使用者未重新路由或用戶端沒有此類工具,則回退到 Playwright、螢幕截圖、靜態審計或原始碼檢查,並說明限制。

當互動式瀏覽器工具實際上可呼叫時,不要預設使用 Playwright 或僅螢幕截圖驗證。僅在沒有互動式瀏覽器工具可呼叫、使用者明確要求,或特別需要可重複的腳本化回歸測試時,才使用 Playwright 作為回退方案。

檢查應顯示使用者資訊的頁面,例如首頁、關於/個人檔案、聯絡方式、專案、連結以及代表性的文章/詳細頁面。確認使用者提供的姓名、標語、自傳、頭像/標誌、聯絡資訊、社交連結、專案名稱和精選項目出現在預期的位置。

同時確認重要的佔位內容或來源網站身份在瀏覽器中不再可見。這是一個內容放置檢查,而非完整的視覺重新設計審查。

如果個人化更改了頭像、favicon、社交圖示、專案連結、文章連結或資料驅動的卡片,請確認變更後的路徑從受影響的頁面深度能夠正常運作,且沒有意外引入根目錄絕對路徑的網站內部連結。

在結束時呼叫或建議使用 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.

相關技能