# Claude Blog

Free, open-source AI blog writing skill for Claude Code.

## What It Is

Claude Blog is a Claude Code skill ecosystem for creating, scoring, and optimizing blog content at scale. It ships 30 sub-skills, 5 specialized AI agents, 30 commands, 12 content templates, and 15 reference guides. Every blog post is dual-optimized for Google rankings (December 2025 Core Update) and AI citation platforms (ChatGPT, Perplexity, Google AI Overviews, Bing Copilot).

## Install

### Plugin marketplace (recommended, Claude Code 1.0.33+)
```
/plugin marketplace add AgriciDaniel/claude-blog
/plugin install claude-blog@AgriciDaniel-claude-blog
```

### Manual (Unix, macOS, Linux)
```bash
git clone --depth 1 https://github.com/AgriciDaniel/claude-blog.git && bash claude-blog/install.sh
```

### Windows (PowerShell 5.1+)
```powershell
git clone https://github.com/AgriciDaniel/claude-blog.git
powershell -ExecutionPolicy Bypass -File claude-blog\install.ps1
```

Requires Python 3.11+ and Claude Code CLI 1.0.33+.

## The 5-Agent Pipeline

When you type `/blog write`, five AI agents process your post in sequence:

1. **Researcher** — Finds current statistics, verifies sources against Tier 1-3 quality standards, discovers images from Pixabay, Unsplash, and Pexels.
2. **Writer** — Drafts the full article using a selected content template with answer-first formatting and proper heading hierarchy.
3. **SEO** — Validates on-page elements post-writing: title tag, meta description, heading keywords, internal links, schema markup, OG tags. Pass/fail checklist.
4. **Translator** (NEW v1.7.0) — Produces native-quality translations with format preservation for markdown, MDX, HTML, frontmatter, schema, and inline SVG. Locale-correct number, date, currency, and quote formatting.
5. **Reviewer** — Scores the post on a 100-point scale across 5 categories. Flags AI-content signals. Suggests specific improvements by severity.

## 12 Content Templates

- How-to guide (2,000-2,500 words)
- Listicle (1,500-2,000)
- Case study (1,500-2,000)
- Comparison (1,500-2,000)
- Pillar page (3,000-4,000)
- Product review (1,500-2,000)
- Thought leadership (1,500-2,000)
- Roundup (1,500-2,000)
- Tutorial (2,000-2,500)
- News analysis (1,500-2,000)
- Data research (2,000-3,000)
- FAQ knowledge base (1,000-1,500)

## 100-Point Scoring System

| Category | Points | Focus |
|----------|--------|-------|
| Content Quality | 30 | Depth, readability, originality, engagement |
| SEO Optimization | 25 | Headings, title, keywords, links, meta |
| E-E-A-T Signals | 15 | Author, citations, trust, experience |
| Technical Elements | 15 | Schema, images, speed, mobile, OG tags |
| AI Citation Readiness | 15 | Citability, Q&A format, entity clarity |

Scoring bands: Exceptional (90-100), Strong (80-89), Acceptable (70-79), Below Standard (60-69), Rewrite (under 60).

## 30 Commands

| Command | What it does |
|---------|-------------|
| `/blog write <topic>` | Write new blog post from scratch |
| `/blog rewrite <file>` | Optimize and refresh an existing post |
| `/blog analyze <file>` | Quality audit with 0-100 score |
| `/blog brief <topic>` | Generate detailed content brief |
| `/blog calendar [monthly\|quarterly]` | Editorial calendar |
| `/blog strategy <niche>` | Blog strategy with topic ideation |
| `/blog outline <topic>` | SERP-informed content outline |
| `/blog seo-check <file>` | Post-writing SEO validation |
| `/blog schema <file>` | JSON-LD schema generation |
| `/blog repurpose <file>` | Repurpose for social, email, YouTube, newsletters |
| `/blog geo <file>` | AI citation readiness audit |
| `/blog audit [directory]` | Full-site blog health assessment |
| `/blog cannibalization [directory]` | Detect keyword overlap across posts |
| `/blog factcheck <file>` | Verify statistics against cited sources |
| `/blog image [generate\|edit\|setup]` | AI image generation via Gemini |
| `/blog persona [create\|list\|apply]` | Writing persona management (NNGroup 4-dimension tone) |
| `/blog taxonomy [sync\|audit\|suggest]` | CMS tag/category sync (WordPress, Shopify, Ghost, Strapi, Sanity) |
| `/blog notebooklm <question>` | Source-grounded research via NotebookLM |
| `/blog audio [generate\|voices\|setup]` | Audio narration via Gemini TTS (30 voices, 80+ languages) |
| `/blog google [command] [args]` | Google APIs (PageSpeed, CrUX, GSC, GA4, YouTube, NLP, Keywords) - 13 commands, 4 credential tiers |
| `/blog cluster [plan\|execute] <seed>` | Semantic topic-cluster planning + execution (community) |
| `/blog multilingual <topic> --languages <codes>` | One-command international publishing (community) |
| `/blog translate <file> --to <codes>` | SEO-optimized translation (community) |
| `/blog localize <file> --locale <code>` | Cultural deep-adaptation: DACH, FR, ES, JA, custom (community) |
| `/blog locale-audit <directory>` | Multilingual QA: completeness, hreflang, meta parity, freshness (community) |
| `/blog flow [find\|optimize\|win\|prompts\|sync]` | FLOW framework prompts (30 evidence-led prompts, CC BY 4.0) |
| `/blog brand [init\|show\|update]` | Durable BRAND.md + VOICE.md editorial context auto-loaded by all sub-skills |
| `/blog chart` | Inline SVG data charts: 7 types, dark-mode, accessible, source-attributed |
| `/blog discourse <topic>` | API-free 30-day discourse research (Reddit, X, YouTube, Hacker News) |
| `/blog update <file>` | Refresh post with current statistics |

