Communitygithub.com

Gyschuaner/from-idea-to-personal-site

當使用者想要使用純 HTML、CSS 和 JavaScript 建立、實作、重新設計或更新無依賴的個人網站、部落格、首頁、作品集、研究首頁或數位花園時,使用此技能。請在主題方向確定後,或當使用者想要一個無框架、可直接在瀏覽器中開啟並部署為靜態檔案的網站時使用。

from-idea-to-personal-site 是什麼?

此 AI 技能專為建立或重新設計純靜態個人網站而設計,完全依賴 HTML、CSS 和可選的原生 JavaScript。它專注於「無框架、無建置步驟、無套件安裝、無執行時期依賴」的核心承諾,確保產出的網站可直接在瀏覽器中以 `file://` 協定預覽,同時也相容於本地 HTTP 伺服器與任何靜態主機服務。技能適用於 Claude Code、Coder 等支援技能定義的平台,提供一個明確的流程來處理從主題方向、使用者資料到最終靜態檔案夾的整個實作過程。其運作方式是接收主題方向或現有靜態資料夾作為輸入,產生包含首頁、關於、部落格索引、文章頁面、專案清單等必要頁面類型的完整網站結構,並自動生成 `EDITING.md` 編輯指南以便後續修改。此技能在特定情境下會主動轉介其他專門技能,例如需要複製特定網站風格時會建議使用 `copy-website-style`,需要發布時則轉介給 `publish-static-site`。最終的交付成果會通過路徑相容性、連結驗證、編碼完整性等嚴格檢查,確保是一個可直接使用、易於維護的純靜態網站。

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

在你喜歡的 AI 中提問

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

說明文件

製作個人網站

目標

建立或重新設計一個個人網站,作為純靜態檔案:HTML、CSS 和可選的原生 JavaScript。

此技能是在視覺方向確定後的實作步驟。它將主題建議、使用者資料、筆記、範例文章、專案描述或現有的靜態網站資料夾,轉變為一個可運作的個人網站。

核心承諾:

  • 無框架。
  • 無建置步驟。
  • 無套件安裝。
  • 無執行時期依賴。
  • 直接開啟 index.html 進行手動預覽。
  • 使用頁面相對路徑的連結和資源,確保直接檔案開啟、本地 HTTP 和靜態主機服務皆可運作。
  • 將資料夾部署到靜態主機。

對於自動化的瀏覽器 QA,請透過本地 HTTP 提供靜態資料夾服務,而不是開啟 file:// URL。

合約

輸入:

  • 主題方向、使用者資料材料、頁面需求、範例內容或現有靜態資料夾。
  • 可選的參考資料,應引導風格,但不需要高保真複製品。
  • 期望的輸出資料夾和靜態約束條件。

輸出:

  • 一個純靜態網站資料夾,包含 HTML、CSS、可選的原生 JavaScript、本地資源和具代表性的頁面類型。
  • 當建立新網站或進行重大重新設計時,會產生 EDITING.md 供未來編輯使用。
  • 本地預覽說明和驗證摘要。

界限:

  • 不要緊密複製特定的目標網站;應使用 copy-website-style。
  • 不要匯入大量寫作檔案;應使用 add-blog-posts。
  • 不要發布或配置主機服務;應使用 publish-static-site。
  • 除非使用者明確要求,否則不要引入框架、套件安裝、後端、CMS、身分驗證或資料庫。

成功閘門:

  • 必要的頁面類型存在,且導覽指向真實的相對路徑。
  • 網站作為純靜態檔案運作,無需建置步驟。
  • 原始碼為 UTF-8 可讀,佔位符清楚標示,且 review-static-site 可以通過或僅回報已接受的限制。

如果閘門失敗:

  • 在此技能內部修復缺少的頁面類型、路徑、資源、編碼、佔位符或瀏覽器問題。
  • 當失敗原因是缺少使用者身分/內容時,使用 personalize-site。
  • 修復後再次使用 review-static-site。

簡短流程

