关于 seo-content
seo-content 是用于撰写或改写单篇搜索优化文章的营销技能,面向内容创作者。它围绕搜索意图、搜索结果缺口、用户提供的经验及页面元数据组织流程。
主要功能
- 01分析搜索意图与结果页
- 02制定文章简报和大纲
- 03撰写 SEO 文章
- 04生成元数据与 JSON-LD
- 05质量检查与追踪建议
适用场景
- 01撰写关键词导向的指南或比较文
- 02改写现有文章以适配搜索
- 03准备文章元数据和结构化数据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sanky369/ vibe-building-skills --skill seo-content安装后在 Claude Code 中输入/seo-content确认已加载。
附带文件references/article-templates.md
详细介绍
SEO 内容
撰写一篇既能获得排名、又读起来流畅的文章:针对目标关键词优化搜索,同时切实帮助搜索者。首要原则:准确匹配搜索意图——Google 会优先推荐搜索者想要的内容形式;无论文章写得多好,形式不对就无法获得排名。第二条原则:每篇文章都必须包含当前排名靠前的结果中没有的内容(例如、数据、独特角度或更深入的分析),否则就没有理由超越它们。
何时使用/何时不使用
- 用于撰写或改写一篇针对特定搜索词的文章(博客文章、指南、清单文章、对比文章)。
- 如果用户没有关键词和策略,只是问“我到底该写什么?”,请先运行
skills/marketing/seo-strategy(如果只需要关键词列表,则运行skills/marketing/keyword-research)。 - 如果内容是注重转化而非排名的落地页/销售页,请使用
skills/marketing/direct-response-copy。 - 如果用户想将文章改编成社交媒体或电子邮件内容,请使用
skills/marketing/content-atomizer。
信息收集
一次性询问所有缺失的信息:
- 目标关键词(以及用户已有的次要关键词)。
- 受众和产品——谁会阅读这篇文章,以及业务希望读者接下来采取什么行动(CTA)。
- 独特素材——可以使用的第一手经验、示例、数据或客户故事。这是 E-E-A-T 的核心;至少追问一项具体素材。
- 语气——现有的品牌语气指南或 2–3 篇可供参考的文章。如果已有
skills/marketing/brand-voice的输出,请使用它。
如果请求来自 skills/marketing/seo-strategy,且已包含关键词、意图和 SERP 备注,请直接跳到第 2 步。如果缺少信息,请说明假设(受众、意图、CTA)并继续——不要停下来等待。
工作流程
1. 验证 SERP 并确定意图
搜索目标关键词(条件允许时使用网页搜索)。判断搜索意图,并据此决定内容形式:
| 意图 | 搜索者想要 | 撰写内容 |
|---|---|---|
| 信息型 | 学习/执行 | 操作指南或终极指南 |
| 商业型 | 比较/选择 | 清单文章、对比文章、评测 |
| 交易型 | 购买 | 产品/定价页面 → 转交给 skills/marketing/direct-response-copy |
| 导航型 | 查找特定品牌 | 通常跳过——你无法超越该品牌的排名 |
记录排名前 5 的结果中的内容长度和深度、结构、涵盖的子主题,以及——最重要的——缺口:哪些内容浅显、过时、未解答或缺失。如果无法指出缺口,请告知用户这个关键词不值得投入,并建议返回 skills/marketing/seo-strategy 寻找更好的目标。如果无法进行网页搜索,请说明这一点,根据关键词的语法推断意图,并将 SERP 分析标注为假设。
2. 撰写简报
起草前先填写以下内容(它将成为交付成果的一部分):
- 主要关键词、次要关键词、意图、目标长度
- 内容角度:用一句话说明这篇文章胜过当前搜索结果的原因
- H2 大纲(完整文章包含 5–8 个部分),其中包括常见问题解答部分
- E-E-A-T 要素:各处将使用哪些第一手示例/数据
- 内部链接(用户网站上的 3–5 个页面)、外部链接(2–3 个权威来源)
- CTA:要求读者采取的单一行动
根据竞争程度设定长度(经验法则——真正的目标是内容全面,凑字数反而有害):低竞争度为 1,500–2,000 字;中等竞争度为 2,000–3,000 字;高竞争度为 3,000 字以上。切勿超出搜索意图所需的长度。
3. 起草
阅读 references/article-templates.md,了解所选格式(操作指南、清单文或终极指南)的完整框架,并按照框架撰写。起草时:
- 开篇直接回答查询,用前 2–3 句话作答,然后引导读者继续阅读。不要写冗长的铺垫。
- 关键词布局:在标题标签(尽量靠前)、H1、前 100 个词、正文中自然出现 2–3 次,并放入 URL slug。合适时在 H2 中加入次要关键词。切勿堆砌关键词。
- 结构:仅有一个 H1;每个主要部分使用 H2;每 200–300 个词设置一个小标题;每段不超过 3 句话;凡是包含 3 项或以上的列表,都使用项目符号;加粗重点。
- 页面上的 E-E-A-T:至少包含一个亲历示例或案例;引用 2–3 个权威外部来源;使用具体数字,避免含糊的说法。
- FAQ 部分:列出 4–6 个措辞准确的问题,每个答案 40–60 个词(用于争取精选摘要)。
- 结尾:用 3–5 条项目符号总结要点,并且仅包含一个 CTA。
用户提供亲身经历;你负责组织结构并润色。切勿编造亲身经历、用户评价或统计数据——如果用户没有提供独特素材,请使用明确标注为通用的示例,并告知他们应在哪里加入自己的内容。
4. 元数据和 Schema
生成:标题标签(50–60 个字符,关键词靠前且有吸引力)、元描述(150–160 个字符,包含关键词和轻量 CTA)、URL slug(简短、包含关键词、用连字符连接)、图片替代文本建议,以及 JSON-LD Schema(有 FAQ 时使用 FAQ Schema;否则使用 Article Schema——从 references/article-templates.md 复制可直接粘贴的代码块)。
5. 自我审查,然后交付
按照以下质量标准检查。修正所有不合格项后再提交。使用所需的输出格式交付,并建议通过 Google Search Console 跟踪(展示次数、点击次数、CTR、平均排名),待文章获得索引并稳定后进行一次复查。
所需输出格式
# [Article Title]
## Brief
- Primary keyword: … · Secondary: … · Intent: [type]
- Angle (why this beats the SERP): …
- Target length: … · CTA: …
- Gap exploited: [what top results miss]
## Metadata
- Title tag (50–60 chars): "…" [char count]
- Meta description (150–160 chars): "…" [char count]
- URL slug: /…
- Schema: [FAQ / Article] (JSON-LD below article)
## Article
[Full draft, H1 through conclusion, with [INTERNAL LINK: page] and
[EXTERNAL LINK: source] markers inline, image suggestions as
[IMAGE: description — alt text: "…"]]
## Schema markup
```json
[JSON-LD block]
```
## On-page checklist
[Each quality-bar item with pass/fail]
## Next steps
- Insert your own examples at: [marked spots, if any]
- Track in GSC: [what to watch, and the decision each signal triggers]
质量标准
逐项检查;交付前修正:
- 格式符合已验证的搜索意图
- 标题标签为 50–60 个字符且包含关键词;元描述为 150–160 个字符——逐个计算字符数,不要估算
- 仅有一个 H1,且包含主要关键词;关键词出现在前 100 个词内
- 主要关键词在正文中出现 2–3 次——不得更多(检查是否堆砌:朗读标题;如果听起来生硬,就改写)
- 草稿确实填补了相较于排名靠前结果的明确差距
- 至少包含一个亲历示例或明确标注的示例占位符;所有统计数据均有引用或已删除;没有编造的经历或用户评价
- 3–5 个内部链接标记,2–3 个权威外部链接标记
- FAQ 的每个答案均为 40–60 个词
- 仅有一个 CTA
- 易于浏览:每段不超过 3 句话,每 200–300 个词设置一个小标题
集成
skills/marketing/seo-strategy— 向此技能提供关键词、搜索意图、主题集群和 SERP 备注;返回已发布文章的 slug,以便及时更新内部链接。skills/marketing/keyword-research— 可作为目标关键词的轻量级替代来源。skills/marketing/brand-voice— 提供第 3 步中采用的品牌语气指南。skills/marketing/direct-response-copy— 负责处理交易型意图页面和 CTA 较多的部分。skills/marketing/content-atomizer— 将完成的文章作为种子内容,用于制作社交帖子、串文和新闻简报内容。skills/marketing/newsletter— 文章是新闻简报中很合适的特色内容;传递标题、链接和一句话引子。
参考资料
references/article-templates.md— 操作指南、清单文/汇总文和终极指南格式从 H1 到结论的完整框架,以及可直接复制粘贴的 FAQ 和 Article JSON-LD Schema。请在第 3 步起草前阅读。