seo-gap-analysis

name	seo-gap-analysis
description	audit 결과와 3개 최적화 계획의 갭/충돌/우선순위를 종합 분석하는 seo-reviewer 전용 스킬.

SEO Gap Analysis

Target Agent

seo-reviewer

Trigger

• audit, keyword, on-page, technical, link 산출물이 모두 준비되었다
• runtime handoff 전 종합 검증이 필요하다

Inputs

• _workspace/01_seo_audit.md
• _workspace/02_keyword_strategy.md
• _workspace/03_on_page_plan.md
• _workspace/03_technical_seo.md
• _workspace/03_link_strategy.md
• BINDING_MAP.md

Codex Runtime Context

• 이 스킬은 실행 엔진이 아니라 agent 판단 품질을 높이는 extension skill이다.

Purpose

전체 SEO 전략의 갭, 충돌, 누락을 식별하고 실행 우선순위를 판정한다.

Patterns / Checklists

• 01 audit critical ↔ 03 계획 매핑: audit에서 critical로 잡힌 이슈가 03 계획 중 하나 이상에 반영되었는가
• 02 keyword ↔ 03 on-page 매핑: 상위 5개 키워드 클러스터가 on-page 타겟 페이지에 배정되었는가
• 03 on-page ↔ 03 technical 충돌: 같은 페이지에 모순되는 지시가 없는가
• 03 link ↔ 실존 페이지: 링크 전략이 존재하지 않는 페이지를 타겟하지 않는가
• 전략 일관성: 검색 의도별로 audit → keyword → 최적화가 같은 방향을 가리키는가

Rules

• audit critical 미반영은 반드시 must-fix로 분류한다
• 03 계획 간 모순은 must-fix로 분류하고 어느 쪽을 우선할지 판정한다
• 키워드 누락은 심각도에 따라 must-fix 또는 nice-to-have로 분류한다
• 실행 우선순위는 "영향 × 난이도 역수"로 매긴다 (quick win 우선)
• 미결정 사항에 확정 판단을 내릴 때, 적용 대상 문서를 명시한다

Output Format Rules

• 01↔03 매핑은 "audit 이슈 | 반영된 03 계획 | 판정" 테이블
• 02↔03 매핑은 "키워드 클러스터 | 타겟 페이지 | on-page 반영 | 판정" 테이블
• 03 간 충돌은 "페이지 | on-page 지시 | technical 지시 | 판정" 테이블
• must-fix / nice-to-have 를 별도 섹션으로 분리
• 실행 우선순위는 "항목 | 영향 | 난이도 | 우선순위" 테이블
• 문서 끝에 ## Downstream Handoff Note 섹션을 포함한다

Output Guidance

• primary artifact: _workspace/04_review_report.md

Completion Criteria

• audit critical 전체에 대한 반영 여부가 확인됨
• 상위 키워드 클러스터의 on-page 반영 여부가 확인됨
• 03 계획 간 충돌이 0건이거나, 충돌 시 우선순위가 판정됨
• must-fix 와 nice-to-have 가 분리됨
• 실행 우선순위 테이블이 있음

Downstream Handoff

• runtime handoff 전 이 리뷰 결과를 VALIDATION.md에 반영한다
• must-fix 0건이면 handoff-ready, must-fix 잔존 시 review-ready로 판정한다