seo-audit

seo-audit 스킬 개요

seo-audit 스킬이 하는 일

seo-audit 스킬은 에이전트가 바로 뻔한 조언부터 내놓지 않고, 구조화된 SEO 점검을 수행하도록 돕습니다. 이 스킬은 사이트가 유기적 검색에서 왜 성과가 낮은지 진단하고, 무엇부터 확인해야 하는지 정리하며, 발견 사항을 우선순위가 있는 실행 계획으로 바꾸는 데 맞춰져 있습니다.

어떤 사용자가 이 seo-audit 스킬을 설치하면 좋은가

잘 맞는 경우:

• 반복 가능한 SEO 진단 워크플로를 원하는 마케터와 창업자
• SaaS, 콘텐츠 사이트, 기업 사이트를 감사하는 에이전트
• 트래픽 하락, 인덱싱 문제, 낮은 순위, 불명확한 온페이지 이슈를 다루는 팀
• 일회성 프롬프트보다 더 탄탄한 seo-audit guide를 원하는 사용자

덜 적합한 경우:

• 스키마 구현 세부사항만 필요한 사용자
• 프로그래매틱 SEO 페이지 생성 작업을 하는 사용자
• 전통적인 검색 감사보다 AI 검색 최적화에 초점을 둔 사용자

이 스킬이 실제로 해결하는 일

SEO 감사를 요청하는 대부분의 사람은 체크리스트만 원하는 것이 아닙니다. 실제로 알고 싶은 것은 다음입니다:

• 무엇이 순위 상승을 가로막고 있을 가능성이 큰지
• 어떤 증거를 먼저 수집해야 하는지
• 적절한 접근 권한 없이 무엇을 단정하면 안 되는지
• 지금 당장 가장 중요한 문제가 무엇인지

이 스킬이 유용한 이유는 감사 순서를 강제하기 때문입니다. 먼저 크롤링 가능성과 인덱싱을 보고, 그다음 기술적 기반, 온페이지 최적화, 콘텐츠 품질, 권위성과 링크를 점검합니다. 이 순서를 따르면 가치가 낮은 제안이 더 심각한 사이트 상태 문제를 가리는 일을 줄일 수 있습니다.

이 스킬이 일반적인 프롬프트와 다른 점

실무적으로 차이를 만드는 요소는 다음과 같습니다:

• 로컬 컨텍스트 파일이 있으면 먼저 제품 마케팅 맥락을 확인하도록 안내함
• 아무 맥락 없이 감사를 시작하지 않고, 빠진 비즈니스/사이트 정보를 먼저 묻도록 함
• 발견 사항에 명확한 우선순위 체계를 적용함
• 가져온 HTML만으로는 schema markup 존재 여부를 정확히 판별하기 어렵다는 한계를 명시적으로 경고함
• 경영진 요약과 우선순위별 실행 항목이 포함된 보고서 구조를 기대함

이런 디테일이 중요한 이유는, 약한 SEO 감사일수록 자신감 있게 말하면서도 인덱싱 기본기를 건너뛰거나 제한된 접근만으로 확인 가능한 범위를 과장하는 경우가 많기 때문입니다.

seo-audit 스킬 사용 방법

seo-audit 설치 맥락

다음 명령으로 repo에서 설치합니다:

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에서 잘 수행된 결과가 어떤 모습인지 볼 수 있음
• writing reference는 감사 결과를 더 읽기 쉽게, 덜 기계적으로 만드는 데 도움을 주며, 결과를 고객이나 이해관계자와 공유할 계획이라면 특히 중요함

이 스킬에 필요한 입력값

seo-audit usage의 품질은 제공하는 입력에 크게 좌우됩니다. 최소한 다음은 주는 것이 좋습니다:

• 사이트 URL
• 사이트 유형: SaaS, e-commerce, publisher, local business, marketplace 등
• SEO 목표: 리드 증가, 비브랜드 유기적 트래픽 증가, 하락 이후 회복, 핵심 페이지 순위 개선
• 타깃 키워드 또는 토픽 클러스터
• 알려진 이슈: 마이그레이션, 리디자인, CMS 변경, 트래픽 손실, 인덱싱 관련 불만
• 범위: 전체 사이트, 특정 섹션, 템플릿, 단일 페이지
• 접근 수준: 공개 웹만, Search Console 데이터, analytics, crawl exports, competitor URLs

이 정보가 빠져도 스킬은 사용할 수는 있지만, 결과는 눈에 보이는 온페이지 체크와 일반적인 기술 SEO 추정에 더 치우치게 됩니다.

질문하기 전에 로컬 컨텍스트를 먼저 확인하세요

