claude-blog

# Claude Code용 AI 블로그 작성 및 SEO 최적화 스킬 (claude-blog)

claude-blog는 블로그 콘텐츠를 대규모로 작성, 최적화, 감사, 현지화, 갱신하는 Claude Code 스킬 모음입니다. 모든 글은 Google이 정렬한 유용성과 내부 AI 인용 준비도 휴리스틱으로 평가됩니다. 버전 2.3.1은 2026-10-13에 준비되었습니다.

핵심 약속은 단순합니다. 사용자가 첫 번째 검토자가 되지 않는다는 것입니다. 5-게이트 Blog Delivery Contract는 모든 초안을 100점 루브릭으로 채점하고, 90점 미만은 전달을 차단하며, 산출물과 링크를 검증하고, 에스컬레이션 전까지 최대 3회 반복합니다.

이것은 MIT 라이선스로 공개된 배포판이며 위치는
AgriciDaniel/claude-blog 입니다.
퍼블리싱 워크플로는
docs/PUBLISHING.md 에 문서화되어 있습니다.

블로그: claude-blog가 어떻게 작동하는지 보기

YouTube에서 영상 보기

데모

YouTube에서 원본 데모 보기 .

## 무엇인가
claude-blog는 전략, 브리프, 개요, 작성, 재작성, 분석, 스키마, AI 인용 준비도, 사이트 감사, 토픽 클러스터, 다국어 퍼블리싱, 오디오 내레이션, 콘텐츠 감쇠 감지를 위한 전체 라이프사이클 블로그 엔진입니다.

현재 v2.3.1 구성: 32개 스킬 디렉터리 = 1개 오케스트레이터 + 31개 서브 스킬; 30개 사용자 대상 /blog 명령 ( blog-chart 는 내부용이며 명령이 아님). 또한 5개 특화 에이전트, 저장소 일관성 및 공개 릴리스 검증기, 22개 핵심 레퍼런스, 12개 템플릿, pytest 스위트(현재 개수는 python3 -m pytest --collect-only -q | tail -1 실행), 그리고 ./brain 에 번들된 Claude Blog Brain을 포함합니다.

모든 초안은 마크다운 소스, 렌더링된 HTML, PDF, 실제 hero.<ext> , 3개 뷰포트 스크린샷, review.md , preflight-report.json 을 포함한 산출물 폴더로 제공됩니다. 렌더러는 XSS 안전한 JSON-LD 처리, 다크 모드 인식 CSS, 그리고 모든 출력 형식에 동일한 소스를 사용합니다.

## 누구를 위한 것인가
솔로 블로거와 크리에이터는 SEO, 스키마, 출처 확인, 내부 링크에 시간을 쏟지 않고도 고품질 글을 발행할 수 있습니다.

마케팅 팀과 에이전시는 /blog cluster , /blog multilingual , /blog persona , /blog brand , /blog discourse 를 통해 브랜드, 언어, 저자, 플랫폼 전반에 걸쳐 일관된 다중 글 워크플로를 운영할 수 있습니다.

Claude Code 스킬 빌더는 계층화된 Agent Skills 아키텍처(SKILL.md 파일의 지시 계층, 하나의 라우팅 스킬과 에이전트로 구성된 오케스트레이션 계층, 스크립트의 실행 계층)를 오케스트레이터 라우팅, 서브 스킬 디스패치, 에이전트 핸드오프, 코드로 강제되는 전달 게이트, 설치 프로그램 강화, CI 일관성 검사와 함께 연구할 수 있습니다.

## Claude Code 스킬 플러그인은 어디에 설치되어야 하는가?
대부분의 사용자 설치형 Claude Code 스킬 플러그인은 스킬 콘텐츠의 경우 ~/.claude/skills/<name>/ 에, 에이전트의 경우 ~/.claude/agents/<name>.md 에, Python 헬퍼의 경우 ~/.claude/scripts/<helper>.py 에 배포되어야 합니다.

