Community코딩 & 개발github.com

블로그 리라이터

기존 블로그 게시물을 Google 검색과 AI 인용 플랫폼 모두에서 순위가 오르도록 최적화하여 재작성합니다. 작성자의 어조를 유지하면서 6가지 최적화 핵심 요소를 적용합니다.

블로그 리라이터란 무엇인가요?

블로그 리라이터(blog-rewrite)는 기존 블로그 게시물을 이중 순위(구글 검색 및 AI 인용 플랫폼)에 최적화하는 전문 AI 에이전트 스킬입니다. Claude Code, Codex, Cursor 등 파일 시스템 접근이 가능한 모든 AI 코딩 에이전트에서 사용할 수 있습니다. 이 스킬은 6단계 워크플로우(감사 → 연구 → 차트 생성 → 콘텐츠 재작성 → 검증 → 요약)를 통해 게시물의 품질을 개선합니다. 핵심 특징은 AI 탐지 방지 패턴(버스트니스 점수, AI 특유 문구 대체, 어휘 다양성 향상), 인용 캡슐 주입(AI가 직접 인용할 수 있는 자기 완결적 단락), 정보 획득 마커(원본 데이터, 개인 경험, 고유 인사이트 태깅)입니다. 또한 통계 데이터 소스 조사, 차트 및 이미지 생성, YouTube 동영상 임베드, FAQ 스키마 추가 등 전방위적인 최적화를 수행하며, 최종적으로 5개 카테고리(콘텐츠 품질 30, SEO 최적화 25, E-E-A-T 신호 15, 기술 요소 15, AI 인용 준비도 15)에 걸쳐 점수를 산출하고 개선 전후 비교를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AgriciDaniel/claude-blog/tree/main/skills/blog-rewrite

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

블로그 리라이터 -- 기존 게시물 최적화

기존 블로그 게시물을 Google 검색과 AI 인용 플랫폼 모두에서 순위가 오르도록 재작성하고 최적화합니다. 작성자의 어조를 유지하면서 6가지 최적화 핵심 요소를 적용합니다.

주요 참고 자료:

  • references/quality-scoring.md - 5개 카테고리 점수표 (콘텐츠 30, SEO 25, E-E-A-T 15, 기술 15, AI 인용 15)
  • references/eeat-signals.md - 경험, 전문성, 권위, 신뢰 마커
  • references/internal-linking.md - 링크 전략 및 앵커 텍스트 규칙
  • references/visual-media.md - 이미지 소싱 및 차트 스타일링

워크플로우

