$npx -y skills add Varnan-Tech/opendirectory --skill seo-keyword-researchSEO keyword research workflow for blog generation using Google Trends data. Use when writing blog posts, planning content calendars, or optimizing articles for search engines. Finds breakout keywords, builds content structure, and generates SEO-optimized blog outlines targeting t
| 1 | # SEO Keyword Research Skill |
| 2 | |
| 3 | Find trending, high-opportunity keywords BEFORE writing blog content. This skill turns generic blog topics into SEO-optimized content that ranks. |
| 4 | |
| 5 | ## When to Use |
| 6 | |
| 7 | - User asks to write a blog post or article |
| 8 | - User wants keyword research for a topic |
| 9 | - User needs a content calendar or content plan |
| 10 | - User wants to optimize existing content for SEO |
| 11 | - Any blog generation task for a tech/developer-focused audience |
| 12 | |
| 13 | ## Core Principle |
| 14 | |
| 15 | **Always research keywords BEFORE generating blog content.** |
| 16 | |
| 17 | ``` |
| 18 | BAD: Write blog -> Hope it ranks -> Usually doesn't |
| 19 | GOOD: Research keywords -> Find breakout opportunity -> Write optimized blog -> Ranks well |
| 20 | ``` |
| 21 | |
| 22 | ## Keyword Priority System |
| 23 | |
| 24 | When analyzing Google Trends RELATED_QUERIES results, prioritize keywords in this order: |
| 25 | |
| 26 | ### 1. Breakout Keywords — HIGHEST priority |
| 27 | - `formatted_value: "Breakout"` = 5000%+ growth |
| 28 | - Very low competition (trend is new) |
| 29 | - Use as PRIMARY blog keyword |
| 30 | - Create content IMMEDIATELY (first-mover advantage) |
| 31 | |
| 32 | ### 2. High-Growth Keywords — VERY HIGH priority |
| 33 | - `formatted_value: "+100%"` or higher |
| 34 | - Low to moderate competition |
| 35 | - Use as primary or strong secondary keyword |
| 36 | - Create content within 2-4 weeks |
| 37 | |
| 38 | ### 3. Moderate-Growth Keywords — HIGH priority |
| 39 | - `formatted_value: "+50%"` to `"+99%"` |
| 40 | - Moderate competition |
| 41 | - Use as secondary keywords in body content |
| 42 | |
| 43 | ### 4. Long-Tail Keywords — STRATEGIC priority |
| 44 | - Question-based queries (how, what, why, when, where) |
| 45 | - Low competition, high conversion |
| 46 | - Use as H3 headings — target featured snippets and voice search |
| 47 | |
| 48 | ### 5. Established Keywords — MODERATE priority |
| 49 | - Top queries with stable interest, high competition |
| 50 | - Use in body content, not as primary target |
| 51 | |
| 52 | ## SEO Research Workflow |
| 53 | |
| 54 | ### Step 1: Keyword Discovery (1 API call — REQUIRED) |
| 55 | |
| 56 | Query `RELATED_QUERIES` with the user's blog topic: |
| 57 | |
| 58 | ```bash |
| 59 | curl -s "https://serpapi.com/search?engine=google_trends&q=USER_TOPIC&data_type=RELATED_QUERIES&date=today+3-m&api_key=$SERPAPI_KEY" |
| 60 | ``` |
| 61 | |
| 62 | From the response, extract: |
| 63 | - **Breakout keywords** → candidate primary keywords |
| 64 | - **High-growth keywords** (+100%) → secondary candidates |
| 65 | - **Question-based queries** → H3 headings and featured snippet targets |
| 66 | |
| 67 | Select the primary keyword: |
| 68 | 1. First breakout keyword (if any) |
| 69 | 2. Else first high-growth keyword |
| 70 | 3. Else top query by score |
| 71 | |
| 72 | ### Step 2: Content Structure (1 API call — REQUIRED) |
| 73 | |
| 74 | Query `RELATED_TOPICS` with the same topic: |
| 75 | |
| 76 | ```bash |
| 77 | curl -s "https://serpapi.com/search?engine=google_trends&q=USER_TOPIC&data_type=RELATED_TOPICS&date=today+3-m&api_key=$SERPAPI_KEY" |
| 78 | ``` |
| 79 | |
| 80 | Extract topic titles from rising + top results. These become your H2 section headings (pick 3-5). |
| 81 | |
| 82 | ### Step 3: Trend Validation (1 API call — OPTIONAL) |
| 83 | |
| 84 | Only if choosing between multiple candidate keywords or validating viability: |
| 85 | |
| 86 | ```bash |
| 87 | curl -s "https://serpapi.com/search?engine=google_trends&q=KEYWORD&data_type=TIMESERIES&date=today+12-m&api_key=$SERPAPI_KEY" |
| 88 | ``` |
| 89 | |
| 90 | Compare recent 2-month average vs. earlier 2-month average. If recent > earlier, trend is rising — proceed. If declining, consider a different keyword. |
| 91 | |
| 92 | ### Step 4: Generate Blog Outline |
| 93 | |
| 94 | Build the outline using this structure: |
| 95 | |
| 96 | ``` |
| 97 | Title: [Primary Keyword] — [Benefit/Number] [Year] |
| 98 | (max 60 characters, must include primary keyword) |
| 99 | |
| 100 | Meta Description: (150-160 chars, primary + 1-2 secondary keywords) |
| 101 | |
| 102 | # [H1 — same as or variation of title] |
| 103 | |
| 104 | ## Introduction (150 words) |
| 105 | - Primary keyword in first 100 words |
| 106 | - Hook with a problem or question |
| 107 | - Preview what they'll learn |
| 108 | |
| 109 | ## [H2: Related Topic 1 from Step 2] |
| 110 | ### [H3: Long-tail question from Step 1] |
| 111 | Content answering the question (150-200 words) |
| 112 | ### [H3: Another long-tail question] |
| 113 | Content (150-200 words) |
| 114 | |
| 115 | ## [H2: Related Topic 2] |
| 116 | ### [H3: Long-tail question] |
| 117 | ### [H3: Long-tail question] |
| 118 | |
| 119 | ## [H2: Related Topic 3] |
| 120 | ### [H3: Long-tail question] |
| 121 | ### [H3: Long-tail question] |
| 122 | |
| 123 | ## Conclusion (100 words) |
| 124 | - Summarize key points |
| 125 | - Primary keyword mentioned once |
| 126 | - Call-to-action |
| 127 | |
| 128 | Target: 1500-2500 words total |
| 129 | ``` |
| 130 | |
| 131 | ## Keyword Placement Rules |
| 132 | |
| 133 | | Location | Rule | |
| 134 | |----------|------| |
| 135 | | Title | Include primary keyword, max 60 chars | |
| 136 | | H1 | Same as title or slight variation | |
| 137 | | H2 headings (3-5) | Use related topics, natural language | |
| 138 | | H3 headings (8-12) | Use long-tail keywords, question format | |
| 139 | | First paragraph | Primary keyword |