이 답변은 claude-blog가 생성하는 GEO 및 SEO 작성 패턴을 보여주기 위해 의도적으로 README에 유지됩니다: 답변 우선 요약, 명시적 경로, 출처 준비 구조, 그리고 AI 시스템이 추가 컨텍스트 없이 인용할 수 있는 간결한 FAQ 준비 섹션.

생성된 글의 축약된 견본:

---
title : " Claude Code 스킬 플러그인은 어디에 설치되어야 하는가? "
description : " 설치 경로 질문에 대한 실용적 답변... "
date : " 2026-05-18 "
author : " Daniel Agrici "
tags : [claude-code, skills, plugins, installation]
canonical : " https://example.com/blog/skill-plugin-install-path "
---

## Claude Code 스킬 플러그인은 어디에 설치되어야 하는가?

짧은 답변: 대부분의 사용자 설치형 Claude Code 스킬 플러그인은
스킬 콘텐츠의 경우 ` ~/.claude/skills/<name>/ ` 에,
에이전트의 경우 ` ~/.claude/agents/<name>.md ` 에,
Python 헬퍼의 경우 ` ~/.claude/scripts/<helper>.py ` 에 배포되어야 합니다.

### 핵심 요점
- ` ~/.claude/skills/ ` 는 SKILL.md 표면 영역입니다.
- ` ~/.claude/agents/ ` 는 에이전트 마크다운 파일을 보관합니다.
- 전체 글에는 출처 인용, FAQ, 스키마 JSON-LD가 포함됩니다.
## 아키텍처

skills/blog/SKILL.md 의 오케스트레이터는 /blog 입력을 파싱하고, 대상 플랫폼을 감지하고, 필요한 레퍼런스만 로드하고, 서브 스킬로 라우팅하며, 전달 계약을 통해 에이전트와 스크립트를 조정합니다.

계층
개수
위치

스킬 디렉터리
32
skills/blog 및 skills/blog-*

오케스트레이터
1
skills/blog/SKILL.md

서브 스킬
31
skills/blog-*/SKILL.md

사용자 대상 /blog 명령
30
skills/blog/SKILL.md 라우팅 테이블

내부 전용 서브 스킬
1
skills/blog-chart/SKILL.md

특화 에이전트
5
agents/blog-*.md

