$npx -y skills add AgriciDaniel/claude-blog --skill blog-writeWrite new blog articles from scratch optimized for Google rankings and AI citations. Generates full articles with template selection, answer-first formatting, Key Takeaways summary box, information gain markers, citation capsules, sourced statistics, Pixabay/Unsplash images, buil
| 1 | # Blog Writer: New Article Generation |
| 2 | |
| 3 | Writes complete blog articles from a topic, brief, or outline. Every article |
| 4 | follows the 6 pillars of dual optimization (Google rankings + AI citations). |
| 5 | |
| 6 | **Key references** (paths relative to repo root; references live in the |
| 7 | main `blog` skill's references directory, not in `blog-write/`): |
| 8 | |
| 9 | - `skills/blog/references/synthesis-contract.md`: 6 LAWs for synthesis output (v1.8.0; applies whenever the article embeds research-synthesis prose) |
| 10 | - `skills/blog/references/content-templates.md`: Template selection guide and usage |
| 11 | - `skills/blog/references/quality-scoring.md`: 5-category scoring (Content 30, SEO 25, E-E-A-T 15, Technical 15, AI Citation 15) |
| 12 | - `skills/blog/references/eeat-signals.md`: Experience, expertise, authority, trust markers |
| 13 | - `skills/blog/references/internal-linking.md`: Linking strategy and anchor text rules |
| 14 | - `skills/blog/references/visual-media.md`: Image sourcing and chart styling |
| 15 | |
| 16 | ## Workflow |
| 17 | |
| 18 | ### Phase 0: Surface Targeting (do this BEFORE research) |
| 19 | |
| 20 | Decide which of the FLOW 5 surfaces this post is meant to win. The choice |
| 21 | shapes structure, length, citation density, and call-to-action. The 5 surfaces |
| 22 | in 2026: |
| 23 | |
| 24 | 1. Owned site (organic Google ranking) |
| 25 | 2. SERP including AI Overviews |
| 26 | 3. AI assistant citations (ChatGPT, Perplexity, Claude, Gemini, Copilot, You.com) |
| 27 | 4. Local pack (out of scope for blog content; use claude-seo for local) |
| 28 | 5. Communities and video (Reddit, YouTube, LinkedIn, Quora, niche forums) |
| 29 | |
| 30 | Most posts target surfaces 1, 2, and 3 by default. If the same query also |
| 31 | surfaces in a community (Reddit thread, YouTube comment), apply dual-surface |
| 32 | thinking: optimize the post for extraction AND plan a community echo (covered |
| 33 | in `/blog repurpose`). |
| 34 | |
| 35 | For a deeper surface-by-surface workflow, see |
| 36 | `skills/blog/references/flow-alignment.md` and `/blog flow find`. |
| 37 | |
| 38 | ### Phase 1: Topic Understanding |
| 39 | |
| 40 | 1. **Clarify the topic** - If the user provides just a topic, ask: |
| 41 | - Target audience (who is this for?) |
| 42 | - Primary keyword / search intent |
| 43 | - Desired word count (default: 2,000-2,500 words) |
| 44 | - Platform/format (MDX, markdown, HTML - auto-detect if in a project) |
| 45 | 2. **If a brief exists** - Load it and skip to Phase 1.5 |
| 46 | |
| 47 | ### Phase 1.5: Template Selection |
| 48 | |
| 49 | Select the appropriate content template from the 12 templates in |
| 50 | `skills/blog/templates/` (the main `blog` skill owns the templates directory). |
| 51 | |
| 52 | 1. **Auto-detect content type** from the topic and search intent: |
| 53 | | Signal | Template | |
| 54 | |--------|----------| |
| 55 | | "How to...", process, steps | `how-to-guide` | |
| 56 | | "Best X", "Top N", list format | `listicle` | |
| 57 | | Client result, before/after, metrics | `case-study` | |
| 58 | | "X vs Y", comparison, alternatives | `comparison` | |
| 59 | | Broad topic, comprehensive guide | `pillar-page` | |
| 60 | | "Is X worth it", product evaluation | `product-review` | |
| 61 | | Opinion, prediction, industry take | `thought-leadership` | |
| 62 | | Expert quotes, multi-source collection | `roundup` | |
| 63 | | Code walkthrough, tool demo, technical | `tutorial` | |
| 64 | | Breaking news, algorithm update, event | `news-analysis` | |
| 65 | | Survey results, experiment, original data | `data-research` | |
| 66 | | Q&A, knowledge base, "What is X" | `faq-knowledge` | |
| 67 | |
| 68 | 2. **Load the matching template**: Read from `skills/blog/templates/<type>.md` |
| 69 | 3. **Adapt the outline** - Use the template's section structure, heading patterns, |
| 70 | and word count guidance to shape Phase 3's outline |
| 71 | 4. **Fallback** - If no template clearly fits, use the generic outline structure |
| 72 | in Phase 3 below. Inform the user which template was selected (or that none matched). |
| 73 | |
| 74 | See `skills/blog/references/content-templates.md` for detailed selection criteria and intent mapping. |
| 75 | |
| 76 | ### Phase 2: Research |
| 77 | |
| 78 | Spawn a `blog-researcher` agent (or do inline research with WebSearch): |
| 79 | |
| 80 | 1. **Find 8-12 current statistics** (2025-2026 data preferred) |
| 81 | - Search: `[topic] study 2025 2026 data statistics` |
| 82 | - Prioritize tier 1-3 sources (see `skills/blog/references/quality-scoring.md`) |
| 83 | - Record: statistic, source name, URL, date, methodology |
| 84 | 2. **Find a cover image** (wide, high-quality, topic-relevant): |
| 85 | - Search: `site:pixabay.com [topic] wide banner` (preferred) |
| 86 | - Alternative: `site:unsplash.com [topic] wide` |
| 87 | - Fallback: `site:pexels.com [topic] wide banner` |
| 88 | - Target dimensions: 1200x630 (OG-compatible) or 192 |