Communitygithub.com

Gyschuaner/从创意到个人网站

在个人网站或博客的风格方向大致确定后、开始构建原创网站前使用此技能。它会搜索符合所选方向的真实网站、模板、作品集、博客、截图或设计示例,并在可用时使用浏览器或截图工具进行检查,然后将发现转化为实用的设计参考简报,供 make-personal-site 使用。适用于诸如寻找自然风格技术博客、温馨研究主页、粗野主义作品集、数字花园、极简笔记站点或任何命名视觉方向(仍需具体示例)的请求。

从创意到个人网站 是什么?

此技能是一个专门的设计调研与简报生成工具,专为 AI 代理(如 Claude Code、Cursor、Codex)设计,用于在构建个人网站之前,将模糊的风格方向转化为具体的、经过验证的设计参考。它不直接构建网站,也不克隆单一目标站点,而是通过多角度搜索并检查 4-8 个真实参考案例(包括网站、模板、作品集等),提取可复用的设计模式(如布局、排版、交互、色彩),并输出一个可直接交付给 `make-personal-site` 使用的构建简报。该技能强调使用交互式浏览器工具进行视觉检查,并严格区分“借鉴”的设计语言与“不可复制”的内容/品牌资产。若检查不充分(如参考数不足 3 个),它会自动调整搜索策略;若风格方向完全未定,则会回退到 `search-blog-theme`。

兼容平台~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 使用的简洁设计简报。 条件:简报足够具体,无需另一轮调研即可实现。

搜索指导

通过组合以下内容构建搜索:

  • 网站类型:个人网站、个人博客、作品集、研究主页、数字花园、笔记站点、开发者博客。
  • 情绪:自然、安静、编辑风、温馨、原始、粗野主义、终端、档案、笔记本、花园、极简、有趣、科学。
  • 结构:博客首页、文章索引、项目网格、侧边导航、便当盒、时间线、笔记存档、Now 页面。
  • 来源:v0 模板、Figma 社区、GitHub 主题、个人网站、Astro/Hugo/Jekyll/Quartz 示例、设计灵感网站。

偏好具体短语而非模糊短语。例如:

  • natural developer personal website
  • calm technical blog personal site
  • digital garden nature inspired design
  • research homepage personal website minimal
  • personal blog template notes projects

不要在一个搜索短语或第一个吸引人的结果后就停止。对于一个诸如“赛博朋克技术主页”的方向,应跨多个角度进行搜索,例如:

  • cyberpunk developer personal website
  • futuristic technical blog personal site
  • terminal cyberpunk portfolio website
  • neon brutalist personal website
  • sci fi interface personal homepage

使用当前的网络搜索来获取参考,因为模板、作品集和设计示例会随时间变化。

浏览器检查

对于每个强参考,使用实际可用的交互式浏览器工具检查实时页面。“可用”意味着它在当前轮次的可调用工具列表中公开。在 Codex 中,当其被路由到当前轮次时,这可能指浏览器/应用内浏览器插件;在其他代理中,它可能是一个等效的可见浏览器、browser-use 工具或 devtools 支持的浏览器。

如果没有可调用的交互式浏览器工具,请不要假装参考已在浏览器中经过视觉检查。如果视觉参考的保真度很重要,请要求用户启用或调用浏览器工具;对于 Codex,这可能意味着发送一个明确提及 @browser 的请求。如果用户没有重新路由,或者客户端没有此类工具,则回退到 Playwright、截图、搜索结果片段、源页面或书面描述,并说明限制。

当交互式浏览器工具实际可调用时,不要默认使用 Playwright、仅截图审查或搜索结果片段。截图可以在交互式浏览器通过后作为证据捕获,但不能替代交互式检查。仅当没有可调用的交互式浏览器工具、用户明确要求使用,或需要可重复的脚本化比较时,才将 Playwright 作为回退方案。

检查:

  • 首屏:哪些內容立即可用?
  • 导航:顶部导航、侧边导航、命令/菜单、标签、搜索、存档链接。
  • 内容模型:博文、笔记、项目、关于、链接、记录、Now、花园、简历。
  • 阅读体验:文章宽度、排版、代码块、数学公式、图片、脚注、目录。
  • 视觉系统:调色板、间距、圆角半径、密度、卡片、分隔线、纹理、图像。
  • 动效与交互:悬停状态、主题切换、筛选、搜索、滚动效果、页面过渡。
  • 响应式行为:移动端应发生什么?
  • 风险:哪些部分会变得难以阅读、过于通用、过于沉重或与来源过于相似?

如果浏览器工具不可用,请使用源页面、搜索结果片段、截图和书面描述,并说明视觉检查有限制。

输出格式

保持回复自然且有帮助。不要暴露冗长的隐藏处理日志。

包含:

  • 简短推荐:最值得构建的方向。
  • 参考: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.

相关技能