seo-site-health-audit
정보
이 스킬은 Ahrefs와 같은 크롤러에서 발견된 기술적 SEO 문제를 단순한 심각도 레이블이 아닌 실제 순위와 트래픽에 미치는 영향에 따라 우선순위를 정합니다. 개발자가 감사 결과를 검토하거나 SEO 스프린트 범위를 정할 때, 우선순위가 지정된 수정 백로그를 만들 수 있도록 돕습니다. 긴 크롤 오류 목록으로 인한 결정 마비를 극복하고, 영향력이 높은 작업에 집중하는 데 활용하세요.
빠른 설치
Claude Code
추천npx skills add rampstackco/claude-skills -a claude-code/plugin add https://github.com/rampstackco/claude-skillsgit clone https://github.com/rampstackco/claude-skills.git ~/.claude/skills/seo-site-health-auditClaude 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:
| Mechanism | Examples |
|---|---|
| Indexability | Accidental noindex, robots.txt blocks, canonical errors, X-Robots-Tag |
| Crawlability | Crawl traps, infinite redirects, 5xx errors, slow server response |
| Renderability | JS errors blocking critical content, blocked resources |
| Core Web Vitals | LCP, INP, CLS in the poor band |
| Structured data | Errors on rich-result-eligible pages (not warnings) |
| Internal link integrity | 404s on internally linked URLs, broken canonicals |
| Hreflang | Errors on multilingual deployments |
Categories of low or theoretical impact:
| Type | Why it is lower priority |
|---|---|
| Title tag length warnings | Not a ranking factor in itself |
| Meta description length | Not a ranking factor |
| H1 absence on low-traffic pages | Marginal impact |
| Alt text missing on decorative images | Accessibility 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.
| Tier | Mechanism | Effort | Priority |
|---|---|---|---|
| Tier 1 | High mechanism | S | P0 (do this week) |
| Tier 1 | High mechanism | M | P1 (do this sprint) |
| Tier 1 | High mechanism | L | P2 (plan as project) |
| Tier 1 | Low mechanism | S | P3 (batch when convenient) |
| Tier 1 | Low mechanism | M-L | Park unless evidence emerges |
| Tier 2 | High mechanism | S | P1 |
| Tier 2 | High mechanism | M-L | P2 |
| Tier 3 | High mechanism | S | P3 |
| Tier 3 | Anything else | Anything | Park |
P0-P1 work earns the team's attention. P2 goes on the roadmap. P3 batches into routine maintenance. Park is honest about deprioritization.
Workflow
- Pull the crawl results. Ahrefs Site Audit + Search Console + Core Web Vitals.
- Tier the URLs. Use organic traffic data. Tag every affected URL as Tier 1, 2, or 3.
- Categorize each issue by mechanism. High or low impact mechanism.
- Estimate effort per fix type. Group similar fixes into one effort estimate.
- Apply the triage matrix. Assign P0-P3 or Park.
- Cluster the fixes. Group fixes that share an effort: one template change can resolve hundreds of issues.
- Build the backlog. P0 first, P1 next, etc. Add fix descriptions, owners, expected impact.
- Add measurement. What metric will confirm the fix worked? Define before shipping.
- Hand off. Output feeds the development backlog and
seo-audit-orchestration. - 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:
- Summary. Total issues, top 3 fix clusters, expected impact.
- URL tiering. How URLs were classified and counts per tier.
- Issue categorization. Counts by mechanism category, by tier, by priority band.
- Prioritized backlog. P0-P3 ordered. Each item has: issue, affected URLs, fix description, effort, expected impact, owner.
- Fix clusters. Groups of issues that share a fix. Highest leverage at the top.
- Measurement plan. Per fix or cluster, what proves it worked.
- 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 저장소
연관 스킬
seo-keyword-gap-audit
기타이 스킬은 Ahrefs MCP를 통해 경쟁사 SEO 데이터를 분석하여 대상 웹사이트가 순위를 차지하지 못한 키워드를 식별하고 우선순위를 정합니다. 신규 시장 진입이나 점유율 하락 시 콘텐츠 기획, 빠른 성과 확보, 경쟁 분석을 위해 설계되었습니다. 결과는 신규 또는 개선된 콘텐츠를 위한 우선순위가 지정되고 군집화된 키워드 기회 목록입니다.
seo-traffic-diagnosis
기타이 스킬은 Ahrefs와 Search Console 데이터를 활용해 유기적 트래픽 변화를 진단하며, 5단계 근본 원인 분석을 수행합니다. 갑작스러운 트래픽 감소, 알고리즘 업데이트, 또는 사이트 마이그레이션 후 손실과 같은 문제가 발생하면 자동으로 실행되어 원인을 규명합니다. 결과물은 명확한 진단과 실행 가능한 계획을 제공하여 개발자가 SEO 성능 문제를 해결할 수 있도록 지원합니다.
seo-rank-tracking
기타이 스킬은 개발자가 Ahrefs MCP를 사용해 SEO 순위 추적을 설정하고 관리하는 데 도움을 줍니다. 키워드 선정, 분류, 기준 설정, 알림 임계값 구성까지 안내합니다. 새로운 추적 프로젝트를 시작하거나 이해관계자를 위한 보고 주기를 수립할 때 사용하세요.
seo-content-gap-audit
기타이 스킬은 Ahrefs 데이터를 분석하여 콘텐츠 격차, 오래된 페이지, 성능 저하를 식별합니다. 페이지 생성, 업데이트, 병합과 같은 조치를 권장함으로써 개발자가 콘텐츠 로드맵을 구축하는 데 도움을 줍니다. 콘텐츠 전략 수립, 부진한 카탈로그 개선, 정체된 유기적 트래픽 진단 시 활용하세요.
