seo-audit

seo-audit 技能概览

seo-audit 技能能做什么

seo-audit 技能的价值，在于帮助代理按结构化流程完成 SEO 审核，而不是一上来就给出一堆泛泛建议。它适合用来诊断网站为什么在自然搜索中表现不佳、应该优先检查哪些环节，以及如何把发现的问题整理成有优先级的行动计划。

谁适合安装这个 seo-audit 技能

最适合的人群：

• 希望建立可复用 SEO 诊断流程的市场人员和创业者
• 为 SaaS、内容型网站或企业官网做审计的代理
• 正在处理流量下滑、收录异常、排名疲软，或页面内优化问题不清晰的团队
• 想要比一次性提示词更扎实的 seo-audit guide 的用户

不太适合的场景：

• 只想看 schema 实现细节的用户
• 做 programmatic SEO 页面生成的用户
• 关注 AI 搜索优化，而不是传统搜索审计的用户

这个技能真正解决的问题

大多数人在要求做 SEO audit 时，真正想要的并不只是一个清单，而是想弄清楚：

• 到底是什么最可能卡住了排名
• 应该先收集哪些证据
• 在没有充分访问权限的前提下，哪些结论不能轻易下
• 当前最值得优先处理的是哪些问题

这个技能的实用之处在于，它强制采用明确的审核顺序：先看 crawlability 和 indexation，再看技术基础、页面内优化、内容质量，最后才看权威性或外链。这样的顺序可以避免低价值建议挤占更严重的网站健康问题。

这个技能与通用提示词有什么不同

它的实际区别主要体现在：

• 如果存在本地上下文文件，它会先要求检查产品营销背景
• 在盲目开始审计前，它会先补齐缺失的业务和网站上下文
• 它对问题发现有明确的优先级顺序
• 它会明确提醒：如果仅依赖抓取到的 HTML，schema markup 的检测存在局限
• 它预期输出的报告结构里，包含 executive summary 和按优先级排列的行动项

这些细节很重要，因为很多质量不高的 SEO 审计看起来很自信，却会跳过最基础的收录问题，或者在访问权限有限时夸大可验证范围。

如何使用 seo-audit 技能

seo-audit 安装方式与上下文

通过下面的命令从仓库安装：

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

这会从 coreyhaines31/marketingskills 仓库中的 skills/seo-audit 添加该技能。技能目录内部没有单独的安装器，所以实际的 seo-audit install 步骤就是上面的标准 Skills 命令。

首次使用前先读这些文件

如果你想快速理解仓库里最有信号的内容，建议按这个顺序打开：

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

为什么按这个顺序读：

• SKILL.md 说明了审计工作流和适用范围
• evals/evals.json 能直接看出什么才算高质量执行
• 这个写作参考文件有助于让审计输出更易读、少一点机器感；如果你要把结果发给客户或内部干系人，这一点很重要

这个技能需要哪些输入

seo-audit usage 的质量，很大程度取决于你给了什么输入。至少建议提供：

• 网站 URL
• 网站类型：SaaS、e-commerce、publisher、本地商家、marketplace 等
• SEO 目标：更多线索、更多非品牌自然流量、下滑后恢复、重点页面排名提升
• 目标关键词或主题集群
• 已知问题：迁移、改版、CMS 变更、流量下滑、收录投诉
• 审计范围：全站、某个栏目、某种模板，或单个页面
• 访问权限级别：仅公开网页、Search Console 数据、analytics、crawl 导出、竞品 URL

如果这些信息缺失，技能依然能用，但输出会更偏向可见的页面内检查和较宽泛的技术启发式判断。

提问前先检查本地上下文

这个 seo-audit 技能里一个非常实用、但也很容易被忽略的点，是它会要求优先读取 .agents/product-marketing-context.md 或 .claude/product-marketing-context.md（如果存在）。如果你是在项目仓库里使用这个技能，这一步往往能省掉很多关于受众、定位和优先页面的基础来回确认。

这会直接提升审计质量，因为 SEO 建议只有和真实产品、转化漏斗、目标市场绑在一起，才更有意义。

把模糊需求改写成高质量审计提示

弱输入：

• "Do an SEO audit of our site"

更强的输入：

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

为什么这种写法更有效：

• 它补充了业务背景
• 它定义了成功标准
• 它收窄了审计范围
• 它鼓励基于证据表达不确定性，而不是假装什么都能确认

按预期的审计顺序来用

一个常见误区，是一开始就改文案。这个技能只有按它设计的顺序使用，价值才更高：

1. Crawlability 和 indexation
2. 技术基础
3. 页面内优化
4. 内容质量
5. 权威性与外链

这个顺序会直接影响结果。如果页面被阻挡抓取、canonical 配错，或者内链结构很差，那重写 meta description 并不能解决核心问题。

实际使用中，这个技能应检查什么

从仓库信号和 eval 预期来看，高质量的 seo-audit usage 通常应包含这些检查项：

• robots.txt
• XML sitemap 是否存在，以及质量如何
• 收录和抓取信号
• 网站架构与内部链接逻辑
• title tags 和 meta descriptions
• heading 结构
• 内容相关性与优化情况
• 可能影响可发现性或性能的技术问题

之后，它应把这些发现整理成可用于决策的报告，而不是平铺直叙地罗列观察结果。

正视 schema 检测的限制

这不是小提醒，而是实际采用时非常关键的一点。该技能明确警告：不要仅凭基础页面抓取结果，就下结论说“没有发现 schema markup”。很多网站会通过客户端注入 schema，或者以简单抓取看不到的方式输出。

好的输出应该类似这样表述：

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

这也是 seo-audit skill 比那些过度自信的审计更可信的原因之一。

