seo
Use this skill when the user needs to plan SEO content, do keyword research, build a content calendar, map search intent to page types, or create an internal linking strategy. Also use when the user says 'how do I rank higher,' 'what should I write about for SEO,' 'SEO plan,' 'what keywords should I target,' or 'how to get organic traffic.' This is the strategy and planning skill — for writing content see seo-content, for technical implementation see technical-seo, for auditing see seo-audit.
Best use case
seo is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Use this skill when the user needs to plan SEO content, do keyword research, build a content calendar, map search intent to page types, or create an internal linking strategy. Also use when the user says 'how do I rank higher,' 'what should I write about for SEO,' 'SEO plan,' 'what keywords should I target,' or 'how to get organic traffic.' This is the strategy and planning skill — for writing content see seo-content, for technical implementation see technical-seo, for auditing see seo-audit.
Teams using seo should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/seo/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How seo Compares
| Feature / Agent | seo | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Use this skill when the user needs to plan SEO content, do keyword research, build a content calendar, map search intent to page types, or create an internal linking strategy. Also use when the user says 'how do I rank higher,' 'what should I write about for SEO,' 'SEO plan,' 'what keywords should I target,' or 'how to get organic traffic.' This is the strategy and planning skill — for writing content see seo-content, for technical implementation see technical-seo, for auditing see seo-audit.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
Best AI Agents for Marketing
A curated list of the best AI agents and skills for marketing teams focused on SEO, content systems, outreach, and campaign execution.
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
SKILL.md Source
# SEO Strategy & Planning SEO is a long game that compounds. This skill helps you plan a content strategy that drives organic signups — deciding what to build, in what order, targeting which keywords. This skill answers **what to write and where**. For the other SEO concerns: - **seo-content** — How to write it (content briefs, humanized writing, SERP feature targeting) - **technical-seo** — How to implement it in code (meta tags, schema, CWV, crawlability, GEO) - **seo-audit** — How to assess what exists (scan a codebase, produce an action plan) ## Workflow ``` SEO Strategy Setup: - [ ] Research keywords for your niche (see Keyword Intent Mapping below) - [ ] Map keywords to page types (feature, comparison, blog, etc.) - [ ] Build content architecture (site structure + URL patterns) - [ ] Prioritize: bottom-funnel pages first, then mid, then top - [ ] Create internal linking plan - [ ] Set up tracking (Google Search Console) - [ ] Build content calendar (2-5 pieces/month) ``` --- ## Core Principles - SEO is not gaming Google — it's structuring content so it's findable and useful. - Content quality and relevance determine rankings. Technical SEO is table stakes. - Target intent, not just keywords. "Best CRM" and "CRM pricing" have completely different searchers. - One page per intent. Cannibalizing your own rankings is the most common SaaS SEO mistake. - Internal linking is your most underused lever. ### Don't Do Yet - **Don't obsess over technical SEO** before you have content. Schema markup on an empty blog is pointless. - **Don't buy backlinks.** Google penalizes this. Earn them with good content. - **Don't write 50 blog posts at once.** Start with 5 high-intent pages, measure, iterate. - **Don't hire an SEO agency** before doing keyword research yourself. You understand your customers better than they do. --- ## SEO Timeline: Set Realistic Expectations | Timeframe | What to Expect | |-----------|---------------| | Month 1-2 | Pages indexed, minimal traffic. Focus on building content. | | Month 3-4 | Long-tail keywords start ranking (page 2-3). | | Month 5-6 | Some pages reach page 1 for low-competition terms. | | Month 6-12 | Compound growth as domain authority builds. | **Reality check:** SEO takes 3-6 months to show results. If you need signups this week, use paid ads or outreach. SEO is the engine you build now so you're not paying for every click forever. --- ## Content Architecture for SaaS Build your site structure around search intent, not your org chart. ### High-Priority Pages (Build First) | Page Type | URL Pattern | Search Intent | |-----------|------------|---------------| | Homepage | `/` | Branded searches, direct traffic | | Feature pages | `/features/[feature]` | "How to [solve problem]" | | Pricing page | `/pricing` | "[Product] pricing", "[category] pricing" | | Comparison pages | `/compare/[competitor]` | "[Product] vs [Competitor]" | | Use case pages | `/for/[audience]` | "[Category] for [role/industry]" | ### Content Pages (Build Over Time) | Page Type | URL Pattern | Search Intent | |-----------|------------|---------------| | How-to guides | `/blog/how-to-[action]` | Tutorials that drive signups | | Listicles | `/blog/best-[category]` | "Best [category] tools" — feature your product | | Guides | `/blog/[topic]-guide` | Comprehensive mid-funnel content | | Templates | `/templates/[use-case]` | "[Use case] template" — free value | | Glossary | `/glossary/[term]` | "What is [term]?" — top-of-funnel | **Tell AI:** ``` Create a content architecture for our SaaS product [name]: - Product solves [problem] for [audience] - Main features: [list features] - Top 3 competitors: [list competitors] Generate a sitemap with URL patterns for: homepage, feature pages, comparison pages, use case pages, and initial blog post ideas. Prioritize by search intent value. ``` --- ## Keyword Intent Mapping Every keyword has an intent. Match your page type to the intent: | Intent | Example Searches | Best Page Type | |--------|-----------------|----------------| | **Informational** | "what is [concept]", "how to [action]" | Blog post, glossary entry | | **Navigational** | "[your brand] login", "[your brand] pricing" | Ensure YOUR pages rank #1 | | **Commercial** | "best [category] tools", "[tool A] vs [tool B]" | Comparison page, listicle | | **Transactional** | "[category] pricing", "buy [product]" | Pricing page, signup page | ### Keyword Research by Tool **Claude Code** (has web access via Ahrefs MCP or web search): ``` Do keyword research for our product [name] in the [category] space: - Find 20 keywords our ICP would search for - Classify each by intent (informational, navigational, commercial, transactional) - Estimate competition level (low, medium, high) - Recommend which page type to create for each keyword - Prioritize: low competition + high intent first ``` **Lovable / Replit / Cursor** (no web access — bring your own data): 1. Do keyword research first using a free tool: Google Search Console (what you already rank for), Google autocomplete (type your topic and note suggestions), or AnswerThePublic 2. Then paste results into your AI tool: ``` Here are my keyword research results: [paste keywords + volumes] Classify each by intent, recommend a page type for each, and prioritize by low competition + high intent. ``` --- ## Internal Linking Strategy Internal links are free and high-impact. Use them intentionally. ### Rules - Every blog post links to at least 1 feature/product page - Every feature page links to related features and relevant blog posts - Use descriptive anchor text: "our workflow automation feature" not "click here" - Create hub pages that link to all content in a topic cluster ### Topic Clusters Group content around themes. Each cluster has: 1. **Pillar page** — Comprehensive overview (e.g., "Complete Guide to [Topic]") 2. **Cluster pages** — Specific subtopics (e.g., "How to [specific action]") 3. **Internal links** — Every cluster page links to the pillar. Pillar links to all clusters. **Tell AI:** ``` Build an internal linking plan for our site: - Audit existing pages and identify linking opportunities - For each blog post, suggest 2-3 internal links to product/feature pages - For each feature page, suggest 2-3 links to related blog posts - Identify gaps: pages with zero internal links pointing to them - Use descriptive anchor text (not "click here" or "learn more") ``` --- ## Content Planning ### Prioritization Framework Write content in this order: 1. **Bottom-of-funnel first:** Comparison pages, pricing page, feature pages — these convert 2. **Mid-funnel:** How-to guides, use case pages — these build authority 3. **Top-of-funnel:** Glossary, broad guides — these drive volume (but lower conversion) ### Content Calendar (Simple Version) **Claude Code:** ``` Create a 3-month content calendar for our SaaS blog: - Product: [name], solves [problem] for [audience] - Goal: drive organic signups - Mix: 2 bottom-funnel pieces, 2 mid-funnel pieces, 1 top-funnel piece per month - For each piece: title, target keyword, intent, URL, and brief outline - Use web search to validate keyword difficulty before finalizing ``` **Lovable / Replit / Cursor:** Use the same prompt above but remove the last line (these tools can't search the web). Instead, validate keywords yourself in Google Search Console or a free tool like Ubersuggest first, then paste your validated keyword list into the prompt. --- ## Measuring SEO Results | Metric | Tool | What It Tells You | |--------|------|------------------| | Organic traffic | Google Search Console (free) | How many people find you via search | | Keyword rankings | Google Search Console | Which queries you appear for and position | | Click-through rate | Google Search Console | Whether your titles/descriptions earn clicks | | Organic signups | Your analytics tool | Whether SEO traffic actually converts | **Tell AI:** ``` Set up SEO tracking: - Connect Google Search Console to our site - Add UTM parameters to track organic → signup conversion - Create a monthly report: top 10 pages by organic traffic, top 10 keywords by impressions, click-through rate by page, and organic signup count ``` --- ## Common Mistakes | Mistake | Fix | |---------|-----| | Writing content with no keyword research | Research first. Every page should target a specific keyword + intent. | | Targeting high-competition keywords first | Start with long-tail, low-competition keywords. Build authority before going after "CRM software". | | No internal links | Link every page to related pages. It's free and high-impact. | | Duplicate intent across pages | One page per search intent. Don't create 3 blog posts targeting the same keyword. | | Expecting results in 2 weeks | SEO takes 3-6 months. Track progress monthly, not daily. | | Ignoring existing content | Update and improve old content before writing new. A refreshed page ranks faster than a new one. |
Related Skills
validate
Use this skill when the user needs to validate a business idea, test demand before building, run a smoke test, create an MVP experiment, or decide whether an idea is worth pursuing. Covers demand validation, smoke tests, fake-door tests, landing page experiments, and go/no-go decision frameworks for bootstrapped founders.
ux-design
Use this skill when flows feel clunky, users are confused, navigation needs planning, onboarding needs design, or accessibility needs implementation. Covers information architecture, user flows, interaction patterns, progressive disclosure, and error handling UX.
ui-patterns
Use this skill when the user needs to build a dashboard, settings page, data table, or any page layout. Also use when choosing component libraries, implementing responsive design, dark mode, or handling UI states (loading, empty, error). Covers component selection, page composition, and responsive implementation.
translate
Use this skill when the user is a domain expert (lawyer, doctor, contractor, accountant, etc.) who wants to turn their professional knowledge into a software product. Also use when the user says 'I have an idea for my industry,' 'I know this problem exists,' 'I want to build something for [profession],' or is struggling to describe what they want the software to do. Helps identify which professional pain is worth building for, then translates it into requirements AI tools can execute.
test
Use this skill when the user needs to test features before deployment, create test scenarios, find edge cases, or verify bug fixes. Covers manual testing workflows, cross-browser testing, edge case identification, and testing checklists for non-technical founders.
technical-seo
Use this skill to implement technical SEO optimizations in code — meta tags, schema markup, Core Web Vitals, crawlability, robots.txt, sitemaps, and GEO (Generative Engine Optimization) for AI search engines. This is the implementation skill — for strategy see seo, for content writing see seo-content, for auditing see seo-audit.
support
Use this skill when the user needs to create help docs, build a knowledge base, set up self-serve support, or reduce support tickets. Covers documentation strategy, help center structure, support tone, and scaling support without hiring.
social-media
Use this skill when the user needs to grow a social media presence, create content for Twitter/X, LinkedIn, or other platforms, build a founder brand, or use social media as a distribution channel. Covers platform strategy, content frameworks, posting cadence, and audience building for bootstrapped SaaS founders.
seo-content
Use this skill when the user needs to write SEO content — blog posts, landing pages, feature pages, comparison pages, how-to guides, or any content meant to rank in search and get cited by AI. Covers content briefs, humanized writing that avoids AI detection, SERP feature targeting, entity optimization, content refresh, and quality self-checks. This is the writing skill — for strategy see seo, for technical implementation see technical-seo, for auditing see seo-audit.
seo-audit
Audit a codebase for SEO and AI-answer visibility, then produce a prioritized fix-it plan. Use this skill whenever a user says things like "audit my SEO", "check my site for search visibility", "how do I rank better", "optimize for Google", "optimize for AI answers", "SEO review", "GEO audit", "run the SEO agent", or anything about improving organic traffic or search rankings. Also trigger when someone mentions wanting visibility in AI-generated answers (ChatGPT, Gemini, Perplexity, Claude). Works on any web project — static sites, Next.js, Astro, Hugo, WordPress themes, or anything that outputs HTML.
secure
Use this skill when the user needs to secure their SaaS app, implement authentication, protect user data, secure APIs, or check for vulnerabilities. Also use when the user says 'is my app secure,' 'security check,' 'I'm worried about hackers,' 'how do I protect user data,' or 'security before launch.' Covers OWASP Top 10, auth best practices, data protection, and security checklists for apps built with AI tools.
sales
Use this skill when the user needs to find their first customers, write cold outreach, build a prospect list, or close early sales. Covers founder-led sales methodology, outreach templates, personalization, LinkedIn strategy, and landing the first 100 customers.