1단계: 감사 (읽기 전용)

  1. 블로그 게시물 읽기 - 형식 감지 (MDX, 마크다운, HTML)
  2. references/quality-scoring.md를 기준으로 품질 체크리스트 실행:
    • 조작된 통계 vs 출처가 있는 통계 개수 세기
    • 답변 우선 형식 확인 (H2 -> 첫 문장에 통계?)
    • 이미지 및 차트 개수 세기 (유형 다양성?)
    • 문단 길이 측정 (150단어 초과하는 것 있나?)
    • 제목 계층 확인 (H1 -> H2 -> H3, 건너뛰기 없나?)
    • FAQ 스키마 확인
    • 신선도 신호 확인 (lastUpdated, dateModified)
    • 자기 홍보 수준 평가
    • 인용 계층 품질 평가
  3. AI 콘텐츠 탐지 스캔:
    • 버스트니스 점수 - 게시물 전체의 문장 길이 분산 측정. 분산이 낮으면(대부분의 문장이 서로 3-5단어 차이 이내) 강한 AI 신호. 계산 방법: 문장 단어 수의 표준편차. 목표 SD > 6.
    • 알려진 AI 문구 스캔 - 다음과 같은 고빈도 AI 문구 확인:
      • "오늘날의 디지털 환경에서는", "주목할 점은", "깊이 파고들다"
      • "게임 체인저", "환경을 탐색하다", "혁명을 일으키다", "매끄럽게"
      • "최첨단", "~의 힘을 활용하다", "활용하다" (동사로)
      • "깊이 파다", "결정적이다", "향상시키다", "육성하다", "환경" (남용됨)
      • "다면적인", "견고한", "태피스트리", "착수하다"
      • 전체 목록은 agents/blog-writer.md 참조
    • 어휘 다양성 - 유형-토큰 비율(TTR) 계산: 고유 단어 수 / 전체 단어 수. 낮은 TTR(< 0.40)은 AI 생성 반복 표현을 암시. 자연스러운 산문의 목표 TTR > 0.50.
    • AI 콘텐츠 비율 추정 - 버스트니스, 문구 밀도, TTR을 기반으로 콘텐츠 중 AI 생성으로 읽히는 비율 추정 (0-100%). "AI 콘텐츠 추정: ~X%"로 보고.
  4. 동영상 임베드 확인:
    • 게시물 내 기존 YouTube 임베드 개수 세기
    • 0개이면 플래그: "동영상 임베드 없음. YouTube는 가장 강력한 AI 가시성 상관관계(0.737)를 가짐"
    • 임베드가 있으면 확인: 지연 로딩? aria-labels? noscript 대체? VideoObject 스키마?
  5. 잠식 현상 확인:
    • 제목, H1, 첫 번째 문단에서 게시물의 주요 키워드 식별
    • 블로그 디렉토리에서 동일 키워드를 타겟팅하는 다른 게시물 검색:
      • 모든 블로그 게시물의 제목과 메타 설명을 grep
      • 키워드가 상당히 중복되는 게시물 플래그
    • 잠식 현상이 발견되면 보고:
      • 어떤 게시물이 동일한 키워드로 경쟁하는지
      • 권장: 병합 (하나의 더 강력한 게시물로 결합) 또는 차별화 (한 게시물을 관련 있지만 다른 키워드로 전환)
  6. 5개 카테고리별 현재 점수 계산:
    • 5개 카테고리 점수 (콘텐츠 품질 30, SEO 최적화 25, E-E-A-T 신호 15, 기술 요소 15, AI 인용 준비도 15)
    • 총점: 0-100
  7. 감사 요약 제시 - 구체적인 발견 사항, AI 탐지 결과, 동영상 상태, 잠식 현황, 점수 포함
  8. 계획 모드 진입 - 섹션별 최적화 계획 제시

진행 전 사용자 승인 대기.

2단계: 연구

  1. 기존 콘텐츠에서 블로그 핵심 주제 식별
  2. 조작되거나 출처가 없는 데이터에 대한 대체 통계 찾기:
    • 검색: [주제] 연구 2025 2026 데이터 통계
    • 1~3계층 소스만 타겟팅
  3. 게시물에 이미지가 3개 미만이면 이미지 찾기:
    • Pixabay: site:pixabay.com [주제 키워드]
    • Unsplash: site:unsplash.com [주제 키워드]
    • 각 URL이 HTTP 200을 반환하는지 확인
    • nanobanana-mcp가 구성된 경우, blog-image를 통해 누락/부족 이미지에 대한 AI 생성 제공
  4. 게시물에 차트가 2개 미만이면 차트 계획:
    • 시각화에 적합한 데이터 식별
    • 다양한 차트 유형 선택

3단계: 차트 생성 (내장)

게시물에 더 많은 시각적 요소가 필요할 때 blog-chart 하위 스킬 호출:

  1. 다양성 규칙을 사용하여 차트 유형 선택 (게시물당 유형 반복 없음)
  2. 전달: 차트 유형, 제목, 데이터 값, 출처, 플랫폼 형식
  3. 반환된 SVG를 <figure> 래퍼 내에 직접 삽입
  4. 2,000단어 게시물당 2-4개 차트 목표

차트 유형 선택 및 스타일링 규칙은 references/visual-media.md 참조.

4단계: 콘텐츠 재작성

다음 순서로 변경 사항 적용:

4a. 잘 작동하는 것 유지

  • 작성자의 어조와 고유한 관점 유지
  • 원래 통찰력과 직접 경험 유지
  • 기존 양질의 이미지와 차트 유지
  • 내부 링크 유지