## Major New Features (v1.6.5 to v1.9.1)

| Version | Headline |
|---------|----------|
| **1.9.1** (2026-05-20) | Security hardening + 5-gate Blog Delivery Contract. 95/100 security audit; frontmatter and quality gates enforced pre-publish. |
| **1.9.0** (2026-05) | Blog Delivery Contract: a 5-gate pre-publish quality system. The user is never the first reviewer. |
| **1.8.0** (2026-05) | `blog-brand` (durable BRAND.md + VOICE.md context), `blog-chart` (inline SVG data charts), and `blog-discourse` (API-free 30-day research) added. |
| **1.7.1** (2026-04-27) | Security audit + remediation arc. CRITICAL VULN-001 (API key exposure) closed, OAuth CSRF protection, hash-pinned dependencies across 4 lockfiles, PowerShell 5.1 compatibility fix, frontmatter completeness enforcement. |
| **1.7.0** (2026-04-27) | Pro Hub Challenge community release. 5 community skills integrated: `blog-cluster` (Lutfiya Miller, semantic topic clustering), `blog-multilingual` + `blog-translate` + `blog-localize` + `blog-locale-audit` (Chris Mueller, multilingual publishing suite). FLOW framework integration with 30 evidence-led prompts (CC BY 4.0). `blog-translator` agent added. |
| **1.6.8** (2026-04-08) | Hotfix: NotebookLM credential handling improvements. |
| **1.6.7** (2026-04-08) | Hotfix: Image generation credential management. |
| **1.6.5** | Google APIs skill (`blog-google`): 13 commands across PageSpeed, CrUX, GSC, GA4, YouTube, NLP, Keywords. 4-tier credential system (API key, OAuth/SA, GA4, Ads). |

## Industry Detection

Claude Blog auto-detects your content type from topic signals:

- **Tutorial / how-to**: step-by-step guide template
- **Comparison**: feature matrix template (X vs Y)
- **News / analysis**: news analysis template with context layer
- **Product review**: review template with pros/cons matrix
- **Pillar page**: comprehensive authority template

Recommendations adapt to your specific content type.

## Companion Skills

Claude Blog works alongside, not against, these specialized skills:

- [Claude SEO](https://claude-seo.md/) - SEO analysis, schema validation, GEO/AEO audit, Google APIs sharing config with `blog-google`
- [Claude Banana](https://github.com/AgriciDaniel/banana-claude) - AI image generation via Gemini

## Community Contributions

Five skills landed in v1.7.0 via the AI Marketing Hub Pro Hub Challenge. See [CONTRIBUTORS.md](https://github.com/AgriciDaniel/claude-blog/blob/main/CONTRIBUTORS.md) for full credits.

| Contributor | Submission | Integrated as |
|------------|-----------|---------------|
| **Lutfiya Miller** (Pro Hub Challenge Winner) | Semantic Cluster Engine | `blog-cluster` |
| **Chris Mueller** | Multilingual blog suite | `blog-multilingual` + `blog-translate` + `blog-localize` + `blog-locale-audit` + `blog-translator` agent |

## Numbers

- 833+ GitHub stars
- 173 forks
- 14,116 YouTube demo views
- 275 YouTube likes
- 30 sub-skills
- 5 agents (Researcher, Writer, SEO, Translator, Reviewer)
- 30 commands
- 12 content templates
- 15 reference guides
- 100-point quality scoring across 5 categories
- 80+ languages supported (TTS, translation)
- 30 TTS voices (Gemini)
- MIT licensed; CC BY 4.0 for FLOW prompts
- $0 forever

## Links

- Website: https://claude-blog.md
- Repository: https://github.com/AgriciDaniel/claude-blog
- YouTube demo: https://www.youtube.com/watch?v=AeLC4iutG8w
- Author: https://github.com/AgriciDaniel
- Skool community: https://www.skool.com/ai-marketing-hub

## License

MIT for skill code. CC BY 4.0 for bundled FLOW prompts. Free forever. No paid tiers.