Claude Code를 위한 AI 블로그 작성 및 SEO 최적화 스킬 (claude-blog)
이 스킬에는 두 가지 버전이 있습니다. 작업 방식에 맞는 것을 선택하세요:
- 🌐 공개 오픈소스:
AgriciDaniel/claude-blog. MIT 라이선스, 공개 릴리스, 누구나 사용 가능. 안정적이고 다운로드 가능하며 멤버십이 필요 없는 버전을 원할 경우 이것을 사용하세요.- 🔒 커뮤니티 비공개 미러 (이 저장소):
AI-Marketing-Hub/claude-blog. 개발 중인 작업(v1.9.0+ 블로그 배달 계약, 히어로 래더, 돌연변이 테스트된 회귀 범위)에 조기 액세스하고, AI Marketing Hub Pro 커뮤니티와 직접 협업할 수 있습니다. 멤버십이 필요합니다.위의 배지는 공개 저장소(
AgriciDaniel/claude-blog)를 추적합니다. 비공개 미러는 shields.io에 표시되지 않기 때문입니다. 게시 워크플로(비공개 개발, 검토, 공개 릴리스)는docs/PUBLISHING.md에 문서화되어 있습니다.
블로그: claude-blog 작동 방식 보기
claude-blog는 대규모로 블로그 콘텐츠를 작성, 최적화 및 감사하는 Claude Code 스킬 모음입니다. 모든 기사는 Google 순위(2025년 12월 Core Update, E-E-A-T)와 AI 인용 플랫폼(ChatGPT, Perplexity, AI Overviews)에 이중 최적화됩니다. v1.9.0 5-게이트 배달 계약은 모든 초안을 100점 기준으로 평가하고 90점 미만은 사용자에게 도달하지 못하도록 차단합니다.
핵심 요약
- 무엇인가: 30개의 하위 스킬, 5개의 에이전트, 12개의 콘텐츠 템플릿, 21개의 온디맨드 참조, 9개의 루트 레벨 Python 스크립트, 160개의 통과 테스트를 갖춘 전체 수명 주기 블로그 엔진입니다.
- 누구를 위한 것인가: 일회성 초안이 아닌 프로덕션급 콘텐츠 출력을 원하는 개인 블로거, 마케팅 팀, 에이전시 및 Claude Code 스킬 빌더.
- 핵심 약속: 모든 초안은 5-게이트 배달 계약(Capability, Format, Visual, Content Review, Asset Integrity)을 통과하거나 작성자가 최대 3회 반복 후 사용자에게 에스컬레이션합니다.
- 차별점: 자체 제품을 사용합니다. 14개 표면에서 CI로 버전 일관성을 강제하고, 모든 PR에서 문체 위생 검사를 실행하며, 세 가지 돌연변이 테스트 회귀 제품군이 v1.9.0 수정 사항을 잠그고,
blog-reviewer는 조언이 아닌 BLOCKING 게이트입니다. - 현재: v1.9.0, 2026-05-18 출시. Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby, 정적 HTML에서 작동합니다.
claude-blog는 누구를 위한 것인가?
claude-blog는 하나의 엔진으로 세 가지 대상에게 서비스를 제공합니다:
개인 블로거 및 크리에이터 SEO 체크리스트에 세 시간을 소비하지 않고 매주 하나의 고품질 게시물을 게시하려는 분들. 오케스트레이터가 /blog write 한 번의 호출로 연구, 개요, 초안, 스키마, 내부 링크 및 인용 검증을 처리합니다.
마케팅 팀 및 에이전시 주제, 언어, 플랫폼에 걸쳐 많은 게시물을 관리하는 분들. 이 스킬은 주제 클러스터 계획(/blog cluster), 다국어 단일 명령 게시(/blog multilingual), 자기 잠식 탐지(/blog cannibalization), 페르소나 기반 음성 프로필(/blog persona)을 제공하므로 동일한 엔진이 팀 전체에서 일관된 콘텐츠를 생산합니다.
Claude Code 스킬 빌더 스킬 아키텍처, 에이전트 디스패치, 배달 계약, CI 게이팅에 대한 프로덕션급 참조를 원하는 분들. 이 저장소는 160개의 테스트, 버전 일관성 적용, 설치 프로그램 동기화 회귀 테스트, v1.9.0 5-게이트 계약 패턴을 갖춘 Tier 4 복잡성의 Agent Skills 개방형 표준을 보여줍니다. 영감을 위해 소스를 읽고 패턴을 자신의 스킬에 포크하세요.
claude-blog는 무엇을 생산하나요?
모든 초안은 단일 폴더에 8개의 아티팩트로 제공됩니다. .md 출력의 축소된 예시:
---
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)
.md와 함께 계약은 다음과 같은 것들도 생성합니다: 렌더링된 .html (XSS 안전 JSON-LD, 다크 모드 인식 CSS), .pdf (Playwright 또는 weasyprint), hero.<ext> (1200x630, Banana MCP, Gemini, 스톡 API, Openverse를 통해 생성), 3개의 뷰포트 스크린샷 (mobile-375.png, tablet-768.png, desktop-1280.png), review.md (BLOCKING 라인이 포함된 5개 카테고리 점수표), preflight-report.json (전체 감사 추적).
목차
- 데모
- 빠른 시작
- 명령어
- claude-blog는 어떻게 다른가요?
- 기능
- 배달 계약 (v1.9.0)
- 아키텍처
- 요구 사항
- 자주 묻는 질문
- 로드맵
- 제거
- 통합
- 문서
- 인용 방법
- 보안 및 행동 강령
- 기여
- 라이선스
- 관련 프로젝트
- 저자
데모
YouTube에서 데모 보기
<p align="center"> <img src="https://file.nanoskill.ai/blog-command-demo-7.gif" alt="claude-blog 명령 데모: 오케스트레이터를 통한 /blog 하위 명령 라우팅" width="100%"> </p>빠른 시작
ℹ️ 어떤 버전을 설치하시겠습니까?
- AI Marketing Hub Pro 회원이 아니신가요? 공개 저장소에서 설치하세요:
AgriciDaniel/claude-blog. 아래 모든 설치 명령이 거기서 작동합니다.AI-Marketing-Hub/claude-blog를AgriciDaniel/claude-blog로, 플러그인 슬러그claude-blog@ai-marketing-hub-claude-blog를claude-blog@agricidaniel-claude-blog로 바꾸기만 하면 됩니다. 공개 릴리스는 거기서 배포되고, 이 비공개 미러는 앞서 나갑니다.- Pro 회원이신가요? 아래 명령은 개발 중인 기능에 조기 액세스할 수 있는 커뮤니티 버전을 설치합니다.
gh auth login(또는 GitHub PAT) 세션을 통해AI-Marketing-Huborg에 접근할 수 있어야 합니다./plugin marketplace add가 404 오류로 실패하면 계정이 아직 org에 추가되지 않은 것입니다. Skool 커뮤니티에서 DM으로 추가 요청하세요.
플러그인 설치 (Claude Code 1.0.33+):
# 마켓플레이스 추가 (일회성)
/plugin marketplace add AI-Marketing-Hub/claude-blog
# 플러그인 설치
/plugin install claude-blog@ai-marketing-hub-claude-blog
권장: 클론, 확인 후 설치 (install.sh를 검사하고 릴리스 태그를 고정할 수 있음):
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0 # 릴리스 태그에 고정 (2026-05-18 기준 최신)
chmod +x install.sh && ./install.sh
한 줄 설치 (Unix/macOS):
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
한 줄 설치 (Windows PowerShell):
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
curl또는irm을 셸로 파이프하면 스크립트에 시스템 실행 권한이 부여됩니다. 클론 후 태그 체크아웃 방식이 더 안전합니다. 실행 내용을 검사할 수 있기 때문입니다. 두 방식 모두 기존gh auth/ GitHub 자격 증명을 사용하여 비공개 저장소에 인증합니다.
설치 프로그램 무결성 확인 (권장, VULN-IAC-001 강화):
# 다운로드, SHA-256 확인, 해시가 일치하면 실행.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04 install.sh" | sha256sum -c
bash install.sh
위 SHA-256은 현재 main의 HEAD에 있는 install.sh에 대한 것입니다. 실행 전 정규 파일과 대조 확인하세요. install.ps1의 해시는 6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98입니다. 이 해시는 설치 프로그램 변경 시마다 이 README에 업데이트됩니다.
설치 후 Claude Code를 다시 시작하여 활성화하세요.
명령어
<p align="center"> <img src="https://file.nanoskill.ai/blog-write-demo-9.gif" alt="claude-blog /blog write 데모: 5-게이트 배달 계약을 통한 엔드투엔드 기사 생성" width="100%"> </p> <p align="center"> <img src="https://file.nanoskill.ai/03-sub-skill-map-B-14.svg" alt="claude-blog 하위 스킬 생태계: 중앙에 오케스트레이터 허브가 있고 30개의 하위 스킬이 8개의 주제 클러스터(쓰기, 전략, 품질, AI 및 검색, 다국어, 연구, 미디어, 배포)로 구성됨; 패널 크기는 스킬 수에 따라 자동 조정됨" width="100%"> </p>🚀 처음이신가요? 다음 세 명령어를 먼저 시도해보세요: 블로그 범위를 지정하려면
/blog strategy <niche>, 첫 번째 기사를 생성하려면/blog write <topic>(5-게이트 계약이 자동으로 실행됨), 100점 기준으로 점수를 매기려면/blog analyze <file>.
| 명령 | 설명 |
|---|---|
/blog write <topic> | 새 블로그 게시물을 처음부터 작성합니다. |
/blog rewrite <file> | 기존 블로그 게시물을 최적화합니다. |
/blog analyze <file> | 0-100 점수로 품질 감사합니다. |
/blog brief <topic> | 상세 콘텐츠 브리프를 생성합니다. |
/blog calendar | 편집 달력을 생성합니다. |
/blog strategy <niche> | 블로그 전략 및 주제 발상 |
/blog outline <topic> | SERP 기반 콘텐츠 개요 |
/blog seo-check <file> | 게시 후 SEO 검증 |
/blog schema <file> | JSON-LD 스키마 마크업 생성 |
/blog repurpose <file> | 소셜, 이메일, YouTube용 재용도 |
/blog geo <file> | AI 인용 준비 감사 |
/blog image [generate|edit|setup] | Gemini를 통한 AI 이미지 생성 |
/blog audit [directory] | 전체 사이트 블로그 상태 평가 |
/blog cannibalization [directory] | 게시물 간 키워드 중복 탐지 |
/blog factcheck <file> | 인용된 출처에 대해 통계 검증 |
/blog persona [create|list|apply] | 글쓰기 페르소나 및 음성 프로필 관리 |
/blog taxonomy [sync|audit|suggest] | 태그/카테고리 CMS 관리 |
/blog notebooklm <question> | 소스 기반 연구를 위해 NotebookLM 쿼리 |
/blog audio [generate|voices|setup] | Gemini TTS를 통해 오디오 내레이션 생성 |
/blog google [command] [args] | Google API 데이터: PSI, CrUX, GSC, GA4, NLP, YouTube, 키워드 |
/blog cluster [plan|execute] <seed> | 시맨틱 주제 클러스터 계획 + 실행 (허브 앤 스포크) |
/blog multilingual <topic> --languages <codes> | 한 명령으로 작성, 번역, 로컬라이즈, hreflang 생성 |
/blog translate <file> --to <codes> | 형식 보존을 통한 SEO 최적화 번역 |
/blog localize <file> --locale <code> | 로케일별 문화적 심층 적응 |
/blog locale-audit <directory> | 다국어 콘텐츠 QA (완전성, hreflang, 패리티, 신선도) |
/blog flow [find|optimize|win|prompts|sync] | FLOW 프레임워크 프롬프트 (증거 주도, 30개의 블로그 적용 가능) |
/blog brand [init|show|update] | 모든 하위 스킬에 의해 자동 로드되는 BRAND.md + VOICE.md 컨텍스트 생성 |
/blog discourse <topic> | API 없는 최근 30일 담론 연구; DISCOURSE.md 생성 |
총 30개의 하위 스킬 디렉토리: 사용자 호출 가능 29개 (28개의 고유 슬래시 명령 + 재작성에 별칭이 지정된
/blog update) + 내부 전용 1개 (blog-chart, 인라인 SVG 차트를 위해 blog-write/blog-rewrite에 의해 호출됨).blog-image는 사용자 호출 가능하면서 내부적으로도 호출 가능.
claude-blog는 어떻게 다른가요?
claude-blog는 구조화된 파이프라인입니다. 직접 LLM 프롬프트는 일회성입니다. 호스팅된 SaaS 도구는 클로즈드 소스입니다. 정직한 트레이드오프 매트릭스는 다음과 같습니다:
| 기능 | claude-blog | 직접 Claude / ChatGPT 프롬프트 | Copy.ai / Jasper | 직접 구축 |
|---|---|---|---|---|
| 한 명령으로 반복 루프를 포함한 전체 기사 | ✅ (5-게이트 계약, 최대 3회 재시도) | ⚠️ 일회성 | ✅ | ❌ |
| 검증된 출처 통계 | ✅ /blog factcheck가 소스 URL을 가져옴 | ❌ 환각 | ❌ | ⚠️ 수동 |
| AI 인용 최적화 (GEO / AEO) | ✅ 전용 /blog geo 감사 | ❌ | ❌ | ⚠️ |
| 차단 콘텐츠 검토 (전달 시 점수 >= 90) | ✅ blog-reviewer 에이전트 | ❌ | ❌ | ❌ |
| 다국어 + hreflang 단일 명령 | ✅ /blog multilingual | ⚠️ hreflang 없음 | ⚠️ | ❌ |
| 주제 클러스터 계획 (허브 앤 스포크) | ✅ /blog cluster | ❌ | ⚠️ | ❌ |
| 오디오 내레이션 | ✅ Gemini TTS, 30개 음성 | ❌ | ❌ | ❌ |
| 히어로 이미지 생성 (4단계 래더) | ✅ Banana, Gemini, 스톡, Openverse | ❌ | ⚠️ 스톡만 | ⚠️ |
| 지속적인 브랜드 및 음성 컨텍스트 | ✅ BRAND.md + VOICE.md 자동 로드 | ❌ 프롬프트마다 | ⚠️ 제한적 | ❌ |
| 오픈소스, MIT, 사용 비용 없음 | ✅ 무료 | ❌ 구독 | ❌ 구독 | ✅ |
claude-blog가 모든 면에서 더 나은 것은 아닙니다. 일회성 초안에는 직접 프롬프트가 더 빠릅니다. 호스팅된 SaaS는 비개발자에게 더 쉽습니다. DIY는 고유한 파이프라인에 더 유연합니다. claude-blog는 SaaS 구독 없이 대규모 프로덕션급 콘텐츠를 원하는 경우에 적합합니다.
기능
12가지 콘텐츠 템플릿
주제와 의도에 따라 자동 선택됨: 방법 가이드, 리스티클, 사례 연구, 비교, 필러 페이지, 제품 리뷰, 사고 리더십, 라운드업, 튜토리얼, 뉴스 분석, 데이터 연구, FAQ 지식 베이스.
5개 카테고리 품질 점수 (100점)
| 카테고리 | 점수 | 초점 |
|---|---|---|
| 콘텐츠 품질 | 30 | 깊이, 가독성, 독창성, 참여도 |
| SEO 최적화 | 25 | 제목, 타이틀, 키워드, 링크, 메타 |
| E-E-A-T 신호 | 15 | 저자, 인용, 신뢰, 경험 |
| 기술 요소 | 15 | 스키마, 이미지, 속도, 모바일, OG 태그 |
| AI 인용 준비도 | 15 | 인용 가능성, Q&A 형식, 엔티티 명확성 |
점수 구간: 탁월 (90-100), 우수 (80-89), 허용 가능 (70-79), 기준 미달 (60-69), 재작성 (<60). v1.9.0 계약은 90점 미만의 전달을 차단합니다.
AI 콘텐츠 탐지
문장 길이 분산에 대한 버스티니스 점수, 알려진 AI 문구 탐지(17개 문구), 어휘 다양성(TTR). 검토자에게 도달하기 전에 기계 생성처럼 읽히는 콘텐츠에 플래그를 지정합니다.
페르소나 기반 글쓰기
NNGroup 4차원 톤 프레임워크(공식/캐주얼, 진지/재미, 존중/무례, 사실적/열정적)를 사용한 구성 가능한 글쓰기 페르소나. 블로그 또는 저자별 음성 프로필 관리, 가독성 대역(소비자, 전문가, 기술) 및 초안 시점 스타일 적용.
팩트체크 파이프라인
/blog factcheck는 인용된 모든 출처 URL을 가져와서 주장 신뢰도를 정확한 일치, 의역, 찾을 수 없음으로 점수를 매깁니다. 모든 데이터 포인트가 조작되지 않고 정확하고 추적 가능하도록 보장합니다.
키워드 자기 잠식 탐지
/blog cannibalization은 로컬 grep 분석 또는 DataForSEO API를 사용하여 블로그 게시물 간 키워드 중복을 식별합니다. 병합 또는 차별화 권장 사항이 포함된 심각도 점수로 게시물이 SERP에서 서로 경쟁하는 것을 방지합니다.
CMS 분류 관리
WordPress REST, Shopify GraphQL, Ghost, Strapi, Sanity를 지원하는 태그 및 카테고리 동기화. 태그 제안, 동기화 및 감사 워크플로가 포함됩니다.
이중 최적화
모든 기사는 Google 순위와 AI 인용 플랫폼 모두를 목표로 합니다:
- Google: 2025년 12월 Core Update 준수, E-E-A-T 신호, 스키마 마크업, 내부 링크, blog-google을 통한 Core Web Vitals 인식.
- AI 인용: 답변 우선 형식, 인용 캡슐, 구문 수준 인용 가능성(120-180 단어 블록), FAQ 스키마, 엔티티 명확성.
시각 미디어
- Pixabay, Unsplash, Pexels 이미지 소싱(HTTP 200 검증 및 자동 생성 대체 텍스트).
- Gemini를 통한 AI 이미지 생성(히어로 이미지, 인라인 일러스트레이션, 소셜 카드). 무료 Google AI API 키가 필요합니다.
- 7가지 스타일(막대, 그룹 막대, 막대사탕, 도넛, 선, 영역, 레이더)의 내장 SVG 차트 생성.
srcdoc지연 로딩 및 noscript AI 크롤러 폴백을 통한 YouTube 동영상 포함.- 콘텐츠 유형별로 보정된 이미지 밀도 목표.
Google API 통합 (v1.6.5+)
4개의 자격 증명 티어에 걸친 13개의 명령, 모두 일반 사용 시 무료:
- 티어 0 (API 키): PageSpeed Insights, CrUX Core Web Vitals(25주 기록), YouTube 동영상 검색, NLP 엔티티 분석.
- 티어 1 (OAuth): Search Console 성능, URL 검사, Indexing API.
- 티어 2 (GA4): 유기적 트래픽 보고서.
- 티어 3 (Ads): Google Ads 키워드 플래너.
NotebookLM 연구
사용자가 업로드한 문서에서 소스 기반 연구를 위해 Google NotebookLM을 쿼리합니다. 답변이 업로드된 문서에서 추출되므로 환각 위험이 전혀 없는 티어 1 데이터 품질.
오디오 내레이션
/blog audio는 Gemini TTS를 통해 오디오 내레이션을 생성합니다. 세 가지 모드: 요약(200-300 단어), 전체 기사, 두 화자 대화. 30개 음성, 80개 이상 언어.
플랫폼 지원
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby, 정적 HTML.
기초 방법론 (v1.8.0)
skills/blog/references/ 아래의 5개 참조 문서가 모든 하위 스킬에 적용되는 편집 및 연구 방법론을 정의합니다. 오케스트레이터에 의해 필요 시 로드됩니다:
| 참조 | 목적 | 사용처 |
|---|---|---|
ai-slop-detection.md | 2단계 1차(문구) + 2차(구조적 리듬) AI 콘텐츠 탐지 | blog-rewrite, blog-reviewer, blog-analyze |
editorial-heuristics.md | 0-4점 점수가 있는 10가지 Nielsen 적용 휴리스틱 + P0-P3 심각도 태그 | blog-analyze --rubric |
cognitive-load.md | 섹션별 개념 밀도(엔티티, 숫자, 전문 용어, 전방 참조, 절 깊이) | blog-analyze --cognitive-load, scripts/cognitive_load.py |
research-quality.md | 5차원 연구 루브릭 + 4가지 사전 비행 키워드 트랩 클래스 + 신선도 하한선 | blog-researcher, blog-discourse, blog-brief, blog-strategy |
synthesis-contract.md | 연구 합성을 지배하는 6가지 법칙(후행 Sources 블록 없음, 인라인 인용 등) | 모든 연구 합성 하위 스킬 |
pbakaus/impeccable(Apache 2.0) 및 mvanhorn/last30days-skill(MIT)에서 적용. 저작자 표시는 CONTRIBUTORS.md를 참조하세요.
FLOW 프레임워크
FLOW 프레임워크(찾기, 활용, 최적화, 획득)는 AgriciDaniel/flow와 공유되는 증거 주도 워크플로입니다(CC BY 4.0). 각 단계는 오케스트레이터 파이프라인에 프롬프트를 제공하며, /blog flow는 단계별로 인덱싱된 30개의 즉시 실행 가능한 프롬프트를 노출합니다.
배달 계약 (v1.9.0)
<p align="center"> <img src="https://file.nanoskill.ai/02-pipeline-A-17.svg" alt="5-게이트 블로그 배달 계약 파이프라인: 기능 탐색, 형식 완전성, 시각적 검증, 콘텐츠 검토(차단 게이트, 점수는 90점 이상이어야 하며 P0 문제 없음), 자산 및 링크 무결성. 실패 시 최대 3회 반복 후 사용자에게 에스컬레이션" width="100%"> </p>모든 블로그는 사용자에게 표시되기 전에 5-게이트 계약을 통과합니다. 사용자는 결코 첫 번째 검토자가 아닙니다. 게이트가 그 역할을 합니다.
| 게이트 | 적용 사항 | 구현 |
|---|---|---|
| 1. 기능 탐색 | 작성 전 필요한 도구 및 에이전트 존재 여부 | scripts/blog_preflight.py --gate 1 |
| 2. 형식 완전성 | .md + .html + .pdf + 실제 히어로 이미지 | scripts/blog_render.py, scripts/generate_hero.py |
| 3. 시각적 검증 | SVG 오버플로우 없음, 유효한 JSON-LD, 다크 모드 올바르게 렌더링 | 3가지 뷰포트 너비에서 patchright / playwright |
| 4. 콘텐츠 검토 (차단) | blog-reviewer 점수 90+ 및 P0 문제 없음 | agents/blog-reviewer.md (차단, v1.9.0) |
| 5. 자산 + 링크 무결성 | 모든 이미지가 해결되고, og:image가 존재하며, 링크가 200을 반환하고, wordCount가 5% 이내 | scripts/blog_preflight.py --gate 5 |
히어로 이미지 래더: Banana MCP, 직접 Gemini API, 프리미엄 스톡(Unsplash, Pexels, Pixabay), Openverse 공개 API. 먼저 사용 가능한 것이 우선합니다. 게이트 실패 시 최대 3회 차단 및 반복 후 사용자에게 에스컬레이션합니다. 전체 사양: skills/blog/references/blog-delivery-contract.md.
아키텍처
<p align="center"> <img src="https://file.nanoskill.ai/01-architecture-B-16.svg" alt="claude-blog 시스템 아키텍처: 사용자 명령에서 오케스트레이터 라우팅, 하위 스킬 실행, 에이전트 디스패치를 거쳐 사용자에게 도달하기 전 5-게이트 배달 계약에 이르는 왼쪽에서 오른쪽 파이프라인" width="100%"> </p>claude-blog는 하나의 오케스트레이터와 29개의 하위 스킬, 5개의 에이전트, 21개의 참조, 12개의 템플릿, 9개의 루트 레벨 스크립트로 구성됩니다. 오케스트레이터는 사용자 명령을 하위 스킬로 라우팅하고, 하위 스킬은 에이전트를 생성하고 Bash를 통해 스크립트를 호출합니다.
| 계층 | 개수 | 위치 |
|---|---|---|
| 하위 스킬 (사용자 호출 가능) | 29 | skills/blog-*/SKILL.md |
| 하위 스킬 (내부) | 1 | skills/blog-chart/SKILL.md |
| 특수 에이전트 | 5 | agents/blog-*.md |
| 온디맨드 참조 | 21 | skills/blog/references/*.md |
| 콘텐츠 템플릿 | 12 | skills/blog/templates/*.md |
| 루트 레벨 Python 스크립트 | 9 | scripts/*.py |
| 테스트 | 160 | tests/test_*.py |
전체 디렉토리 트리, 데이터 흐름 다이어그램, 점수 방법론 및 확장 지점: docs/ARCHITECTURE.md.
요구 사항
- Claude Code CLI 설치 및 구성됨.
- Python 3.11+ (품질 점수, 5-게이트 배달 계약 실행기, 린트용).
- 선택 사항: 고급 분석(가독성 점수, 스키마 감지)을 위한
pip install -r requirements.txt.
품질 게이트 (모든 PR에 CI 적용)
- pytest: 보안, 동작, 회귀, 배달 계약 제품군에 걸친 160개 테스트.
- 플러그인 유효성 검사:
claude plugin validate .및 수동 JSON/정규식 검사. - 오래된 경로 린트:
references/및templates/상호 참조의 변경 사항을 포착합니다. - 문체 위생:
scripts/lint_prose.py(펜스 인식, 백틱 인식)이 CONTRIBUTING.md의 em-dash, en-dash,--사용 금지 규칙을 적용합니다. - 버전 일관성:
tests/test_version_coherence.py가pyproject.toml,plugin.json,CITATION.cff,skills/blog/SKILL.md프런트매터가 모두 일치하는지 확인합니다. - 명령 일관성:
tests/test_command_coherence.py가skills/blog/SKILL.md와docs/COMMANDS.md가 동일한 명령 세트를 선언하는지 확인합니다.
푸시 전에 로컬에서 실행:
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
자주 묻는 질문
claude-blog란 무엇인가요?
claude-blog는 블로그 콘텐츠를 작성, 최적화 및 감사하기 위한 Claude Code 스킬 모음입니다. 30개의 하위 스킬과 5개의 에이전트가 5-게이트 배달 계약을 통해 실행되어 모든 기사가 사용자에게 도달하기 전에 90/100 품질 기준을 충족하도록 합니다.
claude-blog는 Claude나 ChatGPT에 직접 프롬프트하는 것과 어떻게 다른가요?
직접 프롬프트는 하나의 프롬프트에서 하나의 초안을 제공합니다. claude-blog는 구조화된 파이프라인을 제공합니다: 출처가 있는 통계 연구, 개요 승인, 초안 생성, 다중 패스 품질 점수, AI 콘텐츠 탐지, 사실 검증, 스키마 주입, 전달 전 최대 3회 반복하는 차단 검토. 이 스킬은 시니어 편집자가 수동으로 하는 작업을 강제합니다.
claude-blog를 사용하려면 AI Marketing Hub Pro 멤버십이 필요한가요?
아니오. AgriciDaniel/claude-blog의 공개 오픈소스 버전은 MIT 라이선스이며 Claude Code를 사용하는 모든 사람에게 무료입니다. AI-Marketing-Hub/claude-blog의 비공개 미러는 개발 중인 기능에 조기 액세스하고 커뮤니티와 직접 협업하려는 Pro 회원을 위한 것입니다.
claude-blog는 어떤 블로그 플랫폼을 지원하나요?
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby 및 정적 HTML. 오케스트레이터는 프로젝트 신호에서 플랫폼을 자동 감지하고 그에 따라 프런트매터, 이미지 포함 및 스키마 주입을 조정합니다.
claude-blog는 통계를 환각하나요?
아니오. 인용된 모든 통계는 /blog factcheck를 통과하며, 이는 소스 URL을 가져와서 주장 신뢰도(정확한 일치, 의역, 찾을 수 없음)를 점수로 매깁니다. blog-reviewer 에이전트는 인용을 확인할 수 없거나 AI 콘텐츠 탐지가 문장을 기계 생성으로 표시하면 게시를 차단합니다.
5-게이트 블로그 배달 계약이란 무엇인가요?
모든 초안에서 실행되는 코드 강제 프리젠테이션 전 파이프라인: 기능 탐색, 형식 완전성, 3가지 뷰포트 너비에서의 시각적 검증, 콘텐츠 검토(차단; 점수 90+ 및 P0 없음), 자산 + 링크 무결성. 오케스트레이터는 게이트 실패 시 최대 3회 작성자를 반복 실행한 후 사용자에게 에스컬레이션합니다. 전체 사양: skills/blog/references/blog-delivery-contract.md.
여러 언어로 claude-blog를 사용할 수 있나요?
예. /blog multilingual <topic> --languages en,de,fr,es,ja는 게시물을 작성하고, 프런트매터와 스키마를 보존하면서 번역하며, 로케일별 문화적 심층 적응을 실행하고, 단일 명령으로 hreflang 태그와 CMS 준비 언어 맵을 생성합니다.
학술 작업에서 claude-blog를 어떻게 인용하나요?
아래 인용 방법 섹션 또는 저장소 루트의 CITATION.cff 파일을 참조하세요. GitHub는 공개 미러 페이지의 "이 저장소 인용" 버튼을 통해 구조화된 인용 파일을 표시합니다.
claude-blog는 설치해도 안전한가요?
설치 프로그램은 Python 스크립트와 마크다운 파일만 제공하며, pip install -r requirements.txt가 가져오는 것 외에 원격 코드를 실행하지 않으며, 모든 변경 사항에 대해 프로젝트 SECURITY.md 정책에 따라 검토됩니다. 클론 후 태그 체크아웃 설치 흐름을 통해 실행 전에 install.sh를 검사할 수 있습니다. 전체 위협 모델은 SECURITY.md를 참조하세요.
로드맵
<p align="center"> <img src="https://file.nanoskill.ai/05-roadmap-A-15.svg" alt="claude-blog 웨이브 로드맵(수평 타임라인): v1.6.0 기반 (2026년 3월), v1.7.0 FLOW 프레임워크 (2026년 4월), v1.8.0 무결점 방법론 (2026년 5월), v1.9.0 배달 계약 (현재, 2026년 5월), v2.0.0 다중 CMS 게시 (2026년 3분기), v3.0.0 코드로서의 블로그 (2027년 1분기)" width="100%"> </p>v1.9.1 (다음)
- v1.9.0 감사 잔여 문제를 해결하기 위해
blog_render와blog_preflight간에 공유되는_count_body_words(html)함수. generate_hero.py종료 코드 의미: 이미지 생성 경로가 없을 때 0이 아닌 값 반환 (현재는 종료 0으로 JSON 오류 반환).- 오케스트레이터가 3번의 검토자 차단 후 4번이 아닌 에스컬레이션하는지 확인하는 반복 루프 범위 테스트.
- 나머지 문서(CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO)에서 v1.x 계층의 잔여 변경 사항을 점검합니다.
v1.10 (비전)
- DataForSEO를 통해 작성 중 라이브 SERP 기반 개요 개선.
- 구성 전반(BRAND.md 존재 여부, 페르소나 변형, 다국어 모드)에 걸쳐 블로그 품질을 측정하는 평가 하네스.
- 코드 강제 반복 카운터 (현재 오케스트레이터 지침; 스크립트 수준으로 승격).
v2.0 (장기)
- 헤드리스 미리보기 서버 통합: 5-게이트 계약이 로컬 HTML 대신 실제 도메인 미리보기에 대해 실행됩니다.
- 플랫폼별 CMS 게시 커넥터(WordPress, Ghost, Sanity)와 재작성 시 멱등성 재게시.
- 실시간 AI 인용 추적 대시보드(어떤 게시물이 ChatGPT, Perplexity, AI Overviews에 인용되는지; 가시성 히트맵).
제안하거나 투표하고 싶은 것이 있다면 roadmap 라벨로 이슈를 열어주세요.
제거
Unix/macOS:
chmod +x uninstall.sh && ./uninstall.sh
Windows (PowerShell):
.\uninstall.ps1
통합
차트 생성 및 YouTube 동영상 포함이 내장되어 있습니다. Google API 데이터에는 무료 API 키가 필요합니다 (/blog google setup 참조).
선택적 컴패니언 스킬 (게시된 페이지의 심층 분석):
| 스킬 | 통합 |
|---|---|
/seo | 게시된 블로그 페이지의 심층 SEO 분석 |
/seo-schema | 스키마 마크업 유효성 검사 및 생성 |
/seo-geo | AI 인용 최적화 감사 |
/seo-google | Google API 데이터 (blog-google과 설정 공유) |
문서
자세한 문서는 docs/에 있습니다:
- 설치 가이드: Unix, macOS, Windows, 수동 설치.
- 명령 참조: 예제가 포함된 전체 명령 참조.
- 아키텍처: 시스템 설계 및 구성 요소 개요.
- 게시 워크플로: 비공개에서 공개로의 릴리스 흐름 (Pro 유지 관리자용).
- 템플릿: 템플릿 참조 및 사용자 정의.
- 문제 해결: 일반적인 문제 및 해결 방법.
- MCP 통합: 선택적 MCP 서버 설정.
인용 방법
연구 또는 프로덕션에서 claude-blog를 사용하는 경우 프로젝트를 인용해 주세요:
@software{Agrici_claude_blog_2026,
author = {Agrici, Daniel},
title = {claude-blog: AI Blog Writing and SEO Optimization Skill for Claude Code},
year = {2026},
url = {https://github.com/AgriciDaniel/claude-blog},
version = {1.9.0},
license = {MIT}
}
GitHub는 또한 공개 미러 페이지의 "이 저장소 인용"을 통해 구조화된 CITATION.cff 파일을 표시합니다.
보안 및 행동 강령
- 보안 정책 + 위협 모델:
SECURITY.md. v1.8.x 강화 패스로 모든 알려진 발견 사항을 해결했습니다; v1.9.0은 XSS 안전 JSON-LD, O_NOFOLLOW 심링크 거부, 프런트매터 유효성 검사를 추가했으며 이 모든 것은 돌연변이 테스트로 검증되었습니다. 취약점을 비공개로 보고하려면SECURITY.md의 공개 절차를 따르세요. - 행동 강령:
CODE_OF_CONDUCT.md. Contributor Covenant. 서로에게 탁월함을 보여주세요.
기여
기여를 환영합니다. 가이드라인은 CONTRIBUTING.md를 참조하세요. PR을 열기 전에:
python -m pytest tests/실행 (160개 모두 통과해야 함).python3 scripts/lint_prose.py --root .실행 (위반 없음).claude plugin validate .실행 (통과해야 함).- 사용자에게 표시되는 개수나 동작을 변경하는 경우 일관되게 버전을 올리세요 (
docs/PUBLISHING.md참조).
라이선스
MIT 라이선스. 자세한 내용은 LICENSE를 참조하세요.
관련 프로젝트
- Rankenstein: GUI 기반 콘텐츠 게시 워크플로; 한 플랫폼에서 연구에서 게시까지.
- FLOW 프레임워크: 증거 주도 찾기, 최적화, 획득 프롬프트(CC BY 4.0).
/blog flow를 통해 하위 스킬로 통합됨. - Claude Ads 및 Claude SEO: 동일한 브랜드 키트를 공유하는 형제 스킬(브랜드 오렌지 팔레트로 생성된 배너 + 다이어그램).
- AI Marketing Hub: 무료 커뮤니티, 2,800명 이상의 회원. Pro 티어
ai-marketing-hub-pro에서 이 스킬의 비공개 미러를 호스팅합니다.
스타 기록
<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> <img alt="GitHub에서 AgriciDaniel/claude-blog의 스타 기록" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" /> </picture> </a>claude-blog가 시간을 절약해 준다면, 공개 저장소에 스타를 눌러주시는 것이 감사를 표하는 가장 쉬운 방법입니다(다른 콘텐츠 담당자들이 찾는 데에도 도움이 됩니다).
저자
Daniel Agrici, AI 워크플로 아키텍트가 Claude Code로 구축했습니다.
- 블로그: AI 마케팅 자동화 심층 분석.
- YouTube: 튜토리얼 및 데모.
- 모든 오픈소스 도구: 기타 Claude Code 스킬.
- AI Marketing Hub: AI 기반 마케팅을 위한 무료 커뮤니티.