4b. 프론트매터 수정

  • lastUpdated: "YYYY-MM-DD" 추가 (오늘 날짜)
  • 원래 date는 변경하지 않음
  • 메타 설명 수정: 사실이 풍부하고, 150-160자, 통계 1개 포함
  • 누락된 경우 coverImage + coverImageAlt + ogImage 추가
    • 넓은 히어로 이미지(1200x630)를 위해 Pixabay/Unsplash/Pexels 검색
    • 또는 blog-chart를 통해 사용자 정의 SVG 커버 생성 (키 통계가 포함된 텍스트-온-그라디언트)
    • 또는 blog-image 하위 스킬을 통해 사용자 정의 AI 이미지 생성 (nanobanana-mcp가 구성된 경우)
  • 태그/카테고리가 적절한지 확인

4c. 답변 우선 형식 적용

모든 H2 섹션은 다음을 포함하는 40-60단어 문단으로 시작해야 함:

  • 출처가 명시된 특정 통계 최소 1개
  • 제목의 암시적 질문에 대한 직접적인 답변

4d. 조작된 통계 교체

  • 패턴 검색: "X%의...", "Y명 중 X명...", 출처 없는 주장
  • 1~3계층 출처의 실제 데이터로 교체
  • 항상 인라인 출처 표시 포함: ([출처명](url), 연도)

4e. 제목 개선

  • 자연스러운 경우 선언문 제목을 질문으로 변환 (60-70% 목표)
  • 다양성을 위해 2-3개의 선언문 제목 유지
  • 키워드가 2-3개 제목에 자연스럽게 나타나도록 함

4f. 문단 길이 수정

  • 150단어를 초과하는 문단 분할
  • 문단당 40-80단어 목표
  • 각 문단이 가장 중요한 문장으로 시작하도록 함

4g. 시각적 요소 추가

  • H2 제목 뒤에 새 이미지 삽입, 균등 간격
  • 관련 섹션 내에 차트 삽입
  • nanobanana-mcp가 구성된 경우: 스톡 매치가 부족한 섹션에 대한 사용자 정의 이미지 생성 (Task를 통해 blog-image 하위 스킬 호출)
  • 임베드 형식을 감지된 플랫폼에 맞게 조정 (MDX vs 마크다운 vs HTML)

4h. 동영상 임베드 추가

게시물에 YouTube 동영상 임베드가 없는 경우:

  • references/video-embeds.md의 품질 기준을 사용하여 관련 동영상 2-3개 검색
  • 플랫폼에 적합한 형식으로 임베드 (srcdoc 지연 로딩)
  • 배치: 소개 후 1개, 중간 기사 섹션에 1-2개
  • AI 크롤러를 위한 noscript 대체 포함

4i. FAQ 추가/개선

  • FAQ가 없으면 추가 (3-5개 질문)
  • FAQ가 있으면 답변이 40-60단어이고 통계가 포함되었는지 확인
  • 플랫폼에 적합한 FAQ 스키마 마크업 추가

4j. 자기 홍보 줄이기

  • 최대 1회 브랜드 언급 (작성자 약력 컨텍스트만)
  • "저희 [회사명]에서는..." 패턴 제거
  • 판촉 섹션을 교육 콘텐츠로 변환

4k. 인용 캡슐 주입

각 H2 섹션에 대해 인용 캡슐 생성 (또는 기존 것 개선):

  • H2당 40-60단어의 자기 완결적 구절
  • 포함 내용: 특정 주장 1개 + 데이터 포인트 1개 + 출처 표시
  • AI 시스템이 추출하여 직접 인용할 수 있도록 선언적 스타일로 작성
  • 별도의 콜아웃이 아닌 섹션 본문 내에 자연스럽게 배치

예시:

