Implement GitOps workflows with ArgoCD and Flux for automated, declarative Kubernetes...
npx skills add 404kidwiz/claude-supercode-skills --skill "seo-specialist"
Install specific skill from multi-skill repository
# Description
Expert in Search Engine Optimization, driving organic traffic through technical auditing, content strategy, and authority building.
# SKILL.md
name: seo-specialist
description: Expert in Search Engine Optimization, driving organic traffic through technical auditing, content strategy, and authority building.
SEO Specialist
Purpose
Provides search engine optimization expertise specializing in technical SEO audits, content strategy, and organic traffic growth. Optimizes digital presence for search engines (Google, Bing) through semantic content, structured data, and authority building.
When to Use
- Conducting a comprehensive SEO audit (Technical, Content, Off-page)
- Optimizing site architecture, URLs, and internal linking
- Implementing structured data (Schema.org / JSON-LD)
- Performing keyword research and competitor gap analysis
- Diagnosing traffic drops or indexing issues (GSC errors)
- Planning a site migration (domain change, CMS re-platforming)
---
2. Decision Framework
SEO Priority Matrix
Where to focus?
│
├─ **Technical SEO** (Foundation) - *Fix First*
│ │
│ ├─ Crawlability? → **Robots.txt, Sitemap, Status Codes**
│ ├─ Indexability? → **Noindex tags, Canonicals**
│ └─ Performance? → **Core Web Vitals (LCP, CLS, INP)**
│
├─ **On-Page SEO** (Relevance) - *Fix Second*
│ │
│ ├─ Content? → **Keyword Targeting, E-E-A-T, Freshness**
│ ├─ Structure? → **Headings (H1-H6), Title Tags, Meta Desc**
│ └─ UX? → **Mobile-Friendliness, Intrusive Interstitials**
│
└─ **Off-Page SEO** (Authority) - *Long Term*
│
├─ Backlinks? → **Digital PR, Guest Posting, Outreach**
├─ Brand? → **Social Signals, Brand Mentions**
└─ Local? → **Google Business Profile, Citations**
Keyword Strategy
| Intent Type | Example Query | Content Format | Priority |
|---|---|---|---|
| Informational | "How to fix sink" | Blog Post / Guide / Video | Top Funnel (Awareness) |
| Navigational | "Home Depot login" | Homepage / Login Page | Brand Defense |
| Commercial | "Best wrench set" | Comparison / Review / Listicle | Mid Funnel (Consideration) |
| Transactional | "Buy 10mm socket" | Product Page / Category Page | Bottom Funnel (Conversion) |
Red Flags → Escalate to frontend-developer or devops-engineer:
- Website built entirely in client-side JavaScript (SPA) without SSR/Prerendering (SEO disaster)
- Server response times (TTFB) > 2 seconds consistently
- Hundreds of thousands of 404/500 errors
- Security hacks or malware injections
---
3. Core Workflows
Workflow 1: Technical SEO Audit
Goal: Identify and fix technical blockers preventing indexing.
Steps:
-
Crawl Analysis (Screaming Frog / Lumar)
- Run a full site crawl.
- Filter by:
- Status Codes: 4xx (Broken links), 5xx (Server errors).
- Directives: Noindex, Nofollow, Canonicalized URLs.
- Structure: Missing H1s, Duplicate Title Tags.
-
Indexability Check (Google Search Console)
- Check "Pages" report.
- Identify "Crawled - currently not indexed" (Quality issue?) vs "Discovered - currently not indexed" (Budget issue?).
- Verify XML Sitemap submission.
-
Performance Check (PageSpeed Insights)
- Analyze Core Web Vitals.
- LCP (Loading): Target < 2.5s.
- INP (Interactivity): Target < 200ms.
- CLS (Stability): Target < 0.1.
-
Remediation Plan
- Create Jira tickets for devs: "Fix 404s in nav menu", "Implement lazy loading for images".
---
Workflow 4: Content Pruning & Optimization
Goal: Improve site authority by removing or updating low-quality content.
Steps:
-
Audit (GSC + Analytics)
- Identify pages with 0 clicks in last 12 months.
- Identify pages with high bounce rate (> 90%) and low time on page (< 10s).
-
Decision Matrix
- Keep & Optimize: Relevant topic, but poor content. Action: Rewrite.
- Merge: Duplicate topics (e.g., "Best Shoes 2023" vs "Best Shoes 2024"). Action: 301 to newest.
- Delete: Irrelevant/Outdated (e.g., "Christmas Party 2018"). Action: 410 Gone (or 301 if relevant category exists).
-
Execution
- Update content with fresh data/examples.
- Implement 301s.
- Remove internal links to deleted pages.
-
Submission
- Submit updated sitemap to GSC.
---
Workflow 6: Programmatic SEO
Goal: Create 1,000+ landing pages for "Best X for Y" at scale.
Steps:
-
Database Creation (Airtable/Google Sheets)
- Columns: Location, Industry, Tool Type.
- Rows: "CRM for Real Estate", "CRM for Dentists", "CRM for Startups".
-
Template Design
- H1: "Best CRM Software for {Industry} in 2024"
- Intro: Specific pain points of {Industry}.
- Feature list: Filtered by relevance.
-
Generation (Webflow / WordPress)
- Use CMS Collection pages.
- Inject variables.
- Quality Control: Manually review top 20 pages. Ensure unique value in intro.
---
5. Anti-Patterns & Gotchas
❌ Anti-Pattern 1: Keyword Stuffing (The "Dinosaur" Tactic)
What it looks like:
- "We sell cheap shoes. If you are looking for cheap shoes, our cheap shoes are the best cheap shoes."
- Hidden text (white text on white background).
Why it fails:
- Google's Panda algorithm penalizes this heavily.
- User experience is terrible → High Bounce Rate → Lower Rankings.
Correct approach:
- Write naturally for the user.
- Use synonyms and LSI (Latent Semantic Indexing) keywords (e.g., "affordable footwear", "budget sneakers", "footwear deals").
- Focus on "Topic Coverage" rather than keyword density.
❌ Anti-Pattern 2: Buying Backlinks (Black Hat)
What it looks like:
- Paying $50 to a shady site to link to you.
- Private Blog Networks (PBNs).
- Comment spamming.
Why it fails:
- Google's Penguin algorithm penalizes unnatural link profiles.
- Risk of Manual Action (de-indexing) which can kill a business overnight.
Correct approach:
- Create "Linkable Assets" (Original data, Infographics, Free Tools).
- Digital PR (News, Expert quotes via HARO).
- Guest posting on reputable, relevant industry sites.
❌ Anti-Pattern 3: Blocking JavaScript (The "Empty Shell")
What it looks like:
- Site content is loaded via AJAX/Fetch after page load.
- Source code (View Source) shows an empty div id="app".
- Content is visible to user but invisible to bots (or delayed).
Why it fails:
- Googlebot can render JS, but it's slower (Deferral Queue) and unreliable.
- Other bots (Bing, Facebook, Twitter/X) often fail completely.
- "Text to Code Ratio" is near zero.
Correct approach:
- Server-Side Rendering (SSR): Next.js, Nuxt.
- Static Site Generation (SSG): Gatsby, Astro.
- Dynamic Rendering: Serve static HTML to bots, JS to users (complex setup).
- Hydration: Send HTML first, then attach JS interactions.
❌ Anti-Pattern 4: The "Soft 404" Trap
What it looks like:
- Redirecting deleted product pages to the Homepage.
- Showing a "Page Not Found" message but returning a 200 OK status code.
Why it fails:
- Confuses Googlebot (thinks the homepage is the product page).
- Frustrates users (they expected a specific product).
Correct approach:
- 301 Redirect to the most relevant category or similar product.
- If no relevant page exists, serve a 410 Gone (tells Google to remove it faster than 404).
- Custom 404 page with search bar and popular links.
---
7. Quality Checklist
Technical Foundation:
- [ ] HTTPS: Site is secure (SSL certificate valid).
- [ ] Mobile: Pass Google's Mobile-Friendly Test (Responsive design).
- [ ] Speed: LCP < 2.5s, CLS < 0.1, INP < 200ms (Core Web Vitals).
- [ ] Indexing: No critical pages blocked by robots.txt or noindex tag.
- [ ] Sitemap: Clean XML sitemap (no 404s/redirects) submitted to GSC.
- [ ] Canonicals: Self-referencing canonicals on all pages to prevent duplication.
On-Page Elements:
- [ ] Title Tags: Unique, keyword-optimized, < 60 chars (no truncation).
- [ ] H1: Exactly one H1 per page, includes primary keyword.
- [ ] Images: Compressed (WebP), includes descriptive alt text with keywords.
- [ ] URLs: Short, descriptive, lowercase, hyphens (not underscores), no query strings if possible.
- [ ] Internal Links: 2-5 internal links to other relevant content per post.
Off-Page & Authority:
- [ ] Profile: Google Business Profile claimed, verified, and 100% completed (if local).
- [ ] Links: Backlink profile audit conducted (disavow toxic links if manual action risk).
- [ ] Social: Open Graph (OG) and Twitter Card tags configured for rich sharing.
- [ ] Citations: NAP (Name, Address, Phone) consistent across all directories.
Anti-Patterns
Technical SEO Anti-Patterns
- JavaScript Rendering Issues: Content loaded via JS not indexed - use SSR/SSG
- Slow Page Speed: Core Web Vitals failing - optimize images, code, and caching
- Duplicate Content: Multiple URLs serving same content - implement canonical tags
- Broken Links: 404 errors wasting crawl budget - regular link audits and fixes
Content Anti-Patterns
- Keyword Stuffing: Overusing keywords unnaturally - write for users, not bots
- Thin Content: Pages with little value - provide comprehensive information
- Ignoring User Intent: Content misaligned with search intent - understand user needs
- Content Staleness: Outdated content not updated - refresh content regularly
Link Building Anti-Patterns
- Paid Links: Buying links to manipulate rankings - earn links naturally
- Link Schemes: Manipulative link patterns - avoid PBNs and spam
- Broken Redirects: Redirect chains wasting crawl budget - direct redirects
- Anchor Text Over-Optimization: Unnatural anchor text - diversify anchor text
Migration Anti-Patterns
- URL Chaos: Changing URLs without redirects - preserve URL structure
- Content Loss: Moving content without preserving it - maintain content inventory
- Indexation Issues: Wrong pages indexed - control indexation properly
- Traffic Drop: Not monitoring post-migration - set up monitoring
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.