Skill: kryzl19/seo-keyword-researcher (version 1.0.0)

--- name: seo-keyword-researcher description: "Research SEO keywords for any topic and generate a complete article brief with primary keyword, secondary keywords, competition analysis, article structure, and SEO recommendations. Use when: (1) planning new content for TechStack.dev, (2) researching keywords for SEO articles, (3) creating content strategy, (4) identifying low-competition keywords, (5) building an article outline. Triggers on: keyword research, SEO article ideas, what keywords should I target, article topic research, SEO brief, content planning, keyword analysis." --- # SEO Keyword Researcher Research keywords and produce a complete article brief ready for writing. ## Workflow ### Step 1: Seed Research Run 3 searches simultaneously: ``` web_search: "[topic] + '2026'" (get trending angle) web_search: "[topic] best/top X compared 2026" web_search: "[topic] guide tutorial how to 2026" ``` ### Step 2: Competitor Analysis Fetch the top 2-3 ranking pages from results: ``` web_fetch: [top URL], maxChars=3000 each ``` Extract: title structure, H2 headings, word count, featured snippet patterns. ### Step 3: Generate Keyword Cluster From the seed searches and competitor analysis, identify: - **Primary keyword:** Highest search intent match, moderate competition - **Secondary keywords (5-10):** Long-tail variations, questions, comparisons - **Question keywords:** "how to", "what is", "why does", "best way to" - **LSI keywords:** Related terms that signal topical authority ### Step 4: Write Article Brief Output a markdown brief with: 1. Article title (H1) — include primary keyword 2. Meta description (155 chars max) 3. Primary + secondary keywords 4. Competitor gap analysis 5. Recommended article structure (H2s with sub-points) 6. Word count target 7. SEO recommendations (internal links to add, CTA to include) ## Reference See `references/seo-checklist.md` for the on-page SEO checklist to apply before publishing. See `references/keyword-research-methods.md` for advanced keyword clustering techniques.

path: references/keyword-research-methods.md
content: # Keyword Research Methods

## Seed Keyword Expansion

Start with 1-3 seed keywords, then expand using:

1. **Google Autocomplete:** Type seed into Google, capture suggestions
2. **Related Searches:** Bottom of Google results page
3. **People Also Ask:** Capture question-format keywords
4. **AnswerThePublic:** Question modifiers (how, why, what, when, where)
5. **Ubersuggest/SEMrush:** For competition and volume data

## Keyword Types by Funnel Stage

| Stage | Intent | Example | Content Type |
|-------|--------|---------|--------------|
| TOFU | Awareness | "what is VPS hosting" | Guide/Explain |
| MOFU | Consideration | "best VPS for AI agents" | Comparison |
| BOFU | Decision | "Hetzner VPS setup guide" | Tutorial |

## Low-Competition Finding
- Target keywords with 3+ words (long-tail)
- Look for "best X for Y" patterns
- Check domain authority of top results — if <40 sites rank, easier to beat
- Newer articles (2024+) = less entrenched competition
- Niche subreddits + communities = underserved topics

## Question Keywords (PAA)
Capture these patterns:
- "how to [task]"
- "what is [concept]"
- "why does [issue]"
- "best way to [goal]"
- "[comparison] vs [alternative]"
- "[number] tips for [outcome]"

These work for featured snippets and voice search.

## Competitor Gap Analysis
1. Find top 3 ranking pages for target keyword
2. Note what they don't cover (gaps = your opportunity)
3. Note what they cover poorly (improve = your opportunity)
4. Check their word count vs. topic depth
5. Identify their backlink sources — earn those links


path: references/seo-checklist.md
content: # On-Page SEO Checklist

Apply this before publishing any article.

## Title Tag
- [ ] Primary keyword near the start (within 50 chars)
- [ ] Under 60 characters total
- [ ] Unique — never duplicate titles across pages
- [ ] Numbers or year ("2026") improve CTR

## Meta Description
- [ ] Exactly 150-155 characters
- [ ] Primary keyword included
- [ ] Compelling CTA or curiosity hook
- [ ] Matches search intent

## Heading Structure
- [ ] Single H1 per page (article title)
- [ ] Logical H2/H3 hierarchy
- [ ] Keywords in H2s where natural
- [ ] No orphan headings (every H2 has content)

## Content Quality
- [ ] Word count: 1500-2500 words for competitive topics, 800-1200 for low competition
- [ ] First 100 words: keyword + clear value proposition
- [ ] Keyword density: 0.5-2% (1-2 instances per 100 words)
- [ ] Related keywords throughout (not just the primary)
- [ ] Data/stats cite sources

## Technical
- [ ] Canonical URL set correctly
- [ ] Internal links: 2-5 to other site pages
- [ ] External links: 2-3 to authoritative sources
- [ ] Images have alt text
- [ ] Page loads fast (no heavy images above fold)
- [ ] Mobile readable

## Engagement Signals
- [ ] Table of contents for long articles (1500+ words)
- [ ] FAQ section at bottom
- [ ] Clear conclusion with takeaway
- [ ] Related articles section

## Common Mistakes
- Keyword stuffing — don't do it
- Thin content (<800 words) for competitive topics
- No internal links — siloed content doesn't rank
- Ignoring search intent — don't write tutorials for comparison queries


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)