클로드 코드(Claude Code) 스킬로 사례글 SEO 잡기: 사내 글 222편 중 검색에 걸린 25편의 공통점

클로드 코드(Claude Code) 스킬 하나로 사내 사례글을 검색과 AI 답변에 걸리게 만드는 방법을 2026년 9월 18일에 하루 걸려 정리했어요. 재료는 최근 6개월 사내 사례글 222편이고, 그중 구글 클릭 100 이상은 25편이었어요. 그 25편의 공통점을 스킬에 넣었더니 직원이 답할 질문이 8개에서 5개로 줄었고, 검색어는 사람이 아니라 스킬이 찾게 됐어요.

사내 글 222편을 노출 순으로 세워 봤어요

지피터스는 사내 AX(AI 전환) 활동으로 직원마다 매주 한 편씩 AI 활용 사례글을 올려요. 저도 매주 쓰고요. 근데 형식이 사람마다 다 다르고, 검색에 걸리는 글과 안 걸리는 글의 차이를 아무도 재본 적이 없었어요.

그래서 제가 사내 사례글 태그가 붙은 222편을 전부 뽑아서 구글 서치 콘솔 노출·클릭과 챗GPT·제미나이·클로드·퍼플렉시티 경유 유입을 붙여 봤어요. 저는 지피터스의 1인 마케터이자 1인 에디터인 강지인이에요. 혼자 발행하는 글이 많다 보니 어떤 글이 검색과 AI 답변에 걸리는지를 계속 연구하고 있고, 마케팅을 AI 네이티브로 다시 짜는 것도 제 일이에요. 숫자는 전부 2026년 9월 18일에 제 서치 콘솔과 믹스패널 계정에서 직접 뽑은 거예요.

발행 5주가 지난 165편만 놓고 보면 이랬어요.

  • 클릭 100 이상: 21편. 노출 중앙값 3,444
  • 클릭 10에서 99: 36편. 노출 중앙값 652
  • 클릭 2 이하: 59편. 노출 중앙값 61

거의 절반이 클릭 2 이하였어요. 열심히 쓴 글이 사내 사람 말고는 아무도 안 본 거죠.

차이는 본문이 아니라 제목이었어요

처음엔 본문 구조 차이일 거라고 생각했어요. 숫자를 얼마나 넣었는지, 1인칭을 얼마나 썼는지, 글이 얼마나 긴지를 세 그룹으로 비교했는데, 거의 같았어요. 1천 자당 수치 표현이 상위 3.3개, 하위 3.0개예요.

크게 갈린 건 딱 하나였어요. 제목에 한글과 영문 도구명이 있는 비율이 상위 76%, 하위 42%였어요. 상위 글에 실제로 들어온 검색어를 보면 이유가 보여요. "클로드 카드뉴스", "힉스필드 요금제", "omc", "인스타툰 ai", "hermes agent 후기"예요. 제목에 그 단어가 그대로 있어요.

하위 글 제목은 "훔쳐보기", "기억이 사는 집", "3단 배선", "깨달은 것 1부" 같은 것들이었어요. 사내에서 읽으면 재밌는데, 아무도 검색창에 치지 않는 말이죠.

제목에 도구명이 있는 글의 비율, 클릭 2 이하 글 중 42%, 클릭 100 이상 글 중 76%

AI 답변 엔진 쪽도 마찬가지였어요. AI 경유 유입이 5건 이상인 글은 7편뿐인데, 전부 "도구명 + 만들기, 가격, 연결" 꼴 제목에 첫 문장이 정의나 답이었어요.

그래서 질문을 8개에서 5개로 줄였어요

기존에 쓰던 사례글 스킬은 인터뷰 질문이 8개였어요. 상황, 시도와 실패, 결과, 재현을 묻는 좋은 질문들인데, 검색어를 묻는 질문은 없었어요. 그리고 8개는 솔직히 귀찮아요. 저부터 귀찮았어요.

여기서 한 번 막혔어요. 처음엔 "이 글, 뭐라고 검색하면 나와야 할까요?"를 첫 질문으로 넣었거든요. 근데 직원들은 마케터가 아니에요. 자기 글의 검색어를 모르는 게 당연하죠. 그래서 방향을 바꿨어요. 검색어는 스킬이 뒤에서 조사하고, 직원에게는 아는 것만 묻기로요.

최종 질문은 이렇게 됐어요.

  1. 이번 주에 쓴 도구나 기능 이름이 뭐예요?
  2. 그걸로 뭘 했어요? 한 줄로요.
  3. 이 중 어떤 제목이 이번 작업이랑 제일 가까워요? (스킬이 검색어를 조사해 제목 3개를 만들어요)
  4. 이 숫자들 맞아요? (스킬이 세션 기록에서 소요 시간, 커밋 수, 에러 횟수를 먼저 뽑아요)
  5. 이 세 장면을 찍어서 파일 경로만 알려 주세요. (스킬이 찍을 장면을 정해 줘요)

