Communitygithub.com

Gyschuaner/from-idea-to-personal-site

当用户需要为个人博客、个人主页、作品集、研究主页、数字花园或静态网站寻找、比较、选择或适配视觉主题时使用此技能。它能将来自 v0、Figma、GitHub 主题、现有网站、截图、关键词或自然语言品味偏好的参考,转化为自然、实用的主题推荐。

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

该技能专注于帮助开发者发现并塑造个人网站或博客的视觉方向,而不是直接构建网站或编写代码。它通过理解用户的身份、网站目标、受众和内容类型,结合来自 v0、Figma、GitHub 主题、现有网站 URL、截图或风格关键词的参考,提出 3-5 个有区分度的主题方向。每个方向都附带经过验证的参考 URL,并最终推荐一个最符合用户个性的视觉路径,包括应借鉴和避免的视觉元素。 该技能强调“个人化”而非“通用化”——例如,不满足于“极简博客”这样的通用标签,而是将其转化为“田野实验笔记本”等更具个人隐喻的概念。它适用于 Claude Code、Cursor 等 AI 代理平台,并严格遵循边界:不构建文件、不编辑代码、不复制受保护模板。其最终目标是让用户获得足够具体的、可交接给 `make-personal-site` 或 `copy-website-style` 等实施技能的方向。 通过内部工作流,该技能会先理解用户偏好,然后搜索并验证公开参考资源,确保每个推荐都有可信来源。它包含明确的“不使用条件”,防止误用,并提供了候选主题系列(如极简笔记本、开发者作品集、研究主页、数字花园等)作为灵感起点。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

搜索博客主题

目标

帮助用户为个人博客或个人网站发现强有力的视觉方向。

此技能是一个主题发现和品味塑造技能。它不应构建网站、编写页面代码或过度关注实现细节。其职责是提出有区分度的方向,验证有用的参考,并推荐一条视觉路径,以指导后续的网站生成或重新设计。

契约

输入:

  • 用户的品味偏好、身份、网站目标、受众和内容类型。
  • 可选的参考,如 URL、截图、v0 模板、Figma 链接、GitHub 主题或风格关键词。
  • 约束条件,如个人博客、作品集、研究主页、数字花园、纯静态网站或框架偏好。

输出:

  • 需要探索时,提供 3-5 个潜在主题方向。
  • 为已命名的模板、网站、仓库或设计示例提供经过验证的参考 URL。
  • 一个推荐的方向,包含视觉语言、应借鉴的内容、应避免的内容以及清晰的下一步交接。

边界:

  • 不要构建文件、编辑代码、迁移文章、个性化现有网站、验证生成的网站或发布。
  • 不要编造具体的模板名称,或将概念方向伪装成已找到的参考。
  • 不要复制受保护的模板代码或资源。

成功条件:

  • 用户拥有足够具体的方向,可以交接给 make-personal-site 或 copy-website-style。
  • 已命名的参考都附带 URL。
  • 推荐感觉是个人化的且适合内容,而非仅仅是通用的风格标签。

如果条件未满足:

  • 搜索或检查更多参考。
  • 将宽泛的标签重构为更具体的个人隐喻。
  • 如果多个方向同样合理,询问一个简洁的偏好问题。

使用时机

当用户出现以下情况时,使用此技能:

  • 想要创建个人博客、个人主页、作品集、研究主页或数字花园。
  • 想要寻找有吸引力、有区分度、不寻常或个人合适的博客主题。
  • 提供 v0、Figma、GitHub 主题、现有网站 URL、截图、图片或风格关键词。
  • 描述风格偏好,例如极简、学术、俏皮、像素风格、面向开发者的、杂志式的、深色模式、复古、实验性、宁静、密集、编辑型或游戏风格。
  • 不确定哪种博客风格适合自己,想要推荐。
  • 想要将参考页面的感觉移植到自己的网站,而不完全照搬。

不应使用的情况

当出现以下情况时,不要使用此技能:

  • 用户已经选择了主题,只想要实现。
  • 用户直接要求编写 HTML/CSS/JS 页面或修改现有代码。
  • 用户只想发布文章、修复部署或迁移 Markdown 内容。
  • 用户要求完全复制商业模板或受版权保护的网站。

如果用户想要实现,则交接给 make-personal-site。 如果用户想要内容迁移或文章导入,则交接给 add-blog-posts。 如果用户想要部署,则交接给 publish-static-site。

内部工作流程

将这些步骤视为内部工作。除非用户明确询问搜索是如何进行的,否则不要叙述它们。

  1. 理解用户的身份、网站目标、品味关键词、参考和约束。
  2. 首先提出 3-5 个潜在主题方向作为概念,而不是模板名称。
  3. 对于每个有希望的方向,搜索或检查来自 v0、Figma、GitHub、现有网站或其他公共来源的相关参考。
  4. 只保留那些可以附带 URL 的参考。如果某个方向没有经过验证的来源,将其标记为概念方向,而非已找到的模板。
  5. 通过区分度、契合度、参考质量、内容适用性和风险来比较这些方向。
  6. 推荐一个主要方向,并在有用时附带 1-2 个备选。

来源验证规则

