SurfSense seo-content-writer 技能实战On-Page SEO 清单、内容写作模板与 Featured Snippet 优化【免费下载链接】SurfSenseOpen-source NotebookLM alternative. Research the open web with live data(Reddit, YT, IG, TikTok, Indeed, Google Search, Maps etc) through one platform, API or MCP server. Join our Discord: https://discord.gg/ejRNvftDp9项目地址: https://gitcode.com/GitHub_Trending/su/SurfSense本篇指南围绕 SurfSense 仓库内置的seo-content-writer技能参考文档 seo-writing-checklist.md 展开完整拆解其 On-Page SEO 检查清单、Markdown 内容写作模板与四类 Featured Snippet 优化模式并结合技能主文件 SKILL.md 的九步工作流、校验检查点与问题分级机制讲清这套清单在技能运行时是如何被落地执行与强制约束的。读完本文你可以完整复用这套清单为 AI 写作流水线建立可验证的质量门槛并理解每一项检查项背后的执行逻辑。1. 文档定位检查清单在 seo-content-writer 技能中的位置seo-writing-checklist.md 是 SurfSense 仓库.cursor/skills/目录下seo-content-writer技能的参考文档之一定位为on-page SEO 检查清单、内容写作模板和 featured snippet 优化模式三合一的执行规范。该技能从外部技能库aaron-he-zhu/seo-geo-claude-skills同步而来同步来源与内容哈希被固化在仓库根目录的 skills-lock.json 中computedHash字段用于校验内容完整性。从目录结构看该技能由三部分构成文件角色SKILL.md技能主文件触发条件、九步工作流、校验检查点、问题分级references/seo-writing-checklist.md本文主角on-page 清单 写作模板 snippet 优化 完整示例references/title-formulas.md标题公式库句式模板、power words、标题长度与 CTR 优化references/content-structure-templates.md七类内容结构模板博客、对比、榜单、教程、评测、支柱页、FAQ 页SKILL.md 的第 7 步Apply On-Page SEO Best Practices明确指向本文档作为写作阶段的完整参考第 9 步的最终自评则依赖其中的各项量化要求如 FAQ 答案 40-60 词、内链 2-5 条等。也就是说这份清单不是给人看的备忘录而是技能执行流程中被引用、被打分、被回填Changes Made记录的运行规范。2. On-Page SEO 检查清单四大类逐项要求清单全文分为Keyword Placement关键词布局、Content Quality内容质量、Readability可读性、Technical技术项四个板块共 20 个勾选项。以下逐项完整保留。2.1 Keyword Placement关键词布局主关键词Primary keyword需要在 6 个位置全部命中这是清单中约束最密集的一组标题Title中包含主关键词H1 中包含主关键词正文前 100 词内出现主关键词至少一个 H2 中包含主关键词结论Conclusion中包含主关键词Meta description 中包含主关键词次级关键词Secondary keywords分布在各 H2/H3 中相关词Related terms自然散布于正文2.2 Content Quality内容质量对主题做全面覆盖comprehensive coverage包含原创性洞察或数据original insights or data提供可执行的操作结论actionable takeaways配有示例与图示包含专家引语或引用用于支撑 E-E-A-TExperience, Expertise, Authoritativeness, Trustworthiness信号2.3 Readability可读性每段 3-5 句清单标注其依据为 CORE-EEAT 基准的 O06 Section Chunking 标准句长有变化避免句式单调使用要点列表bullet points关键短语加粗长内容配目录Table of contents2.4 Technical技术项2-5 条指向相关页面的内链2-3 条指向权威来源的外链图片 alt 文本包含关键词URL slug 中包含关键词在 SKILL.md 的Output Validation检查点中这些要求被进一步量化复核主关键词密度 1-2%文档特别注明这是指南而非硬规则现代搜索引擎更看重语义相关性应通过语义变体覆盖主题、FAQ 至少 3 个问题、内链 2-5 条、每个数据点需标注来源SEO 工具数据 / 用户提供 / 估算。Input Validation侧则要求主关键词与搜索意图匹配、目标字数明确实质性内容最少 800 词、内容类型与受众清晰、竞品 URL 或目标 SERP 特征已识别。3. Content Writing TemplateMarkdown 内容写作模板清单第二部分给出了可直接套用的写作骨架规定了开头 Hook → 问题陈述 → 价值承诺 → H2/H3 主体 → FAQ → 结论 CTA的完整顺序。模板原文如下占位符以方括号标注# [H1 with Primary Keyword] [Hook sentence that grabs attention] [Problem statement or context - why this matters] [Promise - what the reader will learn/gain] [Include primary keyword naturally] [Brief overview of whats covered - can be bullet points for scanability] ## [H2 - First Main Section with Secondary Keyword] [Introduction to section - 1-2 sentences] [Main content with valuable information] [Examples, data, or evidence to support points] [Transition to next section] ### [H3 - Sub-section if needed] [Detailed content] [Key points in bullet format]: - Point 1 - Point 2 - Point 3 ## [H2 - Second Main Section] [Continue with valuable content...] **Pro Tip**: [Highlighted tip or key insight] | Column 1 | Column 2 | Column 3 | |----------|----------|----------| | Data | Data | Data | ## [H2 - Additional Sections as Needed] [Content...] ## Frequently Asked Questions ### [Question from PAA or common query]? [Direct, concise answer in 40-60 words for featured snippet opportunity] ### [Question 2]? [Answer] ### [Question 3]? [Answer] ## Conclusion [Summary of key points - include primary keyword] [Final thought or insight] [Clear call-to-action: what should reader do next?]模板中几个容易被忽略的设计细节恰好与 SKILL.md 第 6 步Structure Content and Write的结构定义一一对应H1 只出现一次且承载主关键词SKILL.md 将其表述为H1 (primary keyword, one per page)引言 100-150 词需同时完成 hook、promise 与主关键词进入前 100 词三件事这正是清单 2.1 节前 100 词检查项的落地位置FAQ 答案限定 40-60 词这个字数区间是刻意对准 Featured Snippet 的抓取长度模板注释中直接写明for featured snippet opportunity引用块 **Pro Tip**与表格模板预置了两种非纯文本元素对应可读性检查项也为下文 Table Snippet 做结构化铺垫。4. Featured Snippet 优化四类模式清单第三部分按 SERP 特征类型给出四种优化写法这是整份文档中最具操作性的一段Definition Snippets定义型句式固定为[Term] is [clear, concise definition in 40-60 words]即先给术语再用 40-60 词给出一句可被直接摘取的定义。这 40-60 词与 FAQ 答案的字数区间一致可见技能对可摘取文本块的长度有统一约束。List Snippets列表型在 H2 之下创建清晰的编号或 bullet 列表。列表项应自包含不依赖上文语境保证被整块摘出后仍可读。Table Snippets表格型使用带清晰表头的对比表格。写作模板中预置的三列表格| Column 1 | Column 2 | Column 3 |就是为这种模式预留的位点。How-To Snippets步骤型每一步用显式编号标注Step 1:、Step 2: 等让搜索引擎能按步骤切分引用。5. 完整示例解析以email marketing best practices为例清单最后附了一篇完整示例文章的输出用于展示清单与模板的综合运用。示例设定为用户要求为小型企业写一封以 email marketing best practices 为关键词的 SEO 文章。示例中值得对照清单逐条验证的要素如下标题与 Meta Description。H1 为 Email Marketing Best Practices: A Complete Guide for Small Businesses——主关键词前置 受众限定符合清单 2.1 的标题与 H1 双命中项。Meta description 附在正文开头并标注了长度158 chars落在 SKILL.md 第 5 步规定的 150-160 字符区间内同时包含主关键词与 CTA。前 100 词命中主关键词。引言用一句设问 hook 开场第二段即点出 email marketing best practices isnt optional—its essential for survival完成前 100 词检查项随后以 bullet 列出文章四大看点建立高质量列表、提升打开/点击率、个性化策略、常见错误对应模板的brief overview位。带来源的统计数据。Why Email Marketing Matters 小节给出三组量化数据SMB 邮件获客依赖度、社交分享倍数、个性化邮件成交率倍数并在文末列出来源DMA、Emarsys 等统计出处——SKILL.md 在 Example 章节明确将此作为示例的展示点statistics with sources。这同时满足内容质量项original data与 R01 数据精确性约束。对比表格。Implement Double Opt-in 小节用一张 Single Opt-in vs Double Opt-in 的对照表订阅规模、退信率、互动度、可交付性四个维度呈现是 Table Snippet 模式的示范也呼应清单图片/表格替代纯文本的可读性要求。Pro Tip 引用块。The best lead magnets solve a specific, immediate problem for your target audience. 以 **Pro Tip**引用块呈现对应模板中预置的高亮位。FAQ 与 40-60 词答案。三个问题发送频率、合格打开率、能否购买列表的答案均控制在短段落内例如频率问题答 sending 1-2 emails per week strikes the right balance打开率问题给出 20-25% 的基准区间并提示以自身基线为准而非行业均值购买列表问题以 Never 开头给出可直接摘取的否定式结论——这正是 Definition/FAQ Snippet 偏爱的直给句式。结论与 CTA。结论回扣主关键词email marketing best practices给出今天先做一个改进的行动建议末尾是明确的 CTA下载 Email Marketing Checklist并在文尾附内链与来源列表。SKILL.md 总结该示例演示了关键词进入 H1 与前 100 词、带来源的统计、对比表格、bullet 列表、Pro Tip、40-60 词 FAQ 答案、结论 CTA 的完整闭环。6. 实现纵深九步工作流如何强制执行这份清单清单本身只是纸面规则真正的约束力来自 SKILL.md 定义的九步工作流。以下把与本文档直接咬合的执行机制拆开讲。6.1 写作前CORE-EEAT 16 项前置约束第 2 步要求动笔前加载 CORE-EEAT 质量约束其中 16 项为全内容类型通用的前置检查项与清单的可读性/内容质量条目形成互补关系ID标准应用方式C01Intent Alignment标题承诺必须与内容交付一致C02Direct Answer核心答案出现在前 150 词内C06Audience Targeting明确写出本文面向谁C10Semantic Closure结论回应开头问题并给出下一步O01Heading HierarchyH1→H2→H3不得跳级O02Summary Box包含 TL;DR 或 Key TakeawaysO06Section Chunking每节单主题段落 3-5 句O09Information Density无填充内容术语前后一致R01Data Precision至少 5 个带单位的精确数字R02Citation Density每 500 词至少 1 条外部引用R04Evidence-Claim Mapping每个论断都有证据支撑R07Entity Precision人名/机构/产品使用全称C03Query Coverage覆盖至少 3 种查询变体同义词、长尾O08Anchor Navigation带跳转链接的目录O10Multimedia Structure图片/视频有说明且承载信息E07Practical Tools提供可下载模板、清单或计算器注意 O06段落 3-5 句正是 seo-writing-checklist.md 可读性一栏所标注的per CORE-EEAT O06 Section Chunking standard两份文件在此互相引用、互为依据。6.2 写作中结构与关键词布局第 6 步把清单的布局项压缩为一条结构公式H1主关键词每页唯一 引言100-150 词hook promise 前 100 词内关键词 H2 节次级关键词/问题 H3 子主题 FAQ 节 结论总结 关键词 CTA。第 7 步则重申清单关键项主关键词进入标题/H1/前 100 词/至少一个 H2/结论段落 3-5 句内链 2-5、外链 2-3FAQ 40-60 词对四类 snippet 逐一适配。6.3 写作后十因子评分 问题分级第 9 步的 Final SEO Review 分两段先按 10 个 SEO 因子标题、meta description、H1、关键词布局、H2、内链、外链、FAQ、可读性、字数打出总分满分 10再对 16 项 CORE-EEAT 前置约束逐项给出 pass/warning/fail。发现问题后进入 Issue Classification分成两档处理——自动修正静默修复并在文末追加### Changes Made记录块Meta description 超过 160 字符 → 重写至区间内且保留主关键词与 CTA标题超过 60 字符 → 缩短且保留主关键词图片缺 alt 文本 → 生成描述性 altH2 重复 → 加限定词区分关键词密度高于 2% → 用语义变体替换部分实例缺目录 → 对含 3 个以上 H2 的文章生成带锚点的 TOC段落超过 5 句 → 在自然断点处拆分变更记录使用如下表格格式### Changes Made During Self-Check | Item | Original | Fixed | |------|----------|-------| | Meta description | 185 chars | 158 chars — removed non-essential qualifier | | Keyword density | 2.4% | 1.8% — replaced 3 instances with semantic variants |需人工决策改动前先询问H1 措辞变更可能影响品牌语气、关键词密度低于 0.5%可能需要结构性重写、语气调整正式↔口语、论断强度降级如 best → top-rated 以合规、篇幅偏离目标 ±30%、增删外部链接、无法对照引用来源核实的数据声明。从这种分级设计可以看出技能的边界意识格式类问题机器自改语义与品牌类问题留给人且所有自动修改都必须留痕可审计。7. 两份姊妹参考文档标题公式与内容结构模板检查清单的标题与结构两项检查在技能内部分别由两份参考文档细化承接写作时可一并查阅。7.1 title-formulas.md该文件提供全套标题公式数字列表式[Number] [Adjective] [Topic] [Qualifier]、How-To 四变体含 in Timeframe / Without Objection / Even If Limitation / Like Authority、疑问式、对比式A vs B、Ultimate Guide 式、power words 五大类权威/紧迫/价值/排他/情感、Before/After 式、错误/问题式、清单式、好奇缺口式、利益驱动式、权威背书式。配套的执行参数包括长度指南Google SERP 最优 50-60 字符、约 70 字符开始截断、移动端约 55 字符CTR 增强元素年份/时间框、括号补充说明、数字、power words、目标受众限定CTR 减分元素全大写、过度标点、无实质的 clickbait、泛化标题如 SEO Tips十项标题检查清单自然包含主关键词、50-60 字符、匹配搜索意图、含 power word、具体不模糊、承诺明确价值、如实反映内容、无误导性、与竞品区分度、移动端截断后仍可读重写触发条件前 3 位 CTR 低于 2%、4-10 位 CTR 低于 5%、内容已更新加 [Updated] 标记等。7.2 content-structure-templates.md该文件给出七类内容的完整 Markdown 模板与目标字数博客信息型1200-1800 词、对比文 A vs B1500-2500 词含 Quick Answer 前置结论、榜单文 Top N1500-2500 词含选型标准与 Quick Summary 表、步骤教程1200-2000 词Step 1/2/3 显式编号正好匹配 How-To Snippet 模式、产品评测1500-2000 词含评分与 affiliate 披露、支柱页3000-5000 词TOC 五章结构 Key Takeaways Resources、FAQ 页1000-1500 词按 General/Getting Started/Common Problems/Comparison/Pricing/Advanced 分组并建议配 FAQPage schema。每个模板尾部都附固定的链接与关键词规则如内链 3-5、外链 2-3、主关键词进 H1 与前 100 词文件末尾还有一份通用 Implementation Checklist占位符替换、H1 与前 100 词关键词、TOC、meta 150-160 字符等。8. 快速上手如何调用这套技能SKILL.md 的 Quick Start 给出了可直接使用的提示词范式参数约定为topic target keywordWrite an SEO-optimized article about [topic] targeting the keyword [keyword] Create a blog post for [topic] with these keywords: [keyword list] Write a 2,000-word guide about [topic] targeting [keyword], include FAQ section for featured snippets Heres my content brief: [brief]. Write SEO-optimized content following this outline.数据获取分两种模式若接入了 SEO 工具如 Search Console技能会自动拉取关键词指标搜索量、难度、CPC、竞品内容分析与 SERP 特征若只有手动数据则要求用户提供主关键词 3-5 个次级关键词、目标受众与搜索意图informational/commercial/transactional、目标字数与语气、竞品 URL并在输出中注明哪些指标来自自动采集、哪些来自人工提供。内容就绪后技能约定的下一步交接Next Best Skill是同目录族中的content-quality-auditor见 content-quality-auditor作为发布前的质量门禁产物与摘要按 Skill Contract 存入memory/content/。9. 小结seo-writing-checklist.md 用 20 个勾选项定义了 on-page SEO 的合格线关键词 6 点位、内容质量 5 项、可读性 5 项、技术项 4 项用一套 Markdown 模板固化了H1 → Hook → H2/H3 → FAQ → 结论 CTA的写作骨架用四类模式覆盖了 Definition/List/Table/How-To Snippet 的抓取特征并用一篇完整示例把上述规则演示成可逐条对账的产出物。而 SKILL.md 的九步工作流、CORE-EEAT 16 项前置约束、10 因子评分与自动修正 / 人工决策两级问题处理则把这份清单从静态标准变成了带审计记录的运行时流程。对 SurfSense 这类自带营销站点博客、changelog、文档站如 surfsense_web/blog/content 与 surfsense_web/changelog/content的开源项目而言这套技能清单的意义在于让 AI 批量产出的内容在关键词布局、篇幅结构、snippet 适配和来源标注上具备可复验的最低质量基线。【免费下载链接】SurfSenseOpen-source NotebookLM alternative. Research the open web with live data(Reddit, YT, IG, TikTok, Indeed, Google Search, Maps etc) through one platform, API or MCP server. Join our Discord: https://discord.gg/ejRNvftDp9项目地址: https://gitcode.com/GitHub_Trending/su/SurfSense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考