루트 스크립트
22
scripts/*.py

레퍼런스
22
skills/blog/references/*.md

템플릿
12
skills/blog/templates/*.md

테스트
pytest 스위트
tests/ (개수는 python3 -m pytest --collect-only -q | tail -1 )

더 자세한 아키텍처 내용은 docs/ARCHITECTURE.md 에 있습니다.

## 5-게이트 Delivery Contract

모든 /blog write 및 /blog rewrite 결과는 사용자에게 표시되기 전에 전달 계약을 통과해야 합니다.

게이트
강제 사항
구현

1. Capability Discovery
작성 전에 필수 도구, 에이전트, 환경 변수, 선택적 의존성이 파악됨
scripts/blog_preflight.py --gate 1

2. Format Completeness
.md , .html , .pdf , 실제 히어로 이미지가 존재하고 유효함: 남은 [IMAGE] , [CHART] , [INTERNAL-LINK] 마커 없음, 슬러그 스타일 파일명, 히어로가 디코딩되고 최소 1200x630, PDF가 최소 한 페이지로 열림, HTML의 blog-source-sha256 이 .md 와 일치, 정적 HTML 검사(lang, title, 메타 설명, H1 하나, 제목 순서, og 태그, noindex 없음, 대체 텍스트, 활성 콘텐츠 없음)
scripts/blog_render.py , scripts/generate_hero.py , scripts/blog_preflight.py

3. Visual Verification
스크린샷이 375, 768, 1280 너비로 렌더링됨, JSON-LD 유효, 다크 모드 유지, SVG 오버플로 없음, 숨겨진 글 텍스트 없음
patchright 또는 playwright

4. Content Review
blog-reviewer 점수가 90+이고 P0 이슈가 없으며, nonce가 일치하고, nonce 발급 후 초안이 변경되지 않음(오래된 리뷰는 위반)
agents/blog-reviewer.md

5. Asset and Link Integrity
이미지가 해석됨, og:image 존재, 링크가 검증된 URL 정책을 충족, 단어 수가 스키마와 5% 이내로 일치
scripts/blog_preflight.py --gate 5

순서는 고정되어 있습니다: 초안 작성, 마커와 비주얼 해결, 렌더링, 리뷰 nonce 발급, 리뷰, 게이트 실행, 그리고 편집 후 재렌더링, 재발급, 재리뷰(최대 3회 반복). 렌더러 자체의 푸터 링크는 스킴만 검사하므로 완전히 로컬인 글은 오프라인에서 Gate 5를 통과할 수 있습니다; 외부 링크는 네트워크 접근이 필요하며, 그곳에서의 실패는 죽은 링크가 아니라 네트워크나 DNS 문제일 수 있습니다. 리뷰 nonce는 사고와 우발적 위조를 막지만, 상태 파일을 읽을 수 있는 동일 사용자로 실행되는 프로세스는 막지 못합니다. 전체 순서와 모든 검사는 한 곳에 있습니다: skills/blog/references/blog-delivery-contract.md .

히어로 이미지 사다리: Banana MCP, 직접 Gemini API, 프리미엄 스톡 API, 그다음 Openverse. 첫 번째로 작동하는 소스가 이깁니다. 사다리는 동일한 계약에 명시되어 있습니다.

## 서브 스킬 생태계

생태계는 의도적으로 모듈식입니다. 대부분의 명령은 사용자 대상 서브 스킬입니다. blog-chart 는 내부 전용이며, blog-image 는 사용자와 write 및 rewrite 워크플로 내부 양쪽에서 호출될 수 있습니다.

### 명령
첫 실행: 사이트 범위를 정하려면 /blog strategy <niche> , 게이트된 글을 생성하려면 /blog write <topic> , 기존 글을 채점하려면 /blog analyze <file-or-url> .

명령
하는 일

/blog write <topic>
처음부터 새 블로그 글 작성

/blog rewrite <file>
기존 블로그 글 재작성/최적화

/blog analyze <file-or-url>
0-100 점수로 블로그 품질 감사

/blog brief <topic>
상세한 콘텐츠 브리프 생성

/blog calendar [monthly|quarterly]
편집 캘린더 생성

/blog strategy <niche>
블로그 전략 및 토픽 아이디어 도출

/blog outline <topic>
SERP 기반 콘텐츠 개요 생성

/blog seo-check <file>
작성 후 SEO 검증 체크리스트

/blog schema <file>
JSON-LD 스키마 마크업 생성

/blog repurpose <file>
콘텐츠를 다른 플랫폼용으로 재활용

/blog geo <file>
AI 인용 준비도 감사

/blog audit [directory]
전체 사이트 블로그 상태 평가

/blog cannibalization [dir]
글 간 키워드 잠식 감지

/blog factcheck <file>
통계를 인용 출처와 대조 검증

/blog image [generate|edit|setup]
Gemini를 통한 AI 이미지 생성 및 편집

/blog persona [create|list|use|show]
작성 페르소나 및 보이스 프로필 관리

/blog brand [init|show|update]
모든 서브 스킬이 자동 로드하는 BRAND.md + VOICE.md 컨텍스트 파일 생성

/blog discourse <topic>
지난 30일 동안 사람들이 어떤 주제에 대해 실제로 말하는지 조사; DISCOURSE.md 생성(v1.8.0, API 불필요)

/blog taxonomy [suggest|sync|audit]
CMS 플랫폼 전반의 태그/카테고리 관리

/blog notebooklm <question>
출처 기반 연구를 위해 NotebookLM에 질의

/blog audio [generate|voices|setup]
블로그 글의 오디오 내레이션 생성

/blog google [command] [args]
Google API 데이터: PSI, CrUX, GSC, GA4, NLP, YouTube, Keywords

/blog update <file>
기존 글을 최신 통계로 갱신(rewrite로 라우팅)

/blog cluster [plan|execute] <seed-or-plan>
시맨틱 토픽 클러스터 계획 + 실행(허브 앤 스포크)

/blog multilingual <topic> --languages <codes>
한 명령으로 작성 + 번역 + 현지화 + hreflang 출력

/blog translate <file> --to <codes>
형식 보존을 유지하는 SEO 최적화 번역

/blog localize <file> --locale <code>
문화적 심층 적응(DACH, FR, ES, JA, 사용자 정의)

/blog locale-audit <directory>
다국어 콘텐츠 QA(완전성, hreflang, 동등성, 최신성)

/blog flow [find|optimize|win|prompts|sync]
FLOW 프레임워크 프롬프트(증거 기반, 블로그 적용 가능 30개)

/blog style learn <paths>
5-10개 글로부터 저자 보이스 프로필 학습(blog-write 및 blog-persona에 공급)

/blog decay <current-gsc> <previous-gsc>
콘텐츠 감쇠 감지: GSC 내보내기에서 20%+ QoQ 트래픽 감소 플래그

/blog update 는 blog-rewrite 로 라우팅되는 최신성 별칭입니다; 프로젝트 개수는 여전히 30개 사용자 대상 /blog 명령입니다. blog-chart 는 내부 전용으로 유지됩니다.

전체 레퍼런스: docs/COMMANDS.md .

## FLOW 프레임워크

claude-blog는 AgriciDaniel/flow (CC BY 4.0)의 FLOW 프레임워크를 통합합니다. FLOW는 Find, Leverage, Optimize, Win 을 의미합니다. 스킬은 Find, Optimize, Win 을 /blog flow 명령으로 노출합니다; Leverage 는 /blog flow prompts 를 통해 프롬프트 패밀리로 제공되며 초안 작성, 재활용, 배포 워크플로 내부에서 적용됩니다.

## 기능
### v1.10 및 v1.11 하이라이트

5-게이트 Delivery Contract : 형식, 비주얼, 리뷰, 자산, 링크에 대한 코드 강제 사전 표시 게이트.
AI Citation Readiness Heuristic : scripts/ai_citation_score.py 는 AI Overview, Perplexity, ChatGPT에 대한 비보정 0-100 편집 준비도 뷰를 생성하고 /blog geo 에 공급합니다.
작성 스타일 학습 : /blog style learn <paths> 는 5~10개 글로부터 저자 보이스 프로필을 구축합니다.
콘텐츠 감쇠 감지 : /blog decay <current-gsc> <previous-gsc> 는 20%+ 분기 대비 GSC 트래픽 감소를 플래그하고 갱신, 통합, 정리 작업을 제안합니다.
Pre-commit 품질 게이트 : scripts/quality_gate.py 와 .pre-commit-config.yaml 은 점수 70 미만의 블로그 글을 커밋 전에 차단합니다. 훅은 --select 를 전달하여 블로그 글이 아닌 Markdown 파일을 건너뜁니다; 직접 실행하면 게이트는 잘못된 경로나 블로그 프런트매터가 없는 파일에서 닫힌 상태로 실패합니다.
브랜드 및 담론 컨텍스트 : /blog brand 는 BRAND.md 와 VOICE.md 를 작성합니다; /blog discourse 는 DISCOURSE.md 를 작성합니다. 오케스트레이터는 펜스로 감싸고 nonce로 바인딩된 신뢰할 수 없는 데이터 처리를 통해 이를 로드합니다.
다국어 및 토픽 클러스터 : /blog multilingual , /blog translate , /blog localize , /blog locale-audit , /blog cluster 는 국제 허브 앤 스포크 퍼블리싱을 지원합니다.
결정적 블로그 위생 : scripts/blog_hygiene.py 는 사람의 리뷰를 대체하지 않고 지연 이미지 로딩과 목차를 추가할 수 있습니다.

### 12개 콘텐츠 템플릿
주제와 의도에 따라 자동 선택: 방법 가이드, 리스티클, 사례 연구, 비교, 필러 페이지, 제품 리뷰, 사고 리더십, 라운드업, 튜토리얼, 뉴스 분석, 데이터 연구, FAQ 지식 베이스.

### 5개 카테고리 품질 점수

카테고리
점수
초점

콘텐츠 품질…