当命名一个特定的模板、网站、仓库或设计参考时,必须包含 URL。

使用以下区分:

  • 已验证的参考:带有 URL 的已命名来源。
  • 概念方向:没有经过验证来源的原创或推断出的想法。

不要编造模板名称。不要暗示某个模板是已找到的,如果它仅仅是从风格关键词推断出来的。

有区分度的主题规则

当用户要求一个具有区分度、独特、令人难忘或非通用的网站时,不要停留在“极简”、“终端”、“赛博朋克”、“深色模式”或“作品集”等宽泛标签上。

通过添加清晰的隐喻或世界来使方向更加个人化:

  • 弱:终端作品集。
  • 更好:一个用于个人研究日志和项目文件的旧电脑存档。
  • 弱:极简博客。
  • 更好:一个用于实验、阅读笔记和项目痕迹的田野笔记本。
  • 弱:深色开发者网站。
  • 更好:一个用于写作、构建和公开日志的私人操作系统仪表板。

最好的推荐应该感觉像是一个个人化的数字空间,而不仅仅是一种 UI 风格。

应向用户展示的内容

使用自然的散文式语言,结构轻量。不要输出僵硬的 Markdown 模板或围栏式的 Markdown 简报,除非用户特别要求。

响应通常应包含:

  • 开头的简短推荐。
  • 当用户仍在探索时,提供 3-5 个潜在主题方向。
  • 当提及特定模板或网站时,提供带有 URL 的已验证参考。
  • 用平实的语言解释为什么推荐的方向适合用户。
  • 视觉语言:情绪、颜色、字体感觉、布局节奏、交互基调和内容呈现。
  • 应从参考中借鉴什么以及不应复制什么。
  • 一个简洁的下一步建议,例如选择一个方向或将其交接给实施技能。

不应展示:

  • 原始搜索关键词。
  • 内部评分标准。
  • 逐步的过程说明。
  • 冗长的实施检查清单。
  • 详细的 CSS 令牌或代码级别的决策,除非用户要求进行实施规划。

候选主题系列

将这些作为灵感,但要根据用户的身份和参考进行调整。

极简笔记本

一种干净的笔记本风格网站,适用于技术博客、学习笔记和轻量级个人主页。

典型特征:

  • 安静的颜色和强烈的字体排版。
  • 装饰元素少。
  • 最近的写作和精选项目能快速呈现。
  • 当用户的内容有思想深度且以文字为主时效果最佳。

开发者作品集

一种开发者作品集风格,用于展示项目、GitHub 工作、技能和技术写作。

典型特征:

  • 清晰的介绍、精选项目、技术标签和写作入口。
  • 适合希望获得雇佣、合作或项目可信度的用户。
  • 可以借鉴 v0 或 shadcn 风格的布局,但不复制其代码。

研究主页

一种克制的学术主页,适用于研究人员、学生、论文作者和实验室成员。

典型特征:

  • 个人简介、研究兴趣、发表物、项目和简历是核心。
  • 清晰、可信、低噪音。
  • 阅读页面应感觉平静且严肃。

数字花园

一种知识花园风格,适用于 Obsidian 笔记、长期学习和主题索引。

典型特征:

  • 突出标签、主题、关系和最近更新。
  • 主页可感觉像一张地图而非按时间排序的博客。
  • 适合拥有大量笔记或不断演变的想法的用户。

个人操作系统

一种仪表板式个人网站,将用户的工作呈现为文件、日志、模块或系统面板。

典型特征:

  • 没有沦为伪终端噱头的、有力的隐喻。
  • 适合开发者、研究人员、构建者和实验性创作者。
  • 如果隐喻与用户的实际工作紧密相关,则会令人难忘。

档案或田野笔记

一种感觉像档案、实验室笔记本、田野日记或个人研究柜的网站。

典型特征:

  • 非常适合以写作为主的博客、研究笔记、项目历史记录和长期学习。
  • 不如作品集华丽,但比标准博客更个人化。
  • 与日期、标签、注释、引用和项目痕迹配合良好。

俏皮个人网站

一种更具表现力的网站,适用于希望拥有令人难忘的数字空间的用户。

典型特征:

  • 可能使用像素细节、复古 UI、手绘点缀、拼贴或游戏主题。
  • 主页感觉像个人空间而非简历。
  • 装饰应支持个性,而不损害可读性。

风险规则

  • 不要承诺精确的 Figma 到代码或 v0 到代码的复现。
  • 不要复制商业模板代码或受保护的资源。
  • 不要让风格凌驾于用户的身份、写作、项目和内容之上。
  • 当建议的方向是基于概念而非经过验证的模板时,要诚实。
  • 如果用户没有强烈偏好,推荐一个简单、可维护的方向,并带有一个令人难忘的亮点。

完成标准

使用此技能后,用户应拥有:

  • 几个可供选择的有意义的主题方向。
  • 当提及特定模板或网站时,提供经过验证的参考。
  • 一个感觉个人化而非通用的推荐方向。
  • 关于应借鉴何种视觉语言以及避免什么的清晰建议。
  • 一个用于实施或进一步完善的自然下一步。

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

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.

相关技能