$npx -y skills add AgriciDaniel/claude-seo --skill seo-content-briefGenerate competitive SEO content briefs with per-section word counts, competitor scoring, keyword density guidance, and page-type templates. Supports both new page briefs and improve-existing-page briefs. Use when user says "content brief", "write a brief", "content outline", "bl
| 1 | # SEO Content Brief Generator |
| 2 | |
| 3 | Generate research-backed content briefs that help writers produce pages capable of outranking current top results. Briefs include competitor analysis with gap scoring, per-section word count breakdowns, keyword placement rules, and page-type-specific templates. |
| 4 | |
| 5 | ## Process |
| 6 | |
| 7 | ### 1. Determine Brief Mode |
| 8 | |
| 9 | **Improve mode** (existing page URL provided): |
| 10 | - Fetch the existing page content and structure |
| 11 | - Identify what is already strong (keep it) |
| 12 | - Identify missing, thin, or outdated sections |
| 13 | - Distinguish "keep/strengthen" vs "add new" sections in the outline |
| 14 | - Do not recommend a full rewrite when targeted improvements will win |
| 15 | |
| 16 | **New page mode** (keyword or topic provided, no existing page): |
| 17 | - Use the target site's homepage or sitemap for business context only |
| 18 | - Build the brief from scratch for a new page |
| 19 | - Focus on competitive gaps the new page can fill |
| 20 | |
| 21 | ### 2. Fetch Context |
| 22 | |
| 23 | - Fetch the target URL or homepage to understand the business |
| 24 | - Fetch the sitemap to discover all existing pages, categories, and services |
| 25 | - This context is critical for the Website Relevance Rule (see below) |
| 26 | |
| 27 | ### 3. Analyse SERPs |
| 28 | |
| 29 | - Identify the top 5 ranking pages for the target keyword |
| 30 | - Filter out non-competitors (Wikipedia, Reddit, Pinterest, Amazon, YouTube, government sites, SEO tool pages, job boards, directories, news aggregators, social platforms). See `references/excluded-domains.md` for the full list. |
| 31 | - Score each real competitor: Depth (1-10), Formatting (1-10), SEO (1-10), UX (1-10) |
| 32 | - Identify three gap types: |
| 33 | - **Topic gaps:** subtopics competitors miss entirely |
| 34 | - **Depth gaps:** topics covered but shallow |
| 35 | - **Quality gaps:** outdated info, no expert perspective, poor formatting |
| 36 | - Calculate gap priority: `Impact x Competitive Advantage / Effort` |
| 37 | |
| 38 | ### 4. Classify Search Intent |
| 39 | |
| 40 | - **Informational:** user wants to learn (guides, how-tos, definitions) |
| 41 | - **Commercial:** user is researching before buying (comparisons, reviews, "best X") |
| 42 | - **Transactional:** user is ready to act (buy, book, enquire, sign up) |
| 43 | - **Navigational:** user is looking for a specific site or page |
| 44 | |
| 45 | Identify what SERP format Google rewards for this query: long-form guide, listicle, comparison table, landing page, FAQ, video, local pack. |
| 46 | |
| 47 | ### 5. Build the Brief |
| 48 | |
| 49 | Apply the page-type template from `references/page-type-templates.md`, then customise based on competitor gaps and search intent. |
| 50 | |
| 51 | ## Critical Rules |
| 52 | |
| 53 | ### Website Relevance Rule |
| 54 | |
| 55 | Every heading, subtopic, keyword, and FAQ you suggest must be something the target website can credibly write about based on its actual services or products. |
| 56 | |
| 57 | - Read the site's homepage and sitemap to understand what it does |
| 58 | - Do not borrow competitor structure if those sections cover things this site does not offer |
| 59 | - Before each suggestion, ask: "Can this website actually deliver on this content?" If no, remove it. |
| 60 | |
| 61 | ### Site Structure Coverage Rule |
| 62 | |
| 63 | When briefing a hub, overview, category, or "types of" page: |
| 64 | - The outline must reference every relevant product category, service, or sub-page that exists on the site |
| 65 | - Do not invent categories that don't exist, do not leave out categories that do exist |
| 66 | - Each category should appear as its own section with an internal link suggestion |
| 67 | - This ensures the page acts as a proper hub linking to all child pages |
| 68 | |
| 69 | For non-hub pages (single service page, blog post), use site structure to suggest relevant internal links but do not force every category into the outline. |
| 70 | |
| 71 | ### Output Language Rules |
| 72 | |
| 73 | - Never mention researcher names, framework names, or tool names in the output (no "Ben Goodey method", "Frase.io formula", "Princeton GEO", "Clearscope", "Backlinko") |
| 74 | - These are internal thinking tools only. The output must read as plain, professional advice. |
| 75 | - Write for a business owner or content writer, not an SEO academic |
| 76 | |
| 77 | ## Keyword Density and Placement |
| 78 | |
| 79 | Read `references/keyword-density.md` for the full rules. Summary: |
| 80 | |
| 81 | **Primary keyword use:** Use the primary keyword naturally in high-value locations. |
| 82 | - Do not optimize to a fixed density. Treat density checks as optional internal readability/stuffing heuristics only. |
| 83 | - First 1-2 mentions help establish topic context. Diminishing returns after. |
| 84 | - For a 1,000-word article, avoid forced repetition across headings, body, and alt text. |
| 85 | |
| 86 | **Primary keyword must appear in:** |
| 87 | 1. Title tag (near the fr |