Blog -- Content Engine for Rankings & AI Citations
Full-lifecycle blog management: strategy, briefs, outlines, writing, analysis,
optimization, schema generation, repurposing, and editorial planning. Dual-optimized
for Google's December 2025 Core Update and AI citation platforms (ChatGPT,
Perplexity, Google AI Overviews, Gemini).
Quick Reference
| Command |
What it does |
/blog write <topic> |
Write a new blog post from scratch |
/blog rewrite <file> |
Rewrite/optimize an existing blog post |
/blog analyze <file-or-url> |
Audit blog quality with 0-100 score |
/blog brief <topic> |
Generate a detailed content brief |
/blog calendar [monthly|quarterly] |
Generate an editorial calendar |
/blog strategy <niche> |
Blog strategy and topic ideation |
/blog outline <topic> |
Generate SERP-informed content outline |
/blog seo-check <file> |
Post-writing SEO validation checklist |
/blog schema <file> |
Generate JSON-LD schema markup |
/blog repurpose <file> |
Repurpose content for other platforms |
/blog geo <file> |
AI citation readiness audit |
/blog audit [directory] |
Full-site blog health assessment |
/blog update <file> |
Update existing post with fresh stats (routes to rewrite) |
Orchestration Logic
Command Routing
- Parse the user's command to determine the sub-skill
- If no sub-command given, ask which action they need
- Route to the appropriate sub-skill:
write → blog-write (new articles from scratch)rewrite → blog-rewrite (optimize existing posts)analyze → blog-analyze (quality scoring)brief → blog-brief (content briefs)calendar / plan → blog-calendar (editorial calendars)strategy / ideation → blog-strategy (positioning and topics)outline → blog-outline (SERP-informed outlines)seo-check / seo → blog-seo-check (SEO validation)schema → blog-schema (JSON-LD generation)repurpose → blog-repurpose (cross-platform content)geo / aeo / citation → blog-geo (AI citation audit)audit / health → blog-audit (site-wide assessment)update → blog-rewrite (with freshness-update mode)
Platform Detection
Detect blog platform from file extension and project structure:
| Signal |
Platform |
Format |
.mdx files, next.config |
Next.js/MDX |
JSX-compatible markdown |
.md files, hugo.toml |
Hugo |
Standard markdown |
.md files, _config.yml |
Jekyll |
Standard markdown with YAML front matter |
.html files |
Static HTML |
HTML with semantic markup |
wp-content/ directory |
WordPress |
HTML or Gutenberg blocks |
ghost/ or Ghost API |
Ghost |
Mobiledoc or HTML |
.astro files |
Astro |
MDX or markdown |
.njk files, .eleventy.js |
11ty |
Nunjucks/Markdown |
gatsby-config.js |
Gatsby |
MDX/React |
Adapt output format to detected platform. Default to standard markdown if unknown.
Core Methodology -- The 6 Pillars
Every blog post targets these 6 optimization pillars:
| Pillar |
Impact |
Implementation |
| Answer-First Formatting |
+340% AI citations |
Every H2 opens with 40-60 word stat-rich paragraph |
| Real Sourced Data |
E-E-A-T trust |
Tier 1-3 sources only, inline attribution |
| Visual Media |
Engagement + citations |
Pixabay/Unsplash images + built-in SVG chart generation |
| FAQ Schema |
+28% AI citations |
Structured FAQ with 40-60 word answers |
| Content Structure |
AI extractability |
50-150 word chunks, question headings, proper H hierarchy |
| Freshness Signals |
76% of top citations |
Updated within 30 days, dateModified schema |
Quality Gates
These are hard rules. Never ship content that violates them:
| Rule |
Threshold |
Action |
| Fabricated statistics |
Zero tolerance |
Every number must have a named source |
| Paragraph length |
Never > 150 words |
Split or trim |
| Heading hierarchy |
Never skip levels |
H1 → H2 → H3 only |
| Source tier |
Tier 1-3 only |
Never cite content mills or affiliate sites |
| Image alt text |
Required on all images |
Descriptive, includes topic keywords naturally |
| Self-promotion |
Max 1 brand mention |
Author bio context only |
| Chart diversity |
No duplicate types |
Each chart must be a different type |
Scoring Methodology
Blog quality is scored across 5 categories (100 points total):
| Category |
Weight |
What it measures |
| Content Quality |
30 pts |
Depth, readability (Flesch 60-70), originality, structure, engagement, grammar/anti-pattern |
| SEO Optimization |
25 pts |
Heading hierarchy, title tag, keyword placement, internal linking, meta description |
| E-E-A-T Signals |
15 pts |
Author attribution, source citations, trust indicators, experience signals |
| Technical Elements |
15 pts |
Schema markup, image optimization, page speed, mobile-friendliness, OG meta |
| AI Citation Readiness |
15 pts |
Passage citability, Q&A format, entity clarity, AI crawler accessibility |
Scoring Bands
| Score |
Rating |
Action |
| 90-100 |
Exceptional |
Publish as-is, flagship content |
| 80-89 |
Strong |
Minor polish, ready for publication |
| 70-79 |
Acceptable |
Targeted improvements needed |
| 60-69 |
Below Standard |
Significant rework required |
| < 60 |
Rewrite |
Fundamental issues, start from outline |
Reference Files
Load on-demand as needed (12 references):
references/google-landscape-2026.md -- December 2025 Core Update, E-E-A-T, algorithm changesreferences/geo-optimization.md -- GEO/AEO techniques, AI citation factorsreferences/content-rules.md -- Structure, readability, answer-first formattingreferences/visual-media.md -- Image sourcing (Pixabay, Unsplash, Pexels) + SVG chart integrationreferences/quality-scoring.md -- Full 5-category scoring checklist (100 points)references/platform-guides.md -- Platform-specific output formatting (9 platforms)references/distribution-playbook.md -- Content distribution strategy (Reddit, YouTube, LinkedIn, etc.)references/content-templates.md -- Content type template index (12 templates)references/eeat-signals.md -- Author E-E-A-T requirements, Person schema, experience markersreferences/ai-crawler-guide.md -- AI bot management, robots.txt, SSR requirementsreferences/schema-stack.md -- Complete blog schema reference (JSON-LD templates)references/internal-linking.md -- Link architecture, anchor text, hub-and-spoke model
Content Templates
12 structural templates for different content types. Auto-selected by blog-write and blog-brief:
| Template |
Type |
Word Count |
how-to-guide |
Step-by-step tutorials |
2,000-2,500 |
listicle |
Ranked/numbered lists |
1,500-2,000 |
case-study |
Real-world results with metrics |
1,500-2,000 |
comparison |
X vs Y with feature matrix |
1,500-2,000 |
pillar-page |
Comprehensive authority guide |
3,000-4,000 |
product-review |
First-hand product assessment |
1,500-2,000 |
thought-leadership |
Opinion/analysis with contrarian angle |
1,500-2,500 |
roundup |
Expert quotes + curated resources |
1,500-2,000 |
tutorial |
Code/tool walkthrough |
2,000-3,000 |
news-analysis |
Timely event analysis |
800-1,200 |
data-research |
Original data study |
2,000-3,000 |
faq-knowledge |
Comprehensive FAQ/knowledge base |
1,500-2,000 |
Templates are in templates/ and contain section structure, markers, and checklists.
Sub-Skills
| Sub-Skill |
Purpose |
blog-write |
Write new blog articles with template selection, TL;DR, citation capsules |
blog-rewrite |
Optimize existing posts with AI detection, anti-AI patterns |
blog-analyze |
5-category 100-point quality audit with AI content detection |
blog-brief |
Content briefs with template recommendation, distribution plan |
blog-calendar |
Editorial calendars with decay detection, 60/30/10 content mix |
blog-strategy |
Positioning, topic clusters, AI citation surface strategy |
blog-outline |
SERP-informed outlines with competitive gap analysis |
blog-seo-check |
Post-writing SEO validation (title, meta, headings, links, OG) |
blog-schema |
JSON-LD schema generation (BlogPosting, Person, FAQ, Breadcrumb) |
blog-repurpose |
Cross-platform repurposing (social, email, YouTube, Reddit) |
blog-geo |
AI citation readiness audit with 0-100 GEO score |
blog-audit |
Full-site blog health assessment with parallel subagents |
blog-chart |
Generate inline SVG data visualization charts with dark-mode styling |
Agents
| Agent |
Role |
blog-researcher |
Research specialist -- finds statistics, sources, images, competitive data |
blog-writer |
Content generation specialist -- writes optimized blog content |
blog-seo |
SEO validation specialist -- checks on-page SEO post-writing |
blog-reviewer |
Quality assessment -- runs 100-point scoring, AI content detection |
Agent Details
blog-researcher: Runs as a Task subagent. Uses WebSearch to find current statistics,
competitor content, and SERP analysis. Outputs structured research packets with source
tier classifications (Tier 1: primary research, Tier 2: major publications, Tier 3:
reputable industry sources). Also sources Pixabay/Unsplash/Pexels image URLs.
blog-writer: Receives research packets and content briefs. Writes content using the
selected template structure. Applies answer-first formatting, citation capsules, and
TL;DR blocks. Outputs platform-formatted content ready for the SEO agent.
blog-seo: Post-writing validation agent. Checks title tag length (50-60 chars),
meta description (150-160 chars), heading hierarchy, keyword density, internal link
count, image alt text, and Open Graph meta tags. Returns pass/fail checklist.
blog-reviewer: Final quality gate. Runs the full 5-category 100-point scoring
rubric. Detects AI-generated content patterns (repetitive sentence starters, hedge
words, over-qualification). Outputs a scorecard with category breakdowns and
prioritized improvement recommendations.
Execution Flow
Standard execution order for /blog write:
- Parse -- Identify topic, detect platform, select template
- Research -- Spawn
blog-researcher agent for statistics, sources, SERP data
- Outline -- Build section structure from template + research gaps
- Write -- Spawn
blog-writer agent with research packet and outline
- Optimize -- Spawn
blog-seo agent for on-page validation
- Score -- Spawn
blog-reviewer agent for 100-point quality audit
- Deliver -- Output final content with scorecard and improvement notes
For /blog analyze, only steps 1 and 6 run (read + score).
For /blog audit, step 6 runs in parallel across all posts in the directory.
Internal Workflows (Not User-Facing Commands)
The blog-chart sub-skill is invoked internally by blog-write and blog-rewrite
when chart-worthy data is identified. It is not a standalone slash command.
Users do not need to call it directly.
Integration
Chart generation is built-in — no external dependencies required for full functionality.
Optional companion skills (for deeper analysis of published pages):
/seo — Full SEO audit of published blog pages/seo-schema — Schema markup validation and generation/seo-geo — AI citation optimization audit
Anti-Patterns (Never Do These)
| Anti-Pattern |
Why |
| Fabricate statistics |
December 2025 Core Update penalizes unsourced claims |
| Use the same chart type twice |
Visual monotony, reduces engagement |
| Keyword-stuff headings or meta |
Google ignores/penalizes this |
| Bury answers in paragraphs |
AI systems extract from section openers |
| Skip source verification |
Broken links and wrong data destroy trust |
| Use tier 4-5 sources |
Low authority hurts E-E-A-T |
| Generate without research |
AI-generated consensus content is penalized |
| Skip visual elements entirely |
Blogs with images get 94% more views |
1---2name: blog3description: Full-lifecycle blog engine with 12 commands, 12 content templates, 5-category 100-point scoring, and 4 specialized agents. Optimized for Google rankings (December 2025 Core Update, E-E-A-T) and AI citations (GEO/AEO). Writes, rewrites, analyzes, outlines, audits, and repurposes blog content with answer-first formatting, sourced statistics, Pixabay/Unsplash/Pexels images, built-in SVG chart generation, JSON-LD schema generation, and freshness signals. Supports any platform (WordPress, Next.js MDX, Hugo, Ghost, Astro, Jekyll, 11ty, Gatsby, HTML). Use when user says "blog", "write blog", "blog post", "blog strategy", "content brief", "editorial calendar", "analyze blog", "rewrite blog", "update blog", "blog SEO", "blog optimization", "content plan", "blog outline", "seo check", "schema markup", "repurpose", "geo audit", "blog audit", "citation readiness".4---56# Blog -- Content Engine for Rankings & AI Citations78Full-lifecycle blog management: strategy, briefs, outlines, writing, analysis,9optimization, schema generation, repurposing, and editorial planning. Dual-optimized10for Google's December 2025 Core Update and AI citation platforms (ChatGPT,11Perplexity, Google AI Overviews, Gemini).1213## Quick Reference1415| Command | What it does |16|---------|-------------|17| `/blog write <topic>` | Write a new blog post from scratch |18| `/blog rewrite <file>` | Rewrite/optimize an existing blog post |19| `/blog analyze <file-or-url>` | Audit blog quality with 0-100 score |20| `/blog brief <topic>` | Generate a detailed content brief |21| `/blog calendar [monthly\|quarterly]` | Generate an editorial calendar |22| `/blog strategy <niche>` | Blog strategy and topic ideation |23| `/blog outline <topic>` | Generate SERP-informed content outline |24| `/blog seo-check <file>` | Post-writing SEO validation checklist |25| `/blog schema <file>` | Generate JSON-LD schema markup |26| `/blog repurpose <file>` | Repurpose content for other platforms |27| `/blog geo <file>` | AI citation readiness audit |28| `/blog audit [directory]` | Full-site blog health assessment |29| `/blog update <file>` | Update existing post with fresh stats (routes to rewrite) |3031## Orchestration Logic3233### Command Routing34351. Parse the user's command to determine the sub-skill362. If no sub-command given, ask which action they need373. Route to the appropriate sub-skill:38 - `write` → `blog-write` (new articles from scratch)39 - `rewrite` → `blog-rewrite` (optimize existing posts)40 - `analyze` → `blog-analyze` (quality scoring)41 - `brief` → `blog-brief` (content briefs)42 - `calendar` / `plan` → `blog-calendar` (editorial calendars)43 - `strategy` / `ideation` → `blog-strategy` (positioning and topics)44 - `outline` → `blog-outline` (SERP-informed outlines)45 - `seo-check` / `seo` → `blog-seo-check` (SEO validation)46 - `schema` → `blog-schema` (JSON-LD generation)47 - `repurpose` → `blog-repurpose` (cross-platform content)48 - `geo` / `aeo` / `citation` → `blog-geo` (AI citation audit)49 - `audit` / `health` → `blog-audit` (site-wide assessment)50 - `update` → `blog-rewrite` (with freshness-update mode)5152### Platform Detection5354Detect blog platform from file extension and project structure:5556| Signal | Platform | Format |57|--------|----------|--------|58| `.mdx` files, `next.config` | Next.js/MDX | JSX-compatible markdown |59| `.md` files, `hugo.toml` | Hugo | Standard markdown |60| `.md` files, `_config.yml` | Jekyll | Standard markdown with YAML front matter |61| `.html` files | Static HTML | HTML with semantic markup |62| `wp-content/` directory | WordPress | HTML or Gutenberg blocks |63| `ghost/` or Ghost API | Ghost | Mobiledoc or HTML |64| `.astro` files | Astro | MDX or markdown |65| `.njk` files, `.eleventy.js` | 11ty | Nunjucks/Markdown |66| `gatsby-config.js` | Gatsby | MDX/React |6768Adapt output format to detected platform. Default to standard markdown if unknown.6970## Core Methodology -- The 6 Pillars7172Every blog post targets these 6 optimization pillars:7374| Pillar | Impact | Implementation |75|--------|--------|---------------|76| Answer-First Formatting | +340% AI citations | Every H2 opens with 40-60 word stat-rich paragraph |77| Real Sourced Data | E-E-A-T trust | Tier 1-3 sources only, inline attribution |78| Visual Media | Engagement + citations | Pixabay/Unsplash images + built-in SVG chart generation |79| FAQ Schema | +28% AI citations | Structured FAQ with 40-60 word answers |80| Content Structure | AI extractability | 50-150 word chunks, question headings, proper H hierarchy |81| Freshness Signals | 76% of top citations | Updated within 30 days, dateModified schema |8283## Quality Gates8485These are hard rules. Never ship content that violates them:8687| Rule | Threshold | Action |88|------|-----------|--------|89| Fabricated statistics | Zero tolerance | Every number must have a named source |90| Paragraph length | Never > 150 words | Split or trim |91| Heading hierarchy | Never skip levels | H1 → H2 → H3 only |92| Source tier | Tier 1-3 only | Never cite content mills or affiliate sites |93| Image alt text | Required on all images | Descriptive, includes topic keywords naturally |94| Self-promotion | Max 1 brand mention | Author bio context only |95| Chart diversity | No duplicate types | Each chart must be a different type |9697## Scoring Methodology9899Blog quality is scored across 5 categories (100 points total):100101| Category | Weight | What it measures |102|----------|--------|-----------------|103| Content Quality | 30 pts | Depth, readability (Flesch 60-70), originality, structure, engagement, grammar/anti-pattern |104| SEO Optimization | 25 pts | Heading hierarchy, title tag, keyword placement, internal linking, meta description |105| E-E-A-T Signals | 15 pts | Author attribution, source citations, trust indicators, experience signals |106| Technical Elements | 15 pts | Schema markup, image optimization, page speed, mobile-friendliness, OG meta |107| AI Citation Readiness | 15 pts | Passage citability, Q&A format, entity clarity, AI crawler accessibility |108109### Scoring Bands110111| Score | Rating | Action |112|-------|--------|--------|113| 90-100 | Exceptional | Publish as-is, flagship content |114| 80-89 | Strong | Minor polish, ready for publication |115| 70-79 | Acceptable | Targeted improvements needed |116| 60-69 | Below Standard | Significant rework required |117| < 60 | Rewrite | Fundamental issues, start from outline |118119## Reference Files120121Load on-demand as needed (12 references):122123- `references/google-landscape-2026.md` -- December 2025 Core Update, E-E-A-T, algorithm changes124- `references/geo-optimization.md` -- GEO/AEO techniques, AI citation factors125- `references/content-rules.md` -- Structure, readability, answer-first formatting126- `references/visual-media.md` -- Image sourcing (Pixabay, Unsplash, Pexels) + SVG chart integration127- `references/quality-scoring.md` -- Full 5-category scoring checklist (100 points)128- `references/platform-guides.md` -- Platform-specific output formatting (9 platforms)129- `references/distribution-playbook.md` -- Content distribution strategy (Reddit, YouTube, LinkedIn, etc.)130- `references/content-templates.md` -- Content type template index (12 templates)131- `references/eeat-signals.md` -- Author E-E-A-T requirements, Person schema, experience markers132- `references/ai-crawler-guide.md` -- AI bot management, robots.txt, SSR requirements133- `references/schema-stack.md` -- Complete blog schema reference (JSON-LD templates)134- `references/internal-linking.md` -- Link architecture, anchor text, hub-and-spoke model135136## Content Templates13713812 structural templates for different content types. Auto-selected by `blog-write` and `blog-brief`:139140| Template | Type | Word Count |141|----------|------|-----------|142| `how-to-guide` | Step-by-step tutorials | 2,000-2,500 |143| `listicle` | Ranked/numbered lists | 1,500-2,000 |144| `case-study` | Real-world results with metrics | 1,500-2,000 |145| `comparison` | X vs Y with feature matrix | 1,500-2,000 |146| `pillar-page` | Comprehensive authority guide | 3,000-4,000 |147| `product-review` | First-hand product assessment | 1,500-2,000 |148| `thought-leadership` | Opinion/analysis with contrarian angle | 1,500-2,500 |149| `roundup` | Expert quotes + curated resources | 1,500-2,000 |150| `tutorial` | Code/tool walkthrough | 2,000-3,000 |151| `news-analysis` | Timely event analysis | 800-1,200 |152| `data-research` | Original data study | 2,000-3,000 |153| `faq-knowledge` | Comprehensive FAQ/knowledge base | 1,500-2,000 |154155Templates are in `templates/` and contain section structure, markers, and checklists.156157## Sub-Skills158159| Sub-Skill | Purpose |160|-----------|---------|161| `blog-write` | Write new blog articles with template selection, TL;DR, citation capsules |162| `blog-rewrite` | Optimize existing posts with AI detection, anti-AI patterns |163| `blog-analyze` | 5-category 100-point quality audit with AI content detection |164| `blog-brief` | Content briefs with template recommendation, distribution plan |165| `blog-calendar` | Editorial calendars with decay detection, 60/30/10 content mix |166| `blog-strategy` | Positioning, topic clusters, AI citation surface strategy |167| `blog-outline` | SERP-informed outlines with competitive gap analysis |168| `blog-seo-check` | Post-writing SEO validation (title, meta, headings, links, OG) |169| `blog-schema` | JSON-LD schema generation (BlogPosting, Person, FAQ, Breadcrumb) |170| `blog-repurpose` | Cross-platform repurposing (social, email, YouTube, Reddit) |171| `blog-geo` | AI citation readiness audit with 0-100 GEO score |172| `blog-audit` | Full-site blog health assessment with parallel subagents |173| `blog-chart` | Generate inline SVG data visualization charts with dark-mode styling |174175## Agents176177| Agent | Role |178|-------|------|179| `blog-researcher` | Research specialist -- finds statistics, sources, images, competitive data |180| `blog-writer` | Content generation specialist -- writes optimized blog content |181| `blog-seo` | SEO validation specialist -- checks on-page SEO post-writing |182| `blog-reviewer` | Quality assessment -- runs 100-point scoring, AI content detection |183184### Agent Details185186**blog-researcher**: Runs as a Task subagent. Uses WebSearch to find current statistics,187competitor content, and SERP analysis. Outputs structured research packets with source188tier classifications (Tier 1: primary research, Tier 2: major publications, Tier 3:189reputable industry sources). Also sources Pixabay/Unsplash/Pexels image URLs.190191**blog-writer**: Receives research packets and content briefs. Writes content using the192selected template structure. Applies answer-first formatting, citation capsules, and193TL;DR blocks. Outputs platform-formatted content ready for the SEO agent.194195**blog-seo**: Post-writing validation agent. Checks title tag length (50-60 chars),196meta description (150-160 chars), heading hierarchy, keyword density, internal link197count, image alt text, and Open Graph meta tags. Returns pass/fail checklist.198199**blog-reviewer**: Final quality gate. Runs the full 5-category 100-point scoring200rubric. Detects AI-generated content patterns (repetitive sentence starters, hedge201words, over-qualification). Outputs a scorecard with category breakdowns and202prioritized improvement recommendations.203204## Execution Flow205206Standard execution order for `/blog write`:2072081. **Parse** -- Identify topic, detect platform, select template2092. **Research** -- Spawn `blog-researcher` agent for statistics, sources, SERP data2103. **Outline** -- Build section structure from template + research gaps2114. **Write** -- Spawn `blog-writer` agent with research packet and outline2125. **Optimize** -- Spawn `blog-seo` agent for on-page validation2136. **Score** -- Spawn `blog-reviewer` agent for 100-point quality audit2147. **Deliver** -- Output final content with scorecard and improvement notes215216For `/blog analyze`, only steps 1 and 6 run (read + score).217For `/blog audit`, step 6 runs in parallel across all posts in the directory.218219### Internal Workflows (Not User-Facing Commands)220221The `blog-chart` sub-skill is invoked internally by `blog-write` and `blog-rewrite`222when chart-worthy data is identified. It is not a standalone slash command.223Users do not need to call it directly.224225## Integration226227Chart generation is built-in — no external dependencies required for full functionality.228229**Optional companion skills** (for deeper analysis of published pages):230- `/seo` — Full SEO audit of published blog pages231- `/seo-schema` — Schema markup validation and generation232- `/seo-geo` — AI citation optimization audit233234## Anti-Patterns (Never Do These)235236| Anti-Pattern | Why |237|-------------|-----|238| Fabricate statistics | December 2025 Core Update penalizes unsourced claims |239| Use the same chart type twice | Visual monotony, reduces engagement |240| Keyword-stuff headings or meta | Google ignores/penalizes this |241| Bury answers in paragraphs | AI systems extract from section openers |242| Skip source verification | Broken links and wrong data destroy trust |243| Use tier 4-5 sources | Low authority hurts E-E-A-T |244| Generate without research | AI-generated consensus content is penalized |245| Skip visual elements entirely | Blogs with images get 94% more views |
smixs