返回技能列表

seo-site-health-audit

rampstackco
更新于 2 days ago
3 次查看
239
27
239
在 GitHub 上查看
其他ai

关于

This skill prioritizes technical SEO issues from crawlers like Ahrefs by their actual impact on rankings and traffic, not just by severity labels. It helps developers create a prioritized fix backlog when reviewing audit results or scoping SEO sprints. Use it to cut through decision paralysis from long lists of crawl errors and focus on high-impact actions.

快速安装

Claude Code

推荐
主要方式
npx skills add rampstackco/claude-skills -a claude-code
插件命令备选方式
/plugin add https://github.com/rampstackco/claude-skills
Git 克隆备选方式
git clone https://github.com/rampstackco/claude-skills.git ~/.claude/skills/seo-site-health-audit

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

SEO Site Health Audit

Triage technical SEO findings from Ahrefs Site Audit (or any equivalent crawler) by impact on rankings and traffic, not by raw issue count or severity label. Stack-agnostic. Produces a prioritized backlog of fixes mapped to business impact.


When to use

  • After running an Ahrefs Site Audit or other site-wide crawl
  • Reviewing a long list of technical issues and needing to prioritize
  • Scoping a technical SEO sprint
  • Pre-launch or post-migration technical verification
  • Quarterly technical health check
  • When developer time is limited and you must pick the highest-leverage fixes

When NOT to use

  • Running the crawl itself (use the crawler tool directly)
  • Diagnosing specific traffic drops (use seo-traffic-diagnosis)
  • Single-page audits (use seo-onpage)
  • Pure technical strategy or schema design (use seo-technical)

Required inputs

  • Crawl results from Ahrefs Site Audit (or equivalent)
  • Search Console coverage and Core Web Vitals data
  • Property's organic traffic profile (which pages drive traffic)
  • Stakeholder time and developer capacity available
  • Confirmation Ahrefs MCP is connected

The framework: triage by SEO impact, not severity

Crawlers label issues "critical", "warning", "notice". These labels are useful but not sufficient. Two issues both labeled "critical" can have wildly different actual impact on the property.

Triage on three axes.

Axis 1: Page-level traffic impact

Does the issue affect a page that drives meaningful organic traffic, or one that does not?

A "critical" issue on a tag archive with zero traffic is lower priority than a "warning" on a top-10-traffic landing page.

Tier the affected URLs:

  • Tier 1: Top 10% of pages by organic traffic
  • Tier 2: Pages that rank but do not yet drive significant traffic (page 2-3 results)
  • Tier 3: Pages that exist but do not rank meaningfully

A fix on Tier 1 is worth 10x a fix on Tier 3 in most cases.

Axis 2: Mechanism of impact

Does the issue actually move rankings or traffic? Some "critical" issues are aesthetic or theoretical.

Categories of real impact:

MechanismExamples
IndexabilityAccidental noindex, robots.txt blocks, canonical errors, X-Robots-Tag
CrawlabilityCrawl traps, infinite redirects, 5xx errors, slow server response
RenderabilityJS errors blocking critical content, blocked resources
Core Web VitalsLCP, INP, CLS in the poor band
Structured dataErrors on rich-result-eligible pages (not warnings)
Internal link integrity404s on internally linked URLs, broken canonicals
HreflangErrors on multilingual deployments

Categories of low or theoretical impact:

TypeWhy it is lower priority
Title tag length warningsNot a ranking factor in itself
Meta description lengthNot a ranking factor
H1 absence on low-traffic pagesMarginal impact
Alt text missing on decorative imagesAccessibility issue, low SEO impact
Schema warnings (not errors)Often best-practice nudges, not ranking issues

Fix the high-mechanism categories first.

Axis 3: Effort

Some issues are 5-minute fixes. Some are multi-sprint projects.

  • S (small): Configuration change, single template edit, sitemap regeneration
  • M (medium): Theme or component change, redirect map work, template-level fixes
  • L (large): Architecture change, re-platform, framework migration, schema overhaul

The triage matrix

Combine the three axes into a priority score.

TierMechanismEffortPriority
Tier 1High mechanismSP0 (do this week)
Tier 1High mechanismMP1 (do this sprint)
Tier 1High mechanismLP2 (plan as project)
Tier 1Low mechanismSP3 (batch when convenient)
Tier 1Low mechanismM-LPark unless evidence emerges
Tier 2High mechanismSP1
Tier 2High mechanismM-LP2
Tier 3High mechanismSP3
Tier 3Anything elseAnythingPark

P0-P1 work earns the team's attention. P2 goes on the roadmap. P3 batches into routine maintenance. Park is honest about deprioritization.


