이 글도 AI가 썼습니다 — 그런데 검수를 두 번 거쳤죠: 매일 발행되는 Claude Code 스킬 구조 해부

이 블로그의 글은 사람이 쓰지 않습니다. 그런데 아무 글이나 나가지도 않아요. 매일 콘텐츠를 만들어 발행하는 Claude Code '스킬'의 내부 구조를 해부해 봅니다 — 지금 읽고 계신 이 글도 그 파이프라인에서 나왔거든요.

프롬프트 복붙과 '스킬'의 차이

잘 쓴 프롬프트를 메모장에 모아두고 매번 붙여넣어 보신 적 있으시죠. 두 번째 주부터 문제가 생깁니다. 붙여넣는 사람이 바쁘고, 프롬프트는 조금씩 변형되고, 결과 검수는 슬그머니 생략되거든요. Claude Code의 스킬은 이걸 폴더 하나로 고정합니다.

• SKILL.md — 단계별 절차서. 상단 frontmatter의 name·description을 보고 Claude가 언제 이 스킬을 꺼낼지 스스로 판단해요.
• references/ — 브랜드 보이스·금칙어·검수 루브릭 같은 기준 문서. 제품이 바뀌면 여기만 갈아끼웁니다.
• scripts/ — OG 카드 생성, 차트, 발행 API 호출처럼 매번 똑같아야 하는 작업은 코드로. AI 대신 스크립트가 하니 결과가 흔들리지 않아요.

핵심 가치는 '글을 잘 쓴다'가 아니에요. 매번 같은 절차가 보장된다는 것. 자동화는 거기서 시작합니다.

매일 돌아가는 6단계 파이프라인

저희는 콘텐츠 에이전시의 분업을 그대로 옮겼습니다. 리서처, 작가, SEO 담당, 검수자 — 사람 대신 단계가 그 역할을 맡을 뿐이에요.

단계마다 산출물이 파일로 남습니다. research.json, outline.json, draft.md, seo.json, review.json, final.md. 이게 은근히 중요해요. 글이 이상하게 나왔을 때 어느 단계에서 틀어졌는지, 파일만 열어보면 보이거든요.

품질을 지키는 두 장치 — 독립 AI 검수와 사람 게이트

자동 생성의 무서운 점: 틀린 글도 같은 속도로 나갑니다. 그래서 장치를 두 겹 둡니다.

하나는 독립 AI 검수예요. 글을 쓴 세션이 아닌 별도 AI가 루브릭(정확성·가독성·브랜드 톤·SEO)으로 채점하고, 본문의 주장 하나하나를 리서치 근거와 대조합니다. 기준 미달이면 구체적인 수정 지시와 함께 반려돼요. 자기가 쓴 글을 자기가 검수하면 후해집니다. 그래서 분리가 핵심이에요.

다른 하나는 사람 승인 게이트입니다. 목차 확정과 발행, 딱 두 곳에서만 사람이 개입해요. 전부 자동이면 무인 발행 사고가 나고, 전부 수동이면 자동화가 아니니까요.

스킬은 TDD로 다듬습니다

스킬을 고칠 땐 코드의 테스트 주도 개발처럼 갑니다. 실패부터 관찰하고, 규칙은 그 뒤에 붙여요.

최근 사례가 있어요. 월간 업데이트(체인지로그) 글을 시켰더니, 스킬은 배운 대로 후킹형 제목("이거 모르면 절반만 쓰고 계신 겁니다")을 뽑았습니다. 아티클엔 정답이지만 매달 같은 꼴로 쌓여야 하는 체인지로그엔 오답이죠. 이 실패를 기록하고, 실패를 겨냥한 분기 규칙만 추가하고, 같은 과제를 다시 시켜 통과를 확인했습니다. 실패 관찰 → 규칙 추가 → 재검증. 순서가 뒤집히면 스킬은 상상 속 문제를 막는 규칙으로 비대해집니다.

직접 만들어보기 — 뼈대는 30분

뼈대는 이게 전부입니다.

.claude/skills/my-blog/
  SKILL.md        # 절차서 (frontmatter: name, description)
  references/     # 보이스·금칙어·루브릭
  scripts/        # 발행·이미지 등 결정적 작업

---
name: my-blog
description: 회사 블로그 초안을 리서치→작성→검수 절차로 만든다.
  사용자가 블로그 글, 콘텐츠 초안, 아티클 작성을 요청할 때 사용.
---
1. 리서치 — WebSearch로 근거 수집 → research.json 저장
2. 아웃라인을 사용자에게 보여주고 승인 받기
3. 본문 작성 (references/voice.md 의 어조·금칙어 적용)
4. 별도 세션에 검수 요청 — 기준 미달이면 3으로 반려
5. 승인 후 발행

공식 작성 가이드에서 둘만 기억하셔도 됩니다. description엔 '언제 쓰는지'를 트리거 단어까지 구체적으로 — Claude가 이걸 보고 스킬을 자동 호출하거든요. 그리고 본문은 명령형으로 간결하게 — 스킬이 로드되면 모든 줄이 토큰 비용입니다.

자동화에 데이터가 필요하다면

저희 쇼츠 스킬은 대본을 쓰기 전에 Rainbow Prism의 발굴 API부터 호출합니다. '지금 한국에서 구독자 대비 몇 배로 터지는 영상'이 재료로 들어오는 거죠. 데이터가 들어오면 콘텐츠에 관찰이 실리고, 막연한 주장은 줄어듭니다.

같은 재료를 쓰실 수 있어요. Rainbow Prism의 원격 MCP를 Claude에 등록하면 "게임 쇼츠에서 구독 대비 터진 영상 찾아줘" 같은 문장이 여러분의 스킬 안에서 실데이터로 돌아옵니다(Expert 플랜).

👉 Rainbow Prism 무료로 시작하기

자주 묻는 것들

글 하나에 비용이 얼마나 드나요? Claude Code 구독 한도 안에서 돌아갑니다(개인 대화형 사용 기준). 편당 별도 API 과금은 없지만 무제한도 아니라서, 하루 수십 편씩 배치로 돌리면 한도에 걸려요.

한 편에 시간은 얼마나 걸리나요? 리서치부터 발행까지, 사람 개입 2번 포함 30분에서 1시간대예요. 검수 반려가 나면 조금 더 걸립니다.

검수는 어떤 모델로 하나요? 작성과 분리된 세션에서 상위 추론 모델을 씁니다. 사실 대조와 채점은 추론 비중이 커서, 여기만큼은 아끼지 않아요.

이 구조가 정답이라고는 생각하지 않습니다. 저희도 실패를 관찰할 때마다 규칙을 고치는, 계속 발전시켜 가는 중인 컨셉이에요. 콘텐츠 운영이나 AI 파이프라인을 다뤄보신 분들의 조언과 경험담은 언제나 환영입니다 — support@mobiolabs.net 으로 들려주세요. 다음 개선의 재료가 됩니다.

오늘 해볼 일은 하나면 충분해요. 폴더 하나 만들고, SKILL.md에 여러분의 절차를 다섯 줄로 적어보세요.