按预期的报告结构输出

为了方便实际交付，建议让技能输出以下结构：

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

这很重要，因为干系人通常不会根据原始笔记直接行动；他们会根据带有排序、理由、影响和下一步建议的问题列表来做决策。

用 evals 判断输出质量

skills/seo-audit/evals/evals.json 是判断这个技能值不值得继续用、能不能信任的最佳文件之一。它展示了预期行为：

• 当上下文不足时先追问澄清
• 优先处理 crawlability，而不是先润色内容
• 检查 robots 和 sitemap 的基础项
• 避免对 schema 做无依据判断
• 用可实际使用的结构呈现结果

如果你的代理没有做到这些，那基本说明它并没有真正按照这个技能在执行。

seo-audit 技能常见问题

这个 seo-audit 技能适合新手吗

适合，尤其适合需要一个合理审计顺序的新手。它可以避免东一榔头西一棒子的 SEO 检查，让人更快建立清晰的起步框架。不过，新手仍然需要提供业务背景，因为这个技能不能替代你判断哪些页面和查询真正重要。

它和直接让 AI 做 SEO audit 有什么区别

普通提示词也许能产出一份看起来像样的 SEO 建议列表。这个技能更适合你在意以下几点的时候：

• 有明确的审计顺序
• 有更好的范围界定问题
• 更少无依据结论
• 最终报告更容易直接使用

它最大的实际优势并不是“功能更多”，而是猜测更少、优先级更清楚。

我可以把 seo-audit 用在 SEO Content 工作上吗

可以，但要带着正确预期来用。这个技能支持 seo-audit for SEO Content，因为它会检查页面内优化、内容质量，以及可能存在的相关性问题。但它并不是以生成 content brief 为核心。更适合用它先判断现有页面是否与搜索意图、metadata、heading 和网站结构匹配，再决定要重写哪些内容、或者新增哪些页面。

它必须依赖 Search Console 或 analytics 吗

不需要。只做公开网站检查也能使用。但质量上限会更低。没有 Search Console、analytics 或 crawl 导出时，这个技能更适合识别“高概率问题”，而不是完整验证每一个性能或收录相关判断。

哪些情况下不该用这个技能

如果你的主要需求是以下任一项，就不建议用这个技能：

• 只做 schema markup 的添加或排错
• 为关键词覆盖做大规模页面生成
• 做 AI 搜索可见性策略，而不是传统 SEO 诊断

另外，如果用户想在还没理解底层问题之前，就立刻开始执行修复，这个技能也不算理想选择。

那个写作参考文件真的有用吗

有，尤其当审计输出要给客户看，或者要在团队内部流转时。references/ai-writing-detection.md 虽然不是 SEO 方法论文件，但确实能提升交付质量。表达更自然、机器感更弱的建议，更容易被团队信任和采纳。

如何改进 seo-audit 技能的使用效果

给 seo-audit 技能更完整的业务上下文

想提升 seo-audit skill 的效果，最快的方法就是别把它当成通用扫描器。请明确告诉它：

• 目标受众是谁
• 哪些页面最重要
• 哪个转化事件最关键
• 最近发生了什么变化
• 你最关心哪些查询词

这样，审计产出才会从“SEO 观察”升级成“SEO 决策”。

网站很大时，先缩小审计范围

面对大站，不要一上来就要求做一个模糊的全站审计。更好的做法是只选下面一种范围：

• 首页加前 5 个营收页面
• 某个目录或博客栏目
• 某一种模板类型
• 某个流量下滑集群

范围更小，结论往往更尖锐，建议也更容易落地。

要求输出证据和不确定性标记

如果你想避免空泛输出，可以明确要求它给出：

• 观察到的问题
• 为什么重要
• 置信度
• 推荐修复方式
• 预期影响
• 哪些部分还需要进一步验证

这一点对于技术问题和收录问题尤其重要，因为仅靠公开检查，很多结论本来就无法完全确认。

防止建议流于表面

常见失败模式是：第一版输出过度聚焦于标题、关键词，以及泛泛的“提升内容质量”。

你可以这样纠偏，在提示里明确要求：

• 先找 crawl 和 index 阻塞项
• 看页面模板模式，而不是只挑单页细节
• 分析通往优先页面的内链路径
• 判断业务意图与当前排名页面类型是否错位

这样才能让 seo-audit 聚焦在高杠杆问题上，而不是停留在表面修饰。

提供强页和弱页的对比样本

如果你已经知道哪些页面表现好、哪些页面表现差，最好把两类页面都给它。这样技能就能做对比分析，例如：

• title 格式
• heading 深度
• 内容结构
• 内部链接
• 意图匹配度
• 转化对齐程度

相比让它冷启动审整个域名，这类对比输入通常更容易产出高质量建议。

在第一次审计后继续迭代

第一轮输出通常更适合产出一份带优先级的问题列表，而不是最终路线图。好的后续提示包括：

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

这是把 seo-audit usage 真正转成执行计划的最佳方式。

警惕在访问受限时过度下结论

如果代理无法完成 crawl、无法渲染 JavaScript，也看不到平台设置，就不要让它表现得像自己掌握了完整可见性。这个技能本身已经在这方面给了正确提醒。请保留这种谨慎，它能提升信任度，也能减少误报。

把输出当成分诊层来用

这个 seo-audit guide 最适合扮演“第一轮诊断分诊层”的角色，而不是替代专家工作。你可以用它来：

• 找出最可能的阻塞点
• 给调查路径排优先级
• 准备给干系人的总结
• 判断接下来更需要深度 technical SEO、内容优化，还是实施支持

相比期待它单独替代完整 SEO 工具链或真实站点访问权限，这样的定位更合理，也更有效。