Workflow

  1. Pull the crawl results. Ahrefs Site Audit + Search Console + Core Web Vitals.
  2. Tier the URLs. Use organic traffic data. Tag every affected URL as Tier 1, 2, or 3.
  3. Categorize each issue by mechanism. High or low impact mechanism.
  4. Estimate effort per fix type. Group similar fixes into one effort estimate.
  5. Apply the triage matrix. Assign P0-P3 or Park.
  6. Cluster the fixes. Group fixes that share an effort: one template change can resolve hundreds of issues.
  7. Build the backlog. P0 first, P1 next, etc. Add fix descriptions, owners, expected impact.
  8. Add measurement. What metric will confirm the fix worked? Define before shipping.
  9. Hand off. Output feeds the development backlog and seo-audit-orchestration.
  10. Re-crawl after fixes. Confirm resolution. Update the backlog.

High-leverage clusters worth looking for

These patterns commonly produce outsized impact when fixed:

  • Wholesale redirect chain cleanup. One sitemap update plus internal link updates can resolve thousands of "redirect chain" issues at once.
  • Accidental noindex on a template. A single line of code change can re-index hundreds or thousands of pages.
  • Sitemap freshness pipeline. A broken sitemap regeneration job affects every issue that depends on Search Console seeing the right URLs.
  • Canonical inconsistencies on faceted navigation. A template-level canonical fix can resolve duplicate content issues across an entire ecommerce category tree.
  • Robots.txt restored. A reverted production robots.txt can recover a sitewide drop in days.
  • Hreflang block fix. One template change resolves hreflang issues across the whole multilingual site.
  • Image optimization at the asset pipeline. Fixing the build process resolves thousands of individual asset issues.

When you spot one of these, prioritize even if individual issues look small. The cluster impact is large.


Failure patterns

  • Severity worship. Treating every "critical" label as truly critical. Many are not. Triage by mechanism and traffic impact.
  • Counting issues. Reporting "we fixed 1,200 issues" without showing traffic or ranking impact wastes engineering credibility.
  • Skipping the tiering. Fixing 100 Tier-3 issues before 5 Tier-1 issues is busy work.
  • Single-issue fixes. Most issues come in clusters. Fixing one redirect chain when 800 share the same root cause is the wrong unit of work.
  • No re-crawl. "Fixed" without verification leaves doubt. Always re-crawl after major fixes.
  • Ignoring Search Console. Ahrefs sees what its crawler finds. Search Console reflects what Google actually sees and indexes. Use both.
  • Treating Core Web Vitals like a checklist. CWV is field data, not lab data. Optimize for real-user experience, not synthetic scores.
  • Fixing low-mechanism issues for show. A clean technical report with no traffic gain helps no one.
  • Not measuring. Define the metric that proves the fix worked before fixing.

Output format

A site health triage document with:

  1. Summary. Total issues, top 3 fix clusters, expected impact.
  2. URL tiering. How URLs were classified and counts per tier.
  3. Issue categorization. Counts by mechanism category, by tier, by priority band.
  4. Prioritized backlog. P0-P3 ordered. Each item has: issue, affected URLs, fix description, effort, expected impact, owner.
  5. Fix clusters. Groups of issues that share a fix. Highest leverage at the top.
  6. Measurement plan. Per fix or cluster, what proves it worked.
  7. Methodology. Crawler used, date, scope, caveats.

Length: 5-12 pages plus a backlog spreadsheet.


Reference files

  • references/issue-impact-table.md - Mapping table of common crawler issues to mechanism impact and typical fix effort, plus the triage matrix in detailed form.

GitHub 仓库

rampstackco/claude-skills
路径: skills/seo-site-health-audit
0
agent-skillsai-agentsanthropicclaudeclaude-aiclaude-code

相关推荐技能

seo-keyword-gap-audit

其他

这个Skill通过Ahrefs MCP数据对比目标网站与竞争对手的关键词排名差距,识别出竞争对手排名靠前而目标网站未覆盖的关键词机会。它能按机会度对关键词进行优先级排序和聚类,帮助开发者制定内容策略、寻找快速提升机会或规划新市场进入。适用于内容投资规划、竞争分析、内容日历制定以及应对市场份额流失等SEO场景。

查看技能

seo-traffic-diagnosis

其他

这个SEO流量诊断技能帮助开发者快速诊断有机流量变化(下降、停滞或意外增长),结合Ahrefs和Search Console数据进行五层根因分析。它特别适用于算法更新后、网站迁移后或竞争对手抢占份额时的流量异常情况。该技能能生成根本原因诊断和具体行动计划,有效应对利益相关者对流量波动的担忧。

查看技能

seo-rank-tracking

其他

该Skill帮助开发者使用Ahrefs MCP设置和执行SEO排名跟踪。它适用于启动新跟踪项目、建立活动基线或构建定期报告节奏的场景。关键功能包括关键词选择与分类、基线设定、警报阈值配置以及仪表板可视化。

查看技能

seo-content-gap-audit

其他

该Skill利用Ahrefs数据诊断内容差距与衰退,识别缺失主题、覆盖薄弱、内容过时及流量衰减页面。它适用于规划内容路线图、更新陈旧目录或建立主题权威等场景,能生成具体的创建、更新、合并或删除建议。当有机流量停滞或需要对比竞争对手内容优势时,可触发此工具进行分析。

查看技能