Communitygithub.com

Gyschuaner/從構想到個人網站

在個人網站或部落格的風格方向大致確定後,開始建置原創網站前使用此技能。它會搜尋符合所選方向的真實網站、模板、作品集、部落格、螢幕截圖或設計範例,並在工具可用時利用瀏覽器或螢幕截圖工具進行檢查,最後將發現轉化為實用的設計參考摘要,供 make-personal-site 使用。適用於尋找自然技術部落格、舒適研究首頁、粗獷主義作品集、數位花園、極簡筆記網站或任何仍需具體範例的指定視覺方向等需求。

從構想到個人網站 是什麼?

此技能旨在將使用者對於個人網站或部落格的抽象風格方向,轉化為具體、可驗證的設計參考,作為實際建置前的必要研究步驟。它不直接建置網站,也不複製單一目標網站,而是透過多重角度搜尋(例如:情緒關鍵字、網站類型、結構模式、來源平台),找到 4-8 個相關的參考範例,並在可能的情況下使用互動式瀏覽工具或 Playwright 進行實際檢查。該技能會從佈局、導覽、視覺系統、互動效果及響應式行為等方面提取可重複使用的設計模式,同時明確標示哪些元素(如個人標識、原始碼、資產)應避免複製。最終產出一份具體的設計簡報,直接交付給 `make-personal-site` 進行開發,確保方向足夠明確,無需額外研究。此技能在 Cursor、Claude Code 或 Codex 等平台上皆可運行,尤其適合不提供單一目標 URL、而是根據「品味描述」建置原創網站的情境。

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

在你喜歡的 AI 中提問

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

說明文件

尋找風格參考

目標

在實作之前,將已選擇或粗略描述的個人網站風格,轉化為具體、可驗證的設計參考。

此技能屬於研究與設計簡報技能。它不會建置網站,也不會複製單一目標網站。它會找出多個真實參考範例,檢查它們,提取可重複使用的設計模式,並產出可供 make-personal-site 使用的建置就緒簡報。

合約

輸入:

  • 使用者的風格方向、主題詞彙、網站類型、目標受眾、內容範圍、參考資料或限制條件。
  • 可選擇包含或排除的範例、偏好的平台/模板來源,以及目標網站結構。

輸出:

  • 4-8 個相關的參考候選項目(若有的話),附上來源 URL 和簡短的選擇理由。
  • 對於選定的參考項目,在工具可用時提供瀏覽器或螢幕截圖觀察結果。
  • 一份實用的參考摘要,涵蓋佈局、導覽、首屏、文章列表、文章細節、專案/關於等區域、顏色、字體排版、圖像、動畫、互動以及響應式行為。
  • 清晰的「借鑑」與「避免」備註。
  • 最終提供給 make-personal-site 的建置交接資訊。

界限:

  • 不要實作網站。
  • 不要複製受保護的原始碼、圖片、個人身分、分析 ID 或品牌資產。
  • 不要將一個參考視為複製目標。如果使用者想要複製某個特定網站,請將其導向 copy-website-style。
  • 不要花時間在框架安裝或建置可行性上;此技能僅研究設計參考。

成功門檻:

  • 方向已奠基於具體參考,且對於 make-personal-site 建置一個原創靜態網站來說已足夠具體。
  • 參考研究使用了多種搜尋角度,而非單一關鍵字。
  • 若可能,至少檢查了 3 個強參考,除非使用者明確要求快速草稿。
  • 最終簡報區分可重複使用的設計語言與不應複製的內容/身分。

若未達門檻:

  • 使用更廣泛或替代的關鍵字進行搜尋。
  • 檢查一組較小但更強的參考。
  • 若方向本身仍不明確,則返回 search-blog-theme。
  • 僅在多個參考系列會導致截然不同的網站時,提出一個簡潔的偏好問題。

使用時機

在以下情況使用此技能:

  • 使用者已經給出一個廣泛的方向,例如自然技術部落格、安靜的研究首頁、復古終端檔案、舒適的筆記網站或粗獷主義作品集。
  • search-blog-theme 已推薦了一個方向,但在建置前仍需要實際範例。
  • from-idea-to-personal-site 正要根據品味詞彙而非具體參考 URL 來建置原創網站。
  • 在 make-personal-site 之前,代理需要更多的視覺基礎。

在以下情況不要使用此技能:

  • 使用者尚未選擇任何方向;請使用 search-blog-theme。
  • 使用者提供了一個目標 URL 並希望接近複製;請使用 copy-website-style。
  • 網站已存在且只需要一個小變更;請使用 edit-site-part。

工作流程

  1. 在內部將風格方向重新表述為可搜尋的關鍵字。 輸入:使用者的品味和網站目的。 輸出:5-10 個跨越多個角度的搜尋詞組。 門檻:搜尋詞組涵蓋情緒、網站類型、視覺系統、結構,以及至少一個替代措辭。

  2. 搜尋真實參考。 輸入:搜尋詞組。 輸出:候選網站、模板、作品集、部落格、設計頁面或 GitHub 示範。 門檻:在確定參考資料前,至少使用 3 個不同的搜尋角度,除非使用者明確要求快速草稿。

  3. 檢查選定的參考。 輸入:頂尖候選項目。 輸出:瀏覽器/螢幕截圖觀察結果。 門檻:若可能,至少檢查 3 個強參考;當方向廣泛時,使用 4-6 個。

  4. 提取設計模式。 輸入:已檢查的參考。 輸出:可重複使用的模式與反模式。 門檻:備註內容應關於佈局、層級、互動、字體排版、顏色、內容密度和響應式行為,而不僅僅是感覺。

  5. 綜合一份建置簡報。 輸入:參考模式加上使用者限制條件。 輸出:提供給 make-personal-site 的一份簡潔設計簡報。 門檻:簡報足夠具體,可在無需另一次研究的情況下實作。

