SEO contentGitHub source
Article Command
/articleA unified content creation process for producing complete, SEO-optimized articles through a
// skill content
Article Command A unified content creation pipeline that produces comprehensive, SEO-optimized articles through mandatory research, strategic planning, and section-by-section writing. ## Usage /article [topic] Examples: - /article "Best Project Management Tools for Small Teams" - /article "Content Marketing Strategy Guide 2025" - /article "How to Migrate from Competitor to Your Product" ## What This Command Does Creates high-quality articles by enforcing a 4-step pipeline where research is mandatory, not optional: `` STEP 1: SERP Analysis → See what Google rewards TODAY STEP 2: Social Research → Mine Reddit + YouTube for real insights STEP 3: Article Planning → Section-by-section strategy STEP 4: Section Writing → Write/edit each section individually ` This prevents the "AI knows everything" trap that produces generic content matching competitors instead of beating them. ## When to Use This vs /write | Scenario | Command | |----------|---------| | Comprehensive new article | /article | | Competitive topics | /article | | Topics where you need to beat existing content | /article | | Quick drafts from existing research | /write | | Simple updates to existing content | /write | --- ## STEP 1: SERP Analysis (MANDATORY) **You MUST research before writing. No exceptions.** ### Process 1. **Search the Target Keyword** Use WebSearch to find what's currently ranking: ` WebSearch: "[topic] industry" OR "[topic] industrying" ` 2. **Analyze Top 5 Ranking Articles** For each top-ranking article, use WebFetch and document: | Element | What to Capture | |---------|-----------------| | **Structure** | H2 headings, section order, content type | | **Word Count** | Approximate length | | **Gaps** | Topics covered superficially (<150 words) | | **Missing Angles** | Perspectives not addressed | | **Unsupported Claims** | Statements without data/sources | | **Outdated Info** | Old statistics, deprecated tools | | **What They Do Well** | Strong sections to match | 3. **Build Competitor Gap Blueprint** Document opportunities where your brand content can beat, not match: - Gaps found in all competitors (must-fill) - Unique angles no one covers - Data needed to be more specific - Outdated info to update with 2025 data ### Output Save to: research/serp-analysis-[topic-slug]-[YYYY-MM-DD].md `markdown # SERP Analysis: [Topic] **Date**: [YYYY-MM-DD] **Keyword**: [target keyword] **Search Intent**: [informational/commercial/transactional] ## Top Ranking Articles ### 1. [Article Title] - [Domain] - URL: [url] - Word Count: ~[count] - Structure: [H2 headings list] - Strengths: [what they do well] - Gaps: [what they miss] - Outdated: [old info found] [Repeat for top 5] ## Google-Validated Structure Based on what's ranking, these sections appear essential: 1. [Common H2 found across multiple articles] 2. [Another common section] ... ## Competitor Gap Blueprint ### MUST-FILL GAPS (found in 3+ competitors) - [Gap 1]: [How to address] - [Gap 2]: [How to address] ### DIFFERENTIATION OPPORTUNITIES - [Unique angle 1] - [Unique angle 2] ### DATA NEEDED - [Specific statistic to find] - [Expert quote needed] ### OUTDATED INFO TO UPDATE - [Old stat] → Need 2025 version ` --- ## STEP 2: Social Research (MANDATORY) **The best insights aren't in SEO content - they're in Reddit threads and YouTube tutorials.** ### Reddit Research (Visit 5 Actual Threads) 1. **Search Reddit** ` WebSearch: site:reddit.com [topic] industry WebSearch: site:reddit.com r/industrying [topic] ` 2. **Visit 5 Promising Threads** Use WebFetch on each thread URL. Extract: | Element | What to Look For | |---------|------------------| | **OP's Question** | The specific problem/question | | **Top Comments** | Upvoted solutions and advice | | **Pain Points** | Frustrations users express | | **Success Stories** | Real outcomes with details | | **Debates** | Different perspectives | | **Recommendations** | What the community endorses | | **Real Language** | How actual users talk about this | 3. **Extract Quotable Insights** Pull specific quotes that can inform (or be used in) the article. ### YouTube Research (Analyze 5 Videos) 1. **Search YouTube** ` WebSearch: site:youtube.com [topic] industry tutorial WebSearch: site:youtube.com [topic] industry review ` 2. **Analyze 5 Video Pages** Use WebFetch on each video page. Extract: | Element | What to Look For | |---------|------------------| | **Title & Description** | What they cover | | **View Count** | Engagement signal | | **Topics Covered** | Main points discussed | | **Gaps** | What they don't cover well | | **Comments** | What viewers ask about | ### Output Save to: research/social-research-[topic-slug]-[YYYY-MM-DD].md ``markdown # Social Research: [Topic] Date: [YYYY-MM
// original public source
TheCraigHewitt/seomachine/.claude/commands/article.md
License: MIT License
Independent project, not affiliated with Anthropic. This skill remains the property of its original author.