AgriciDaniel/claude-blog

Claude Code blog skill suite: 30 sub-skills, 5 agents, 5-gate v1.9.0 Blog Delivery Contract, dual-optimized for Google rankings and AI citations. Active development at AI-Marketing-Hub/claude-blog (AI Marketing Hub Pro community); public releases ship here.

claude‑blog란?

claude‑blog는 Claude AI가 블로그 게시물을 자동으로 작성, 편집, 감사, 번역, 게시할 수 있게 해주는 Claude Code 스킬 스위트입니다. 많은 하위 스킬(31개 하위 스킬 + 오케스트레이터)을 단일 /blog 명령 세트 뒤에 래핑합니다. 각 기사는 초안이 사용자에게 반환되기 전에 형식, 시각적 요소, AI 검토 점수, 링크 무결성 및 SEO를 확인하는 5단계 게이트 전달 계약을 거칩니다.

누가 사용할까요?

개인 창작자: 수동 편집 없이 SEO 친화적이고 스키마가 풍부한 게시물을 생성할 수 있는 턴키 방식을 원하는 분.
마케팅 팀/에이전시: 반복 가능한 다중 게시물, 다국어 또는 토픽 클러스터 워크플로가 필요한 분.
Claude Code 개발자: 계층적 Agent Skills 아키텍처(오케스트레이터 → 하위 스킬 → 에이전트 → 스크립트)의 구체적인 예를 원하는 분.

핵심 기능(개요)

영역	스킬 기능
작성	`/blog write <주제>`로 처음부터 전체 기사(MD, HTML, PDF, 히어로 이미지, 스크린샷)를 생성합니다.
재작성	`/blog rewrite <파일>`로 기존 게시물을 SEO, 스키마, AI 인용 준비에 맞게 최적화합니다.
계획	`/blog strategy`, `/blog calendar`, `/blog cluster`로 틈새 전략, 편집 달력, 허브 앤 스포크 토픽 클러스터를 생성합니다.
SEO 및 스키마	`/blog seo‑check`, `/blog schema`로 Google 정렬 체크리스트와 JSON‑LD 마크업을 생성합니다.
다국어	`/blog multilingual`, `/blog translate`, `/blog localize`로 콘텐츠를 작성, 번역, 문화적으로 적응시키고 적절한 `hreflang` 태그를 출력합니다.
오디오 및 미디어	`/blog audio`(Gemini TTS), `/blog image`(Gemini 이미지 생성)로 내레이션과 AI 생성 비주얼을 추가합니다.
품질 게이트	5개의 자동 게이트가 도구 가용성, 파일 완전성, 시각적 검증, 검토자 점수(≥ 90), 자산/링크 무결성을 강제합니다.
분석	`/blog decay`는 Google Search Console 데이터를 사용하여 트래픽 감소를 플래그합니다. `/blog analyze`는 모든 게시물을 0‑100으로 점수화합니다.
페르소나 및 브랜드	`/blog persona` 및 `/blog brand`로 모든 하위 스킬이 자동으로 로드하는 음성 프로필과 브랜드 가이드라인을 저장할 수 있습니다.
연구	`/blog discourse`(API 없는 소셜 리스닝), `/blog notebooklm`(Gemini Notebook 연구), `/blog factcheck`는 인용된 통계를 검증합니다.

아키텍처 개요

오케스트레이터(skills/blog/SKILL.md)가 /blog 명령을 파싱하고 적절한 하위 스킬을 선택하며 에이전트와 헬퍼 스크립트를 조정합니다.
31개 하위 스킬(skills/blog‑*/SKILL.md)이 각각 사용자 대상 명령(예: write, rewrite, translate)을 구현합니다.
5개 전문 에이전트(agents/blog‑*.md)가 검토 점수 매기기 및 인용 준비와 같은 작업을 수행합니다.
22개 Python 헬퍼 스크립트(scripts/*.py)가 렌더링, 사전 점검, 품질 게이트, 설치 프로그램 로직을 구현합니다.
템플릿 및 참조는 기성 기사 구조(12개 템플릿)와 전달 계약에 사용되는 휴리스틱을 제공합니다.
테스트 스위트(pytest)가 전체 파이프라인을 검증합니다. CI는 모든 푸시에서 실행됩니다.

얻는 방법

Claude Code 마켓플레이스 통해(권장):
```
/plugin marketplace add AgriciDaniel/claude-blog
/plugin install claude-blog@agricidaniel-blog
```
Claude Code 2.1.296 이상에서 작동합니다(스킬 시스템은 2.0.12에서 도입됨).
독립 설치 프로그램(Unix/macOS/Windows) – 릴리스 태그 v2.3.0 이상에서 스크립트를 실행합니다. 설치 프로그램에는 실수로 인한 삭제를 방지하는 소유권 인식 정리 스크립트가 포함되어 있습니다.

일반적인 워크플로 예시

/user> /blog strategy tech‑startup
   → 틈새 브리프, 키워드 목록, 콘텐츠 달력을 생성합니다.
/user> /blog write "How to launch a SaaS MVP"
   → 오케스트레이터가 하위 스킬을 실행하고, markdown을 만들고, HTML/PDF를 렌더링하고, 히어로 이미지를 생성합니다.
   → 사전 게이트 1은 도구를 확인하고, 게이트 2는 파일 완전성을 확인하고, 게이트 3은 스크린샷을 렌더링하고, 게이트 4는 검토 에이전트를 실행하고(점수 ≥ 90), 게이트 5는 링크를 검증합니다.
   → 게이트가 실패하면 스킬은 반복(최대 3회)하거나 에스컬레이션합니다.
/user> /blog analyze ./output/how-to-launch.md
   → 0‑100 품질 점수를 반환하고 개선 영역을 강조합니다.

모든 산출물은 artifact/ 폴더에 저장되므로 markdown, HTML, PDF, 이미지를 CMS에 직접 게시할 수 있습니다.

주목할 만한 추가 기능

AI 인용 준비 – 게시물이 다른 AI(Perplexity, ChatGPT 등)에 의해 인용될 준비가 얼마나 되었는지 평가하는 휴리스틱(scripts/ai_citation_score.py).
Pre‑commit 훅 – 점수가 70 미만인 게시물의 커밋을 차단하여 전달 계약을 실행하기 전에도 품질을 보장합니다.
FLOW 프레임워크 통합 – Find, Leverage, Optimize, Win 프롬프트를 /blog flow 명령으로 노출합니다.
Google API 지원 – PageSpeed, CrUX, Search Console, GA4, NLP, YouTube, Keyword Planner(인덱싱 가능한 URL로 제한).

고려 시점

이미 Claude Code를 사용하고 있고 SEO, 스키마, 다국어 게시, 엄격한 품질 게이트를 강제하는 단일 명령, 종단 간 블로그 제작 파이프라인이 필요하다면, claude‑blog가 기성 솔루션을 제공합니다. 또한 복잡한 Claude Code 스킬 스위트를 구축하는 데 유용한 학습 리소스입니다.