搜尋指南

從以下元素的組合建構搜尋:

  • 網站類型:個人網站、個人部落格、作品集、研究首頁、數位花園、筆記網站、開發者部落格。
  • 情緒:自然、平靜、編輯風格、舒適、原始、粗獷主義、終端、檔案、筆記本、花園、極簡、俏皮、科學。
  • 結構:部落格首頁、文章索引、專案網格、側邊導覽、便當盒佈局、時間軸、筆記檔案、現在頁面。
  • 來源:v0 模板、Figma 社群、GitHub 主題、個人網站、Astro/Hugo/Jekyll/Quartz 範例、設計靈感網站。

偏好具體詞組勝過模糊詞組。例如:

  • 自然 開發者 個人網站
  • 平靜 技術 部落格 個人網站
  • 數位花園 自然 靈感 設計
  • 研究 首頁 個人網站 極簡
  • 個人部落格 模板 筆記 專案

不要只停留在一個搜尋詞組或第一個吸引人的結果。對於像「賽博龐克技術首頁」這樣的方向,請跨越多個角度進行搜尋,例如:

  • 賽博龐克 開發者 個人網站
  • 未來 技術 部落格 個人網站
  • 終端 賽博龐克 作品集 網站
  • 霓虹 粗獷主義 個人網站
  • 科幻 介面 個人首頁

使用當前網路搜尋參考資料,因為模板、作品集和設計範例會隨著時間改變。

瀏覽器檢查

對於每個強參考,使用實際可用的互動式瀏覽器工具檢查即時頁面。「可用」意味著它在當前輪次的可呼叫工具列表中已暴露。在 Codex 中,這可能是當路由到該輪次時,Browser/應用內瀏覽器插件;在其他代理中,它可能是等效的可視瀏覽器、browser-use 工具或 devtools 支援的瀏覽器。

如果沒有任何互動式瀏覽器工具可呼叫,請不要假設參考已透過瀏覽器進行視覺檢查。如果視覺參考的準確性很重要,請要求使用者啟用或呼叫瀏覽器工具;對於 Codex,這可能意味著發送一個明確提及 @browser 的請求。如果使用者未重新路由或用戶端沒有此類工具,則回退使用 Playwright、螢幕截圖、搜尋結果片段、源碼頁面或書面描述,並說明此限制。

當互動式瀏覽器工具實際可呼叫時,不要預設使用 Playwright、僅螢幕截圖的審查或搜尋結果片段。螢幕截圖可以在互動式瀏覽器檢查後作為證據捕獲,但它們不能替代互動式檢查。僅在無互動式瀏覽器工具可呼叫、使用者明確要求,或需要可重複的腳本化比較時,才將 Playwright 用作備援方案。

檢查:

  • 首個視口:立即有用的內容是什麼?
  • 導覽:頂部導覽、側邊導覽、命令/選單、標籤、搜尋、檔案連結。
  • 內容模型:文章、筆記、專案、關於、連結、記錄、現在、花園、履歷。
  • 閱讀體驗:文章寬度、字體排版、程式碼區塊、數學公式、圖片、註腳、目錄。
  • 視覺系統:調色板、間距、邊框半徑、密度、卡片、分隔線、紋理、圖像。
  • 動畫與互動:懸停狀態、主題切換、篩選器、搜尋、滾動效果、頁面過渡。
  • 響應式行為:在行動裝置上應發生什麼?
  • 風險:哪些部分會變得難以閱讀、過於普通、過於沉重或過於接近來源?

如果瀏覽器工具不可用,請使用源碼頁面、搜尋結果片段、螢幕截圖和書面備註,並說明視覺檢查受到限制。

輸出格式

保持回覆自然且有用。不要暴露冗長的隱藏過程日誌。

包含:

  • 簡短建議:最適合建置的強烈方向。
  • 參考資料:4-8 個項目,附上 URL/來源以及每個項目的重要性說明。
  • 借鑑:要採用的具體模式。
  • 避免:不要複製的內容,或會損害使用者網站的內容。
  • 建置簡報:提供給 make-personal-site 的確切方向。
  • 交接:推薦的下一個技能以及任何來源限制。

當使用者要求快速答案時,將輸出壓縮為最相關的 3-5 個參考資料和一份簡報。

建置簡報要求

最終簡報應指定:

  • 網站識別:用一句話描述網站應給人的感覺。
  • 頁面範圍:首頁、部落格索引、文章詳細頁、專案、關於、筆記/記錄、連結或其他頁面。
  • 首屏:立即出現的有用內容是什麼。
  • 佈局:導覽、內容欄、側邊欄、卡片/列表、檔案結構。
  • 視覺系統:調色板、字體樣式、間距、邊框、圖像、圖示樣式。
  • 互動:主題切換、篩選/搜尋、複製按鈕、懸停狀態、可選動畫。
  • 響應式行為:行動裝置導覽和內容優先級。
  • 請勿複製:原始個人身分、文章、資產、標誌、專有程式碼、分析或確切的品牌處理方式。

交接

在簡報準備好後:

  • 將原創網站建置路由至 make-personal-site。
  • 將單一網站的接近複製路由至 copy-website-style。
  • 將未解決的方向選擇路由回 search-blog-theme。

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

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.

相關技能