對於原創的個人網站工作,請遵循此流程:

  1. 釐清網站目的、主題方向、可用內容和頁面範圍。
  2. 在編寫程式碼之前,先決定靜態頁面地圖和佔位符策略。
  3. 首先建立共享外殼:頁首、導覽、主要佈局、頁尾、全域 CSS 變數和共享互動。
  4. 實作首頁以及每個被要求或暗示的頁面類型。
  5. 使用使用者的內容或明確可替換的佔位符;不要虛構詳細的個人身分。
  6. 新增編輯指南,供未來模型/使用者編輯。
  7. 使用相對連結和資源驗證直接開啟路徑的相容性。
  8. 在真實瀏覽器中透過 HTTP 進行本地驗證。
  9. 在最終交付前,驗證連結、資源、頁面類型和 UTF-8 原始碼可讀性。

使用時機

當使用者有以下情況時,使用此技能:

  • 想要一個純 HTML/CSS/JS 的個人網站、部落格、首頁、作品集、研究首頁或靜態網站。
  • 要求實作由 search-blog-theme 產生的主題方向。
  • 想要一個簡單、無框架的網站,易於檢查、編輯和部署。
  • 想要重新設計現有靜態網站同時保持無依賴。
  • 提供寬鬆的視覺參考,但不需要高保真複製品。

不應使用時機

在以下情況,請勿使用此技能:

  • 使用者只想搜尋主題或比較視覺參考。應使用 search-blog-theme。
  • 使用者想要緊密複製特定網站的外觀、佈局、動畫或互動感覺。應使用 copy-website-style。
  • 使用者想要遷移大量文章、轉換 Obsidian 筆記、修復 frontmatter 或搬移大型內容檔案。應使用 add-blog-posts。
  • 使用者只需要部署、DNS、GitHub Pages、Cloudflare Pages、Cloudflare Pages Direct Upload、Netlify 或 Vercel 的協助。應使用 publish-static-site。
  • 使用者明確要求框架專案,例如 Next.js、Astro、Hugo、Jekyll、Quartz 或 React。
  • 使用者要求後端、資料庫、身分驗證、CMS、評論系統或動態伺服器行為。

輸入

使用使用者提供的任何內容。如果缺少某些細節,請不要阻擋。

有用的輸入包括:

  • 主題方向:私人程式碼庫、研究日誌儀表板、數位花園、便當盒作品集、田野筆記本、個人作業系統等。
  • 使用者資料:姓名、簡短自傳、角色、地點、社交連結、頭像、履歷、出版物、專案。
  • 頁面需求:首頁、關於、部落格、專案、筆記、出版物、聯絡。
  • 範例內容:1-3 篇文章、專案描述、Markdown 片段、舊的 HTML 頁面。
  • 現有網站資料夾:要保留或重構的當前 HTML/CSS/JS 檔案。
  • 寬鬆參考:v0、Figma、GitHub 主題、框架模板、螢幕截圖或氛圍參考。

參考規則

參考資料可能來自任何技術堆疊。將它們視為視覺和結構上的參考,而不是實作選擇,除非使用者明確要求使用該框架。

對於純靜態網站,請依此轉換參考資料:

  • React、Next 或 Astro 元件 -> 重複的 HTML 區段加上可重複使用的 CSS 類別。
  • Tailwind 工具類別 -> 在 assets/style.css 中使用一般 CSS 規則。
  • 框架路由 -> 連結的 .html 檔案。
  • 內容集合或 CMS 資料 -> 靜態 HTML 清單或小型 JSON 檔案。
  • 主題配置 -> CSS 自訂屬性。
  • 簡單互動 -> 僅在有用時使用原生 JavaScript。

如果使用者想要緊密匹配特定網站,請轉交給 copy-website-style,而不是將其視為寬鬆參考。

預設網站結構

對於新網站,除非使用者另有要求,否則偏好此結構:

site/
  index.html
  EDITING.md
  about.html
  blog.html
  projects.html
  posts/
    first-post.html
  assets/
    style.css
    script.js
    images/
  data/
    posts.json
    profile.json

對於現有網站,在實際可行時保留使用者目前的結構。除非能明顯改善所請求的工作,否則不要重新命名或重新組織網站的大部分內容。

頁面期望