1, 2, 4번은 세션 기록에 답이 있으면 묻지 않고 확인만 받아요. 실제로 고르는 건 제목 하나와 캡처 여부뿐이에요.

스킬이 찾는 것은 검색어·숫자·찍을 장면, 직원이 하는 것은 제목 고르기·숫자 확인·캡처

이미지와 가리기까지 스킬 안에 넣었어요

글에 이미지가 3장은 있어야 하는데, 직원들한테 도식 스킬과 캐릭터 스킬을 따로 설치하라고 하면 안 써요. 그래서 카드 캡처 스크립트, 뽀짝이 캐릭터 생성 스크립트, 설명 도식 템플릿을 스킬 폴더 안에 다 넣었어요. 외부에 필요한 건 브라우저 자동화 도구 하나와 코덱스 CLI 하나뿐이고, 없으면 건너뛰어요.

캡처 속 폴더 경로나 사내 주소를 가리는 것도 스킬이 해요. 캡처를 열어 보고 "여기랑 여기 가릴까요?"라고 물은 다음 승인받은 곳만 흐리게 해요. 닉네임이나 프로필 사진은 안 가려요. 공개 정보인데 과하게 가리면 글이 가짜처럼 보이거든요.

지피터스 글 화면에서 가릴 영역을 흐리게 처리한 실제 결과

발행 전 검사에서 실제로 잡힌 것

검사 스크립트를 제 힉스필드 요금제 글에 돌려 봤어요. 제목, 리드, 한영 병기, 확인일은 통과했는데 세 가지가 걸렸어요. 줄표 14개, AI 냄새 나는 접속어 1개, 그리고 숫자 사이 물결표 3개요. 물결표는 게시판에서 취소선으로 바뀌어서 "47에서 59달러"가 줄 그어진 채로 보이고 있었어요. 폰 화면 미리보기로 찍어 보니 바로 보였어요.

힉스필드 요금제 글에 검사를 돌린 실제 출력, 줄표 14개와 물결표 3곳이 막힘으로 표시됨

이 검사가 없었으면 다음 글에서도 같은 실수를 했을 거예요.

로나 코칭으로 여섯 단계를 밟았어요

이 작업은 클로드 코드 안에서 로나(Rona) 코칭으로 진행했어요. "write post 스킬 개선하고 싶어"라고만 했는데, 로나가 무엇을 만들지와 완료 기준을 물어서 분석, 규칙, 이미지, 스킬 작성, 실전 글, 배포의 여섯 단계로 쪼갰어요. 단계마다 결과를 보여주고 "다음으로 갈까요?"를 물었고, 질문을 8개에서 5개로 줄인 것과 검색어를 직원에게 안 묻기로 한 건 그 자리에서 제가 내린 판단이에요.

작업 숫자

  • 이 스킬만 보면 2026년 9월 17일 저녁부터 18일 오후까지 약 8시간, 클로드 코드에 보낸 메시지 40개, 도구 호출 163회, 에러 4회예요. 세션 기록에서 제가 잰 거예요. 규칙의 절반은 8월 초부터 한 달 넘게 제 데일리 콘텐츠 스킬을 고치며 쌓은 거라 합치면 한 달짜리 작업이에요.
  • 결과물은 스킬 본문 1개, 참조 파일 14개, 스크립트 8개. 분석한 글 222편, 인터뷰 질문 5개, 발행 전 검사 항목 13개.

따라 하려면

스킬을 만들 때 제가 클로드 코드에 준 요청은 이거였어요.

최근 6개월 사내 사례글을 노출 순으로 세워서 상위와 하위의 차이를 찾고, 그 차이에서 직원에게 물을 질문을 뽑아 줘. 질문은 짧게, 직원이 아는 것만. 검색어는 직원이 아니라 스킬이 찾게 해.

같은 걸 하려면 순서는 셋이에요. 먼저 서치 콘솔에서 페이지별 클릭을 뽑고, 그다음 상위 글에 실제로 들어온 검색어를 제목과 대조하고, 마지막으로 그 검색어 꼴을 제목 규칙으로 스킬에 적어요.

이 스킬은 오늘 사내 툴킷에 올렸어요. 바로 전체에 뿌리지는 않고, 먼저 직원 몇 명에게 테스터로 써 보게 할 거예요. 이용기를 받아서 질문 문구와 이미지 규칙을 고친 다음에 공식적으로 사내 전체에 배포할 계획이에요. 그다음 차례는 24기 AI 스터디 수강생들의 주간 사례글이에요. 수강생 글도 검색에 걸리면 좋으니까요.

이 글의 노출·클릭 수치는 2026년 9월 18일 기준이고, 분석 대상은 2026년 3월 18일부터 9월 16일 사이에 발행된 글이에요.

1