seo
affaan-m/everything-claude-code
Audit and optimize technical SEO, on-page elements, structured data, and content strategy for better search visibility.
What is seo?
This skill helps you improve search engine visibility through technical correctness, performance optimization, and content relevance. Use it when auditing crawlability, indexability, Core Web Vitals, structured data, keyword mapping, or planning internal linking and sitemap changes.
- Audit crawlability, indexability, canonicals, and redirect chains
- Optimize title tags, meta descriptions, and heading structure
- Add and validate structured data (JSON-LD schema markup)
- Improve Core Web Vitals (LCP, INP, CLS) and page performance
- Conduct keyword research and map keywords to URLs to avoid cannibalization
- Plan internal linking strategy and sitemap/robots.txt configuration
How to install seo
npx skills add https://github.com/affaan-m/everything-claude-code --skill seoHow to use seo
- 1.Identify the SEO problem area (technical, on-page, performance, or content)
- 2.Run an audit against the relevant checklist (crawlability, indexability, performance, or structured data)
- 3.Prioritize fixes by impact: resolve technical blockers before content optimization
- 4.Implement page-specific recommendations tied to actual URLs or assets
- 5.Validate changes using search console, schema validators, and performance tools
Use cases
- Fixing duplicate or missing title tags across product or category pages
- Adding Article or Product schema markup to improve rich snippet eligibility
- Diagnosing and resolving crawlability issues in robots.txt or redirect chains
- Mapping search intent to URLs and consolidating thin or duplicate content
- Optimizing page load performance to meet Core Web Vitals thresholds
- SEO specialists and content strategists
- Full-stack and frontend developers implementing SEO fixes
- Product managers planning content and site structure
- Technical founders auditing their own sites
seo FAQ
Crawlability is whether search engines can access and follow your pages (robots.txt, redirects, link depth). Indexability is whether those pages are allowed to appear in search results (noindex tags, canonical tags, duplicate content). Fix crawlability first.
No. Use schema only when the content genuinely matches the schema type. Homepage gets Organization or Business schema; articles get Article/BlogPosting; products get Product; Q&A sections get FAQPage only if truly Q&A content. Mismatched schema weakens trust.
Map one primary keyword or theme to one URL. Gather keyword variants, define search intent, and assign each intent to a single page. Use internal linking to reinforce which page is primary for that topic.
LCP (Largest Contentful Paint) < 2.5s, INP (Interaction to Next Paint) < 200ms, CLS (Cumulative Layout Shift) < 0.1. Common fixes include preloading hero assets, reducing render-blocking JavaScript, and reserving layout space for dynamic content.
Title tags: 50–60 characters. Meta descriptions: 120–160 characters. These are guidelines, not hard limits; prioritize clarity and human readability over character count.
Full instructions (SKILL.md)
Source of truth, from affaan-m/everything-claude-code.
name: seo description: Audit, plan, and implement SEO improvements across technical SEO, on-page optimization, structured data, Core Web Vitals, and content strategy. Use when the user wants better search visibility, SEO remediation, schema markup, sitemap/robots work, or keyword mapping. metadata: origin: ECC
SEO
Improve search visibility through technical correctness, performance, and content relevance, not gimmicks.
When to Use
Use this skill when:
- auditing crawlability, indexability, canonicals, or redirects
- improving title tags, meta descriptions, and heading structure
- adding or validating structured data
- improving Core Web Vitals
- doing keyword research and mapping keywords to URLs
- planning internal linking or sitemap / robots changes
How It Works
Principles
- Fix technical blockers before content optimization.
- One page should have one clear primary search intent.
- Prefer long-term quality signals over manipulative patterns.
- Mobile-first assumptions matter because indexing is mobile-first.
- Recommendations should be page-specific and implementable.
Technical SEO checklist
Crawlability
robots.txtshould allow important pages and block low-value surfaces- no important page should be unintentionally
noindex - important pages should be reachable within a shallow click depth
- avoid redirect chains longer than two hops
- canonical tags should be self-consistent and non-looping
Indexability
- preferred URL format should be consistent
- multilingual pages need correct hreflang if used
- sitemaps should reflect the intended public surface
- no duplicate URLs should compete without canonical control
Performance
- LCP < 2.5s
- INP < 200ms
- CLS < 0.1
- common fixes: preload hero assets, reduce render-blocking work, reserve layout space, trim heavy JS
Structured data
- homepage: organization or business schema where appropriate
- editorial pages:
Article/BlogPosting - product pages:
ProductandOffer - interior pages:
BreadcrumbList - Q&A sections:
FAQPageonly when the content truly matches
On-page rules
Title tags
- aim for roughly 50-60 characters
- put the primary keyword or concept near the front
- make the title legible to humans, not stuffed for bots
Meta descriptions
- aim for roughly 120-160 characters
- describe the page honestly
- include the main topic naturally
Heading structure
- one clear
H1 H2andH3should reflect actual content hierarchy- do not skip structure just for visual styling
Keyword mapping
- define the search intent
- gather realistic keyword variants
- prioritize by intent match, likely value, and competition
- map one primary keyword/theme to one URL
- detect and avoid cannibalization
Internal linking
- link from strong pages to pages you want to rank
- use descriptive anchor text
- avoid generic anchors when a more specific one is possible
- backfill links from new pages to relevant existing ones
Examples
Title formula
Primary Topic - Specific Modifier | Brand
Meta description formula
Action + topic + value proposition + one supporting detail
JSON-LD example
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Page Title Here",
"author": {
"@type": "Person",
"name": "Author Name"
},
"publisher": {
"@type": "Organization",
"name": "Brand Name"
}
}
Audit output shape
[HIGH] Duplicate title tags on product pages
Location: src/routes/products/[slug].tsx
Issue: Dynamic titles collapse to the same default string, which weakens relevance and creates duplicate signals.
Fix: Generate a unique title per product using the product name and primary category.
Anti-Patterns
| Anti-pattern | Fix |
|---|---|
| keyword stuffing | write for users first |
| thin near-duplicate pages | consolidate or differentiate them |
| schema for content that is not actually present | match schema to reality |
| content advice without checking the actual page | read the real page first |
| generic “improve SEO” outputs | tie every recommendation to a page or asset |
Related Skills
seo-specialistfrontend-patternsbrand-voicemarket-research
Related skills
More from affaan-m/everything-claude-code and the wider catalog.
security-review
Security checklist and patterns for authentication, input validation, secrets, and sensitive features.
golang-patterns
Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable applications.
coding-standards
Baseline coding conventions for naming, readability, immutability, and quality across projects.
frontend-patterns
React and Next.js patterns for components, state management, performance, and modern frontend practices.
backend-patterns
REST/GraphQL API design, database optimization, and server-side patterns for Node.js, Express, and Next.js.
golang-testing
Go testing patterns: table-driven tests, subtests, benchmarks, fuzzing, and TDD methodology.