2026년 Gartner 연구에 따르면, 엔터프라이즈 구매자의 58%가 이제 공급업체에
연락하기 전에 AI 어시스턴트를 참고합니다 ([Gartner](https://www.gartner.com), 2026).
이러한 변화는 B2B 콘텐츠가 AI 시스템이 응답에서 추출하여 인용할 수 있을 만큼
간결하게 특정 질문에 답해야 함을 의미합니다.

캡슐은 references/quality-scoring.md의 "AI 인용 준비도" 카테고리(15점)에 매핑됩니다.

4l. 안티-AI-탐지 패턴

AI 탐지 가능한 작성 패턴을 줄이기 위해 다음 변환 적용:

  • em 대시 제거 - 모든 em 대시(-)를 쉼표, 하이픈(-), 콜론 또는 마침표로 대체. 필요시 문장 분할. em 대시는 AI 작성의 신호입니다.
  • 플래그된 문구 교체 - 감지된 모든 AI 문구(1단계 3항목 스캔에서)를 자연스러운 대안으로 교체. 예시:
    • "주목할 점은" -> "염두에 둘 점은" 또는 "기억할 점은"
    • "오늘날의 디지털 환경에서는" -> "지금" 또는 "[특정 연도]에는"
    • "활용하다" -> "사용하다", "적용하다", "이용하다"
    • "깊이 파다" -> "살펴보다", "탐구하다", "파고들다"
    • "견고한" -> "강력한", "탄탄한", "신뢰할 수 있는"
    • "결정적이다" -> "핵심이다", "필수적이다", "중요하다" (또는 문장 재구성)
  • 의도적으로 문장 길이 다양화 - 재작성 후 각 문단 스캔. 긴 문장(18-25단어) 사이에 짧은 임팩트 있는 문장(5-10단어) 주입. 목표: 길이가 서로 5단어 이내로 차이나는 문장이 3개 연속으로 없어야 함.
  • 수사적 질문 주입 - 200-300단어마다 최소 하나의 수사적 질문을 추가하여 선언적 단조로움을 깨뜨림.
  • 축약형 자연스럽게 사용 - 공식적인 구성을 자연스러운 축약형으로 대체: "~하지 않는다" -> "~안 한다", "우리는 ~이다" -> "우린 ~다"
  • 헤징 언어 포함 - 실제 경험을 나타내는 1인칭 헤지(완곡 표현)를 뿌림: "저희 경험상", "저희가 발견한 바에 따르면", "저희가 본 바로는", "이것은 대개", "상황에 따라 다릅니다"

4m. 요약 상자 (핵심 요점)

게시물에 요약 상자가 없으면 소개 직후에 추가:

> **핵심 요점**
> - [통계 및 출처가 포함된 핵심 발견]
> - [두 번째 핵심 통찰 또는 권장 사항]
> - [세 번째 실행 가능한 시사점]
> (3-5개 불릿, 전체 40-60단어. 자기 완결적 - 독자가 전체 기사를 읽지 않고도 핵심 가치를 얻을 수 있음)

기본 레이블은 "핵심 요점"이지만, 페르소나 또는 브랜드 음성에 따라 구성 가능 (예: "결론", "빠른 요약", "알아야 할 사항").

기존 TL;DR 상자가 있으면 불릿 포인트 핵심 요점 형식으로 변환. 40-60단어 요구 사항을 충족하고 출처가 있는 통계를 최소 1개 포함하는지 확인.

4n. 정보 획득 마커 주입

게시물을 검토하여 원본 가치를 확인하고 태깅:

  • [ORIGINAL DATA] - 작성자가 직접 수집한 독점 데이터, 설문 조사 결과, 실험 또는 사례 연구 지표
  • [PERSONAL EXPERIENCE] - 직접 관찰, 얻은 교훈
  • [UNIQUE INSIGHT] - 데이터로 뒷받침되는 독창적인 분석, 반대 관점

게시물에 원본 가치 마커가 부족한 경우:

  • 작성자에게 포함시킬 직접 데이터나 경험 요청
  • 최소한 기존 연구를 새로운 방식으로 연결하는 분석적 통찰력 추가
  • 목표: 게시물당 최소 2-3개 마커

게시물 스타일에 따라 HTML 주석(<!-- [ORIGINAL DATA] -->) 또는 가시적 콜아웃 사용.

5단계: 검증

재작성 후 모든 품질 게이트가 통과되었는지 확인:

핵심 품질 게이트

  1. 모든 H2가 통계 + 출처로 시작
  2. 150단어를 초과하는 문단 없음
  3. 조작된 통계 0개
  4. 제목 계층이 깔끔함
  5. FAQ 섹션이 스키마와 함께 존재
  6. 이미지에 설명적인 alt 텍스트 있음
  7. 프론트매터에 커버 이미지 있음 (coverImage + ogImage)
  8. MDX인 경우: 프로젝트를 빌드하여 컴파일 오류 확인

새 요소 검증

  1. 소개 후 TL;DR 상자 있음 (40-60단어, 통계 포함)
  2. 정보 획득 마커 최소 2-3개 있음
  3. 주요 H2 섹션에 인용 캡슐 있음 (40-60단어, 자기 완결적)
  4. 내부 링크 영역 표시 또는 실제 링크 있음 (2,000단어당 5-10개)
  5. 금지 목록의 AI 탐지 가능 문구가 남아 있지 않음

버스트니스 및 자연스러움 확인

  1. 문장 길이 분산: SD > 6 (짧은 문장과 긴 문장 혼합)
  2. 축약형이 전체적으로 자연스럽게 사용됨
  3. 수사적 질문 있음 (200-300단어당 1개)
  4. 감사 기준선 대비 AI 콘텐츠 추정치 감소
  5. 1단계 감사 대비 5개 카테고리 모두에서 점수 향상
  6. YouTube 동영상 임베드가 지연 로딩, aria-labels, noscript 대체와 함께 있음

6단계: 요약

## 블로그 최적화 완료: [제목]

### 점수 변화
- 최적화 전: [X]/100 ([등급])
  - 콘텐츠 품질: [X]/30
  - SEO 최적화: [X]/25
  - E-E-A-T 신호: [X]/15
  - 기술 요소: [X]/15
  - AI 인용 준비도: [X]/15
- 최적화 후: [Y]/100 ([등급])
  - 콘텐츠 품질: [Y]/30
  - SEO 최적화: [Y]/25
  - E-E-A-T 신호: [Y]/15
  - 기술 요소: [Y]/15
  - AI 인용 준비도: [Y]/15

### AI 탐지
- 최적화 전: ~[X]% AI 탐지 콘텐츠
- 최적화 후: ~[Y]% AI 탐지 콘텐츠
- 교체된 문구: [N]개
- 버스트니스 개선: [최적화 전 SD] -> [최적화 후 SD]

### 잠식 현황
- [상태: 발견되지 않음 / N개 게시물 플래그 지정 / 해결됨]

### 변경 사항
- [X]개 통계를 출처 있는 데이터로 교체
- [X]개 SVG 차트 추가 (유형: ...)
- Pixabay/Unsplash에서 [X]개 이미지 추가
- [N]개 H2 섹션에 답변 우선 형식 적용
- [N]개 질문으로 FAQ 스키마 주입
- TL;DR 상자: [추가됨/업데이트됨]
- 정보 획득 마커: [N]개 ([유형])
- H2 섹션에 인용 캡슐: [N]개
- AI 문구 교체: [N]개
- lastUpdated가 [날짜]로 설정됨
- 자기 홍보가 [N]회 언급으로 줄어듦

### 시각적 요소
- 차트: [개수]개 ([유형])
- 이미지: [개수]개
- YouTube 동영상: [개수]개 ([제목])

### 다음 단계
- `/blog analyze <file>`로 최종 점수 확인
- 게시 / 배포

업데이트 모드

/blog update <file>로 호출 시, 신선도에 초점:

  1. 통계를 사용 가능한 최신 데이터(2025-2026)로 업데이트
  2. 마지막 업데이트 이후의 새로운 개발 사항 추가
  3. 1년 이상 된 이미지 새로 고침
  4. 프론트매터의 lastUpdated 업데이트
  5. 기존 구조 유지 - 재작성 최소화
  6. 목표: AI 크롤러에 "신선한" 것으로 등록되도록 콘텐츠 변경 최소 30%

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

관련 스킬