developer-seo
installsforks
How to install developer-seo?
jonathimer/devmarketing-skills/developer-seo
$npx -y skills add jonathimer/devmarketing-skills --skill developer-seoSEO strategy for technical queries and developer audiences. Covers keyword research for "how to X in language" queries, error message SEO, Stack Overflow-style content, technical long-tail keywords, and competing with official documentation sites. Use when asked about: - SEO for
SKILL.md
| 1 | # Developer SEO |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Developer SEO differs fundamentally from traditional SEO. Developers search with precise technical intent—error messages, API questions, "how to X in Y language" queries. They bounce immediately from thin content and respect sites that actually solve problems. Your competition isn't other marketing sites; it's Stack Overflow, official docs, and GitHub issues. |
| 6 | |
| 7 | This skill covers SEO strategies that work for technical audiences without compromising on substance. |
| 8 | |
| 9 | ## Understanding Developer Search Behavior |
| 10 | |
| 11 | ### How Developers Search |
| 12 | |
| 13 | Developers search differently than general audiences: |
| 14 | |
| 15 | **Query patterns:** |
| 16 | - Error messages (often copy-pasted verbatim) |
| 17 | - "How to [action] in [language/framework]" |
| 18 | - "[Tool A] vs [Tool B]" |
| 19 | - "[Concept] tutorial" |
| 20 | - "[Library] [specific function] example" |
| 21 | |
| 22 | **Behavioral signals:** |
| 23 | - High bounce rates on superficial content |
| 24 | - Long dwell time on genuinely helpful pages |
| 25 | - Multiple tabs open comparing solutions |
| 26 | - Quick scroll to code examples |
| 27 | - Immediate exit if content doesn't match query intent |
| 28 | |
| 29 | ### Search Intent Categories |
| 30 | |
| 31 | 1. **Troubleshooting**: Developer has an error, needs a fix |
| 32 | 2. **Learning**: Developer wants to understand a concept |
| 33 | 3. **Evaluating**: Developer comparing tools or approaches |
| 34 | 4. **Implementing**: Developer needs working code examples |
| 35 | 5. **Reference**: Developer needs quick syntax or API lookup |
| 36 | |
| 37 | ## Keyword Research for Developers |
| 38 | |
| 39 | ### Finding Technical Long-Tail Keywords |
| 40 | |
| 41 | Technical long-tail keywords have lower volume but extremely high intent. A developer searching "axios interceptor refresh token react" knows exactly what they need. |
| 42 | |
| 43 | **Research approaches:** |
| 44 | |
| 45 | 1. **Mine your support channels** |
| 46 | - Extract questions from support tickets |
| 47 | - Review Discord/Slack community questions |
| 48 | - Analyze GitHub issues for common problems |
| 49 | |
| 50 | 2. **Stack Overflow mining** |
| 51 | - Search for questions mentioning your tool category |
| 52 | - Look at related questions on popular threads |
| 53 | - Note the exact phrasing developers use |
| 54 | |
| 55 | 3. **Google Search Console analysis** |
| 56 | - Find queries you rank positions 5-20 for |
| 57 | - Identify question-based queries |
| 58 | - Spot error message searches hitting your site |
| 59 | |
| 60 | 4. **Competitor content gaps** |
| 61 | - What questions do competitors' docs not answer? |
| 62 | - Where are forum threads unsatisfied with existing answers? |
| 63 | |
| 64 | ### Error Message SEO |
| 65 | |
| 66 | Error messages are SEO gold—developers copy-paste them directly into search. |
| 67 | |
| 68 | **Strategy:** |
| 69 | 1. Create dedicated pages for common errors |
| 70 | 2. Use exact error text in titles and H1s |
| 71 | 3. Include the full error message early in content |
| 72 | 4. Provide the actual fix, not generic troubleshooting |
| 73 | 5. Add related errors users might also encounter |
| 74 | |
| 75 | **Content structure for error pages:** |
| 76 | ``` |
| 77 | Title: [Exact Error Message] - How to Fix |
| 78 | |
| 79 | ## The Error |
| 80 | [Full error message and where it appears] |
| 81 | |
| 82 | ## Quick Fix |
| 83 | [The solution that works in most cases] |
| 84 | |
| 85 | ## Why This Happens |
| 86 | [Brief technical explanation] |
| 87 | |
| 88 | ## Other Solutions |
| 89 | [Alternative fixes for edge cases] |
| 90 | |
| 91 | ## Related Errors |
| 92 | [Links to similar issues] |
| 93 | ``` |
| 94 | |
| 95 | ### Competing with Official Documentation |
| 96 | |
| 97 | Official docs have domain authority advantages but often have weaknesses: |
| 98 | |
| 99 | **Where docs often fail:** |
| 100 | - No "why" explanations, just "what" |
| 101 | - Missing real-world examples |
| 102 | - No troubleshooting guides |
| 103 | - Outdated content |
| 104 | - No comparative context |
| 105 | |
| 106 | **Your opportunities:** |
| 107 | - "Getting started with X" tutorials that hold your hand |
| 108 | - "X vs Y" comparison content (docs never compare) |
| 109 | - Migration guides between versions or tools |
| 110 | - Real-world implementation examples |
| 111 | - Common gotchas and how to avoid them |
| 112 | |
| 113 | ## Content Formats That Rank |
| 114 | |
| 115 | ### How-To Guides |
| 116 | |
| 117 | Structure for technical how-to content: |
| 118 | |
| 119 | ```markdown |
| 120 | # How to [Action] in [Technology] |
| 121 | |
| 122 | ## Prerequisites |
| 123 | - What you need before starting |
| 124 | - Required versions/dependencies |
| 125 | |
| 126 | ## Quick Version (TL;DR) |
| 127 | - Code snippet that works for common case |
| 128 | |
| 129 | ## Step-by-Step |
| 130 | 1. Step with explanation |
| 131 | 2. Step with code example |
| 132 | 3. Step with expected output |
| 133 | |
| 134 | ## Complete Example |
| 135 | [Full working code] |
| 136 | |
| 137 | ## Common Issues |
| 138 | - Problem 1: Solution |
| 139 | - Problem 2: Solution |
| 140 | |
| 141 | ## Next Steps |
| 142 | [What to learn next] |
| 143 | ``` |
| 144 | |
| 145 | ### Comparison Content |
| 146 | |
| 147 | Developers actively search "[Tool A] vs [Tool B]" when evaluating options. |
| 148 | |
| 149 | **Guidelines:** |
| 150 | - Be genuinely objective (developers will check) |
| 151 | - Include actual code comparisons |
| 152 | - Cover specific use cases where each wins |
| 153 | - Mention your tool's limitations honestly |
| 154 | - Update when tools change significantly |
| 155 | |
| 156 | ### Tutorial Serie |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