이 seo-audit 스킬에서 가장 유용하지만 놓치기 쉬운 부분 중 하나는, 파일이 존재할 경우 먼저 .agents/product-marketing-context.md 또는 .claude/product-marketing-context.md를 읽으라는 지침입니다. 프로젝트 repo 안에서 이 스킬을 쓴다면, 타깃 오디언스, 포지셔닝, 우선 페이지 같은 기본 정보를 두고 여러 번 주고받는 일을 크게 줄일 수 있습니다.

이 과정이 감사 품질을 높이는 이유는, 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. 크롤링 가능성과 인덱싱
2. 기술적 기반
3. 온페이지 최적화
4. 콘텐츠 품질
5. 권위성과 링크

이 순서는 결과를 바꿉니다. 페이지가 차단되어 있거나, canonical이 잘못 설정되어 있거나, 내부 링크가 부실하다면 meta description을 다시 쓰는 것으로는 핵심 문제가 해결되지 않습니다.

실제 seo-audit 스킬이 점검해야 할 항목

저장소의 신호와 eval 기대치를 보면, 좋은 seo-audit usage에는 다음과 같은 점검이 포함되어야 합니다:

• robots.txt
• XML sitemap 존재 여부와 품질
• 인덱싱 및 크롤링 신호
• 사이트 구조와 내부 링크 로직
• title tags와 meta descriptions
• heading 구조
• 콘텐츠 관련성 및 최적화 상태
• 발견 가능성이나 성능에 영향을 줄 수 있는 기술적 이슈

그리고 결과는 관찰 사항을 평평하게 나열하는 데서 끝나지 않고, 의사결정에 바로 쓸 수 있는 보고서 형태로 정리되어야 합니다.

스키마 감지 한계를 반드시 존중하세요

이건 사소한 주석이 아니라 실제 도입 시 중요한 포인트입니다. 이 스킬은 기본적인 페이지 fetch 결과만 보고 "schema markup이 없다"고 단정하지 말라고 명시적으로 경고합니다. 많은 사이트가 클라이언트 사이드에서 schema를 주입하거나, 단순 fetch로는 잡히지 않는 방식으로 구현하기 때문입니다.

좋은 출력은 다음처럼 말해야 합니다:

• "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은 이 스킬을 계속 신뢰하고 쓸지 판단할 때 가장 유용한 파일 중 하나입니다. 여기에는 기대되는 동작이 드러납니다:

• 맥락이 부족하면 명확화 질문을 함
• 콘텐츠 다듬기보다 크롤링 가능성을 먼저 우선시함
• robots와 sitemap의 기본 항목을 점검함
• 근거 없는 schema 단정을 피함
• 결과를 사용 가능한 구조로 제시함

에이전트가 이런 식으로 동작하지 않는다면, 사실상 이 스킬을 제대로 따르고 있다고 보기 어렵습니다.

seo-audit 스킬 FAQ

이 seo-audit 스킬은 초보자에게도 좋은가

네. 특히 합리적인 감사 순서가 필요한 초보자에게 유용합니다. 무작위로 SEO를 점검하는 일을 막아 주고, 더 명확한 출발 틀을 제공합니다. 다만 초보자라도 비즈니스 맥락은 직접 제공해야 합니다. 어떤 페이지와 어떤 쿼리가 중요한지 아는 일을 이 스킬이 대신해 주지는 않습니다.

그냥 AI에게 직접 SEO 감사를 요청하는 것과 무엇이 다른가

일반 프롬프트도 그럴듯한 SEO 팁 목록을 만들 수는 있습니다. 하지만 이 스킬은 다음이 필요할 때 더 낫습니다:

• 정해진 감사 순서
• 더 나은 범위 설정 질문
• 근거 없는 단정 감소
• 더 활용하기 쉬운 최종 보고서

실질적인 가장 큰 장점은 "기능이 더 많다"가 아닙니다. 추측이 줄고 우선순위 판단이 더 좋아진다는 점입니다.

seo-audit를 SEO Content 작업에 써도 되는가

네, 다만 기대치는 정확히 잡아야 합니다. 이 스킬은 온페이지 최적화, 콘텐츠 품질, 관련성 문제 가능성을 검토함으로써 seo-audit for SEO Content를 지원합니다. 하지만 본질적으로 콘텐츠 브리프 생성기가 아닙니다. 무엇을 새로 만들지 결정하기 전에, 기존 페이지가 검색 의도, 메타데이터, headings, 사이트 구조와 얼마나 잘 맞는지 진단하는 용도로 쓰는 편이 좋습니다.

Search Console이나 analytics 접근이 꼭 필요한가

