$npx -y skills add norahe0304-art/30x-seo --skill 30x-seo-content-briefGenerate content briefs by analyzing top-ranking SERP results. Extracts common topics, identifies content gaps, and creates actionable briefs for content-writer. Input: target keyword. Output: content brief with must-cover topics + gap opportunities.
| 1 | # Content Brief Generator |
| 2 | |
| 3 | > SERP Analysis → Content Brief → Outrank Competition |
| 4 | |
| 5 | ## Goal |
| 6 | |
| 7 | **Not rewriting competitors, but analyzing them to write better content.** |
| 8 | |
| 9 | | Wrong Approach | Right Approach | |
| 10 | |----------------|----------------| |
| 11 | | Rewrite Top 10 articles | Analyze Top 10 intent | |
| 12 | | Copy content structure | Find gaps (what they missed) | |
| 13 | | Merge competitor content | Outperform (add original data/cases) | |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | ## Workflow |
| 18 | |
| 19 | ### Step 1: SERP Scraping |
| 20 | |
| 21 | ``` |
| 22 | Input: Target keyword |
| 23 | ↓ |
| 24 | Scrape Top 10 results: |
| 25 | - Title |
| 26 | - URL |
| 27 | - Meta description |
| 28 | - Page content (H1, H2, H3 structure) |
| 29 | - Word count |
| 30 | - Content type (listicle, how-to, guide, comparison, etc.) |
| 31 | ``` |
| 32 | |
| 33 | ### Step 2: Intent Analysis |
| 34 | |
| 35 | | Dimension | Description | |
| 36 | |-----------|-------------| |
| 37 | | **Search Intent** | Informational / Commercial / Transactional / Navigational | |
| 38 | | **Content Format** | 90% are listicles? You should write a listicle too | |
| 39 | | **Content Depth** | Average word count? Exceed the average | |
| 40 | | **SERP Features** | Featured Snippet? PAA? Video? | |
| 41 | |
| 42 | ### Step 3: Topic Extraction |
| 43 | |
| 44 | Extract common topics covered by Top 10: |
| 45 | |
| 46 | ``` |
| 47 | Example keyword: "how to start a podcast" |
| 48 | |
| 49 | Top 10 coverage: |
| 50 | ✓ Equipment selection (10/10) |
| 51 | ✓ Recording software (9/10) |
| 52 | ✓ Hosting platforms (8/10) |
| 53 | ✓ Cover design (7/10) |
| 54 | ✓ Promotion strategy (6/10) |
| 55 | ``` |
| 56 | |
| 57 | **Rule**: Topics covered by >50% = must include |
| 58 | |
| 59 | ### Step 4: Gap Analysis |
| 60 | |
| 61 | Find content competitors **don't cover** or **cover poorly**: |
| 62 | |
| 63 | ``` |
| 64 | Gap opportunities: |
| 65 | - 2024 AI tool recommendations (only 2/10 mention) |
| 66 | - Monetization strategies (most skim over) |
| 67 | - Real cost breakdown (no specific numbers) |
| 68 | - Common failure reasons (few cover negative angle) |
| 69 | ``` |
| 70 | |
| 71 | **Rule**: Gaps = your differentiation opportunity |
| 72 | |
| 73 | ### Step 5: Brief Generation |
| 74 | |
| 75 | --- |
| 76 | |
| 77 | ## Output Format: Content Brief |
| 78 | |
| 79 | ```markdown |
| 80 | # Content Brief: [Target Keyword] |
| 81 | |
| 82 | ## Search Intent |
| 83 | [Informational/Commercial/etc.] - [One sentence describing what users want] |
| 84 | |
| 85 | ## Content Format |
| 86 | Recommended: [Listicle / How-to Guide / Comparison / etc.] |
| 87 | Reason: X/10 of Top 10 use this format |
| 88 | |
| 89 | ## Target Word Count |
| 90 | Minimum: [Top 10 average word count] |
| 91 | Recommended: [Average + 20%] to outperform competition |
| 92 | |
| 93 | ## Must-Have Topics |
| 94 | |
| 95 | | Topic | Coverage | Suggested Depth | |
| 96 | |-------|----------|-----------------| |
| 97 | | [Topic 1] | 10/10 | Detailed | |
| 98 | | [Topic 2] | 9/10 | Detailed | |
| 99 | | [Topic 3] | 8/10 | Medium | |
| 100 | |
| 101 | ## Gap Opportunities (Differentiators) |
| 102 | |
| 103 | | Gap | Why It's an Opportunity | Suggested Angle | |
| 104 | |-----|-------------------------|-----------------| |
| 105 | | [Gap 1] | Only 2/10 mention | [Specific suggestion] | |
| 106 | | [Gap 2] | Shallow coverage | [Specific suggestion] | |
| 107 | |
| 108 | ## Recommended H2 Structure |
| 109 | |
| 110 | 1. [H2 Title] - Covers [Topic] |
| 111 | 2. [H2 Title] - Covers [Topic] |
| 112 | 3. [H2 Title] - Gap opportunity: [Gap] |
| 113 | 4. ... |
| 114 | |
| 115 | ## E-E-A-T Recommendations |
| 116 | |
| 117 | - **Experience**: Add [specific suggestion, e.g., real case/screenshots] |
| 118 | - **Expertise**: Cite [data sources/expert opinions] |
| 119 | - **Original Value**: [What can you provide that competitors don't] |
| 120 | |
| 121 | ## SERP Feature Opportunities |
| 122 | |
| 123 | - [ ] Featured Snippet: [Opportunity exists? Format suggestion] |
| 124 | - [ ] PAA: [Related questions list] |
| 125 | - [ ] Video: [Video needed?] |
| 126 | |
| 127 | ## Internal Link Suggestions |
| 128 | |
| 129 | - Link to: [Related existing pages] |
| 130 | - Get links from: [Which pages should link to this article] |
| 131 | ``` |
| 132 | |
| 133 | --- |
| 134 | |
| 135 | ## Usage |
| 136 | |
| 137 | ```bash |
| 138 | # Generate content brief |
| 139 | /seo content-brief "target keyword" |
| 140 | |
| 141 | # Then write content using the brief |
| 142 | /seo content-writer --brief [brief-file] |
| 143 | ``` |
| 144 | |
| 145 | --- |
| 146 | |
| 147 | ## Related Skills |
| 148 | |
| 149 | | Upstream | This Skill | Downstream | |
| 150 | |----------|------------|------------| |
| 151 | | 30x-seo-keywords | **30x-seo-content-brief** | 30x-seo-content-writer | |
| 152 | | 30x-seo-plan | ↓ Analyze SERP | ↓ Write per brief | |
| 153 | |
| 154 | --- |
| 155 | |
| 156 | ## Important Notes |
| 157 | |
| 158 | 1. **No plagiarism**: Brief is an analysis tool, not a copying tool |
| 159 | 2. **Original first**: Gap sections must have original content |
| 160 | 3. **E-E-A-T**: Every piece needs real experience/data |
| 161 | 4. **Timeliness**: Competitors change, briefs have expiration |
| 162 | |
| 163 | [PROTOCOL]: Update this header on changes, then check CLAUDE.md |