僅建立使用者請求所需的頁面。對於完整的個人網站入門套件,請包含:

  • 首頁:身分、簡短介紹、主題特定的英雄區域、近期文章、精選專案。
  • 關於:自傳、興趣、技能、聯絡方式、社交連結、可選的履歷/出版物。
  • 部落格索引:文章清單,包含標題、日期、標籤和摘要。
  • 文章頁面:可讀的文章佈局,包含標題、日期、標籤、內容和返回部落格索引的導覽。
  • 專案:專案卡片或列,包含描述、技術堆疊、連結和成果。

保持首頁有用。當使用者要求個人網站或部落格時,不要建立行銷登陸頁面。

對於完整的個人網站或部落格入門套件,不要只停留在單一首頁。建立可運作的具代表性頁面類型,即使內容只是佔位符:

  • 至少一篇部落格的文章/詳細頁面。
  • 當文章、筆記、專案或出版物是網站的一部分時,建立一個清單或歸檔頁面。
  • 當首頁連結到身分或背景細節時,建立一個個人資料/關於頁面。
  • 任何所選概念暗示的特殊頁面,例如筆記、連結、花園、現在、使用、出版物或實驗。

對於大型的未來內容集合,建立結構和一些具代表性的佔位符條目,而不是虛構完整的檔案庫。

路徑相容性規則

產生的純靜態網站必須在使用者直接開啟 index.html、透過本地 HTTP 提供服務以及部署到常見靜態主機時都能運作。

預設規則:

  • 對所有網站本地連結和資源使用頁面相對路徑。
  • 從根頁面,將 CSS/JS/圖片連結為 assets/style.css、assets/script.js、assets/images/avatar.png,頁面連結為 about.html 或 posts/example.html。
  • 從巢狀頁面(例如 posts/example.html),將共享資源連結為 ../assets/style.css,根頁面連結為 ../blog.html 或 ../index.html。
  • 除非使用者明確接受僅限伺服器根目錄的行為,否則不要使用根目錄絕對路徑的網站本地路徑,例如 /assets/style.css、/assets/script.js、/posts/example.html、/data/posts.json、/images/foo.png 或 /。
  • 對 CSS url(...)、favicon、Open Graph 圖片、封面圖片、字型、KaTeX/數學供應商資源、RSS/sitemap 連結和 JavaScript 產生的 URL 應用相同規則。
  • 移動或新增頁面時,根據該頁面的資料夾深度重新計算路徑,而不是從根頁面複製連結。

避免僅限伺服器的假設:

  • 如果直接開啟預覽是承諾的一部分,請不要依賴 fetch("data/posts.json") 或其他本地檔案擷取來進行核心導覽、文章清單或首頁內容。
  • 如果重複資料有用,請直接在 HTML 中渲染必要內容,或將資料儲存在使用相對 <script src="assets/script.js"> 載入的本地 JavaScript 物件中。
  • 可選的增強功能可以使用資料檔案,但前提是即使沒有該次擷取,頁面仍然可以正確讀取和導覽。

樣式規則

讓所選的主題引導視覺語言,但保持網站可讀且可維護。

  • 將全站樣式放在 assets/style.css 中。
  • 使用 CSS 自訂屬性來設定顏色、間距、邊框和字型選擇。
  • 盡可能使用語意化 HTML:header、nav、main、article、section、footer。
  • 使用響應式佈局規則,讓頁面在行動裝置和桌面上都能運作。
  • 如果主題在視覺上強烈,讓文章頁面比首頁更平靜。
  • 除非使用者要求特定字型或主題強烈需要,否則偏好系統字型。
  • 除非使用者提供或明確可接受,否則不要依賴遠端資源。
  • 不要讓裝飾效果阻礙閱讀、導覽或無障礙性。

互動規則

僅在原生 JavaScript 能增加明確價值時使用。

良好的用途:

  • 行動導覽切換。
  • 主題切換。
  • 輕量級標籤或文章篩選。
  • 不影響核心閱讀的小型漸進式效果。

避免:

  • 重量級動畫框架。
  • 除非使用者明確要求,否則避免以 Canvas 為主的裝飾。
  • 需要開發伺服器或套件安裝的效果。
  • 持續閃爍、強烈故障效果或損害閱讀的滾動效果。