아니요. 공개 사이트 점검만으로도 사용할 수 있습니다. 다만 품질의 상한은 더 낮습니다. Search Console, analytics, crawl exports가 없으면 이 스킬은 가능성 높은 문제를 식별할 수는 있어도, 모든 성과나 인덱싱 관련 주장을 완전히 검증할 수는 없습니다.

언제 이 스킬을 쓰지 말아야 하나

주된 필요가 다음이라면 이 스킬은 건너뛰는 편이 낫습니다:

• schema markup 추가 또는 디버깅만 필요한 경우
• 키워드 커버리지를 위한 대규모 페이지 생성
• 전통적인 SEO 진단보다 AI 검색 가시성 전략이 필요한 경우

또한 근본 원인을 이해하기 전에 즉시 수정 구현부터 원할 때도 잘 맞지 않습니다.

writing reference가 정말 관련이 있나

네. 감사 결과가 고객용이거나 내부 배포용이라면 분명 관련이 있습니다. references/ai-writing-detection.md는 SEO 프레임워크 파일은 아니지만, 전달 품질을 높여 줍니다. 더 깔끔하고 덜 기계적으로 보이는 권고안일수록 팀이 신뢰하고 채택하기 쉽습니다.

seo-audit 스킬을 더 잘 활용하는 방법

스킬에 더 나은 비즈니스 맥락을 제공하세요

seo-audit skill을 개선하는 가장 빠른 방법은 이것을 범용 스캐너처럼 다루지 않는 것입니다. 다음을 알려 주세요:

• 타깃 오디언스가 누구인지
• 어떤 페이지가 가장 중요한지
• 어떤 전환 이벤트가 중요한지
• 최근 무엇이 바뀌었는지
• 어떤 쿼리를 중요하게 보는지

이 정보가 있으면 감사는 단순한 "SEO 관찰"에서 "SEO 의사결정"으로 바뀝니다.

사이트가 크다면 범위를 좁히세요

대형 사이트라면 막연한 전체 감사 대신 아래 중 하나를 요청하세요:

• 홈페이지 + 상위 매출 페이지 5개
• 특정 디렉터리 또는 블로그 섹션 하나
• 템플릿 유형 하나
• 트래픽 하락 클러스터 하나

범위가 작을수록 발견 사항은 더 날카로워지고, 권고안도 더 실행 가능해집니다.

증거와 불확실성 라벨을 함께 요구하세요

공허한 출력물을 피하려면 다음 형식을 요청하세요:

• 관찰된 이슈
• 왜 중요한지
• 신뢰도 수준
• 권장 수정안
• 기대 효과
• 추가 검증이 필요한 부분

특히 공개 점검만으로는 불완전할 수 있는 기술 이슈나 인덱싱 주장에 매우 유용합니다.

피상적인 권고를 막으세요

흔한 실패 패턴은 첫 결과가 titles, keywords, 그리고 뻔한 "콘텐츠 품질 개선" 조언에 과도하게 집중하는 것입니다.

이럴 때는 다음을 프롬프트에 넣어 바로잡으세요:

• crawl 및 index 차단 요소를 먼저 볼 것
• 한 페이지 단위의 잔지적보다 page template 패턴을 볼 것
• 우선순위 페이지로 향하는 internal linking 경로를 볼 것
• 비즈니스 의도와 실제 랭킹 페이지 유형 사이의 불일치를 볼 것

이렇게 해야 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를 실제 실행 계획으로 바꾸는 가장 좋은 방법입니다.

제한된 접근에서 과장하지 않도록 주의하세요

에이전트가 크롤링을 못 하거나, JavaScript 렌더링을 못 하거나, 플랫폼 설정을 확인할 수 없다면, 전체 가시성을 가진 것처럼 말하게 두면 안 됩니다. 이 스킬은 이미 그 방향을 잘 짚어 줍니다. 그 신중함을 유지하세요. 신뢰를 높이고 false positive를 줄이는 데 도움이 됩니다.

출력을 1차 분류 레이어로 활용하세요

이 seo-audit guide는 전문 작업에 들어가기 전의 1차 진단 레이어로 쓸 때 가장 효과적입니다. 다음 용도로 활용하세요:

• 가능성 높은 장애 요인 식별
• 조사 경로 우선순위화
• 이해관계자용 요약 준비
• 더 깊은 technical SEO, 콘텐츠 작업, 구현 지원이 필요한지 판단

이 역할은, 이 스킬 하나만으로 완전한 SEO 툴링이나 실제 사이트 접근을 대체하길 기대하는 것보다 훨씬 현실적이고 강력합니다.