claude-blog is a Claude Code skill ecosystem for creating, optimizing, and managing blog content at scale. It generates complete articles, briefs, calendars, and schemas — dual-optimized for Google rankings and AI citation platforms (ChatGPT, Perplexity, AI Overviews).
- Demo
- Quick Start
- Commands
- Features
- Architecture
- Requirements
- Uninstall
- Integration
- Documentation
- Contributing
- License
One-command install (Unix/macOS):
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/install.sh | bashOr clone and install manually:
git clone https://github.com/AgriciDaniel/claude-blog.git
cd claude-blog
chmod +x install.sh && ./install.shWindows (PowerShell):
.\install.ps1Restart Claude Code after installation to activate.
| Command | Description |
|---|---|
/blog write <topic> |
Write a new blog post from scratch |
/blog rewrite <file> |
Optimize an existing blog post |
/blog analyze <file> |
Quality audit with 0-100 score |
/blog brief <topic> |
Generate a detailed content brief |
/blog calendar |
Generate an editorial calendar |
/blog strategy <niche> |
Blog strategy and topic ideation |
/blog outline <topic> |
SERP-informed content outline |
/blog seo-check <file> |
Post-writing SEO validation |
/blog schema <file> |
Generate JSON-LD schema markup |
/blog repurpose <file> |
Repurpose for social, email, YouTube |
/blog geo <file> |
AI citation readiness audit |
/blog image [generate|edit|setup] |
AI image generation via Gemini |
/blog audit [directory] |
Full-site blog health assessment |
15 sub-skills total: 13 user-facing commands above +
blog-chart(internal SVG generation) +blog-image(also callable internally by write/rewrite).
Auto-selected based on topic and intent: how-to guide, listicle, case study, comparison, pillar page, product review, thought leadership, roundup, tutorial, news analysis, data research, FAQ knowledge base.
| 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 (<60).
Burstiness scoring, known AI phrase detection (17 phrases), vocabulary diversity analysis (TTR). Flags content that reads as AI-generated.
Every article targets both Google rankings and AI citation platforms:
- Google: December 2025 Core Update compliance, E-E-A-T, schema markup, internal linking
- AI Citations: Answer-first formatting (+340% citations), citation capsules, passage-level citability, FAQ schema (+28% citations)
- Pixabay/Unsplash/Pexels image sourcing with alt text
- AI image generation via Gemini (hero images, inline illustrations, social cards) — optional, requires free Google AI API key
- Built-in SVG chart generation (bar, grouped bar, lollipop, donut, line, area, radar)
- Image density targets by content type
- Image URL verification (HTTP 200 check before embedding)
Next.js/MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby, and static HTML.
claude-blog/
├── .claude-plugin/
│ └── plugin.json # Plugin metadata (name, description, author)
├── skills/
│ ├── blog/ # Main orchestrator
│ │ ├── SKILL.md # Routes all 12 commands
│ │ ├── references/ # 12 on-demand reference docs
│ │ └── templates/ # 12 content type templates
│ ├── blog-write/SKILL.md # Sub-skills (12 user-facing + 1 internal)
│ ├── blog-rewrite/SKILL.md
│ ├── blog-analyze/SKILL.md
│ ├── blog-brief/SKILL.md
│ ├── blog-calendar/SKILL.md
│ ├── blog-strategy/SKILL.md
│ ├── blog-outline/SKILL.md
│ ├── blog-seo-check/SKILL.md
│ ├── blog-schema/SKILL.md
│ ├── blog-repurpose/SKILL.md
│ ├── blog-geo/SKILL.md
│ ├── blog-audit/SKILL.md
│ ├── blog-chart/SKILL.md # Internal: SVG chart generation
│ └── blog-image/ # AI image generation via Gemini
│ ├── SKILL.md
│ ├── references/ # 3 reference docs (models, tools, prompts)
│ └── scripts/ # MCP setup and validation scripts
├── agents/ # 4 specialized agents
│ ├── blog-researcher.md
│ ├── blog-writer.md
│ ├── blog-seo.md
│ └── blog-reviewer.md
├── scripts/
│ └── analyze_blog.py # Python quality analysis (5-category scoring)
├── tests/ # pytest test suite
│ ├── conftest.py
│ └── test_analyze_blog.py
├── docs/ # 6 documentation files
├── .github/workflows/ci.yml # CI pipeline
├── install.sh # Unix/macOS installer (fallback)
├── install.ps1 # Windows PowerShell installer
├── pyproject.toml # Python project config
├── requirements.txt # Python dependencies
├── CONTRIBUTING.md
├── CHANGELOG.md
├── LICENSE
└── README.md
- Claude Code CLI installed and configured
- Python 3.11+ (for
analyze_blog.pyquality scoring script) - Optional:
pip install -r requirements.txtfor advanced analysis (readability scoring, schema detection)
Unix/macOS:
chmod +x uninstall.sh && ./uninstall.shWindows (PowerShell):
.\uninstall.ps1Chart generation is built-in — no external dependencies required for full functionality.
Optional companion skills (for deeper analysis of published pages):
| Skill | Integration |
|---|---|
/seo |
Deep SEO analysis of published blog pages |
/seo-schema |
Schema markup validation and generation |
/seo-geo |
AI citation optimization audit |
Detailed documentation is available in docs/:
- Installation Guide -- Unix, macOS, Windows, manual install
- Command Reference -- Full 12-command reference with examples
- Architecture -- System design and component overview
- Templates -- Template reference and customization
- Troubleshooting -- Common issues and fixes
- MCP Integration -- Optional MCP server setup
Contributions welcome! See CONTRIBUTING.md for guidelines.
MIT License. See LICENSE for details.
Built by AgriciDaniel with Claude Code.