對於動畫主題,請尊重 prefers-reduced-motion。

靜態簡化規則

當寬鬆參考具有複雜或依賴框架的功能時,將其轉換為更簡單的靜態等效項:

  • 3D 地球 -> 主題地圖、狀態面板、專案星座或靜態視覺區塊。
  • 動畫便當盒網格 -> 帶有微妙懸停狀態的響應式 CSS 網格。
  • 終端機模擬器 -> 主題化導覽和日誌風格內容,而不是假命令列,除非有用。
  • 知識圖譜 -> 標籤、相關文章、主題索引或手動策劃的連結。
  • 動態搜尋 -> 簡單的篩選輸入、靜態標籤頁面,或第一個版本不提供搜尋。
  • CMS 驅動的文章 -> posts/*.html 加上 data/posts.json。

偏好一個能捕捉使用者所需感覺的乾淨靜態版本,而不是過度建置的參考副本。

現有網站規則

修改現有網站時:

  • 在編輯前檢查目前的檔案結構。
  • 保留使用者內容和不相關的檔案。
  • 將變更範圍限制在所請求的頁面和資源。
  • 當現有視覺慣例已經有效時,重複使用它們。
  • 除非使用者要求完整重新設計,否則避免取代整個網站。
  • 如果網站已經有 style.css 或 script.js,請小心擴展它們,而不是建立衝突的重複檔案。

內容規則

對於少量內容,直接撰寫靜態 HTML。

對於重複內容,例如文章或專案,請使用以下任一方式:

  • 當清單很短時,使用靜態重複 HTML。
  • 當能提高可維護性時,使用本地 JavaScript 資料物件加上原生 JavaScript 渲染。
  • 僅在該功能允許網站需要本地 HTTP/靜態主機服務,且核心頁面在沒有它時仍能運作的情況下,才使用小型 JSON 檔案。

不要虛構詳細的個人事實。當使用者資料缺失時,清楚使用佔位符。

保持佔位符易於尋找和替換。優先將重複內容儲存在名稱清楚的位置,例如 data/*.json、assets/script.js 中有文件說明的資料區塊,或帶有穩定類別名稱的重複 HTML 區段。

在檔案或 EDITING.md 中清楚標記僅為佔位符的文字、示範文章、範例專案和模擬連結,以便使用者或未來的模型在發布前替換它們。

編輯指南規則

建立新網站或對現有網站進行重大重新設計時,請在輸出資料夾中包含 EDITING.md。

EDITING.md 主要是為未來將修改所產生網站的模型或代理程式而設計。保持簡潔但具體。解釋:

  • 資料夾層次結構以及每個檔案/資料夾的用途。
  • 網站使用的檔案格式:HTML、CSS、JS、JSON/資料區塊和圖片。
  • 頁面地圖:哪個產生的檔案是首頁、關於/個人資料、部落格/清單、文章/詳細、專案、筆記、連結或其他頁面類型。
  • 共享佈局區域:頁首、導覽、行動導覽、主要內容、頁尾、側邊欄、覆蓋層或主題控制。
  • 每個主要首頁區域在 index.html 中的位置,使用附近的 section/class 名稱。
  • 每個子頁面模板的位置以及內部連結如何連接到它。
  • 重複內容的儲存位置及其預期的物件/標記格式。
  • 如何更改網站標題、標語、頭像/標誌、導覽、精選文章、專案清單、連結清單、圖片、顏色和主題變數。
  • 哪些內容僅為佔位符,應在發布前替換。

編碼完整性規則

產生的原始檔必須是有效的 UTF-8,並且在原始形式下是人類可讀的,而不僅僅在瀏覽器螢幕截圖中看起來正確。

對於包含中文、日文、韓文、帶重音符號的拉丁文字或其他非 ASCII 內容的頁面或編輯指南:

  • 在 HTML 檔案中包含 <meta charset="utf-8">。
  • 將檔案寫成 UTF-8 格式。
  • 在最終交付前,使用支援 UTF-8 的閱讀器驗證原始碼的可讀性。

…

[翻譯時已截斷]

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

相關技能