seo
affaan-m/ecc
Audit and implement technical SEO, on-page optimization, structured data, and content strategy for better search visibility.
What is seo?
This skill guides you through SEO improvements across technical correctness, performance, and content relevance. Use it when auditing crawlability, improving title tags and meta descriptions, adding structured data, optimizing Core Web Vitals, mapping keywords, or planning internal linking and sitemaps.
- 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 specific URLs without cannibalization
- Plan internal linking, sitemaps, and robots.txt rules
How to install seo
npx skills add null --skill seoHow to use seo
- 1.Identify the SEO problem (crawlability, indexability, performance, or content relevance)
- 2.Run an audit using the provided checklists (robots.txt, canonicals, title tags, Core Web Vitals)
- 3.Prioritize fixes: technical blockers before content optimization
- 4.Generate page-specific recommendations tied to actual URLs or assets
- 5.Implement fixes (e.g., update title tags, add JSON-LD, preload assets, fix redirects)
- 6.Validate changes (check indexability, measure Core Web Vitals, confirm schema validity)
Use cases
- Fixing duplicate title tags or meta descriptions across product pages
- Adding Article or Product schema to improve rich snippet eligibility
- Reducing Largest Contentful Paint by preloading hero assets and removing render-blocking work
- Consolidating thin or near-duplicate pages that compete for the same keyword
- Mapping a keyword cluster to a single authoritative URL with supporting internal links
- SEO specialists and content strategists
- Full-stack developers implementing SEO fixes
- Product managers responsible for search visibility
- Content teams planning keyword strategy
- Technical founders auditing their site's search foundation
seo FAQ
Fix technical blockers first. Crawlability, indexability, and performance issues prevent content from ranking regardless of keyword relevance. Then optimize on-page elements and content.
Map one primary keyword or theme to one URL. Use keyword research to define search intent, gather variants, prioritize by intent match and competition, and detect pages competing for the same keyword.
LCP (Largest Contentful Paint) < 2.5s, INP (Interaction to Next Paint) < 200ms, and CLS (Cumulative Layout Shift) < 0.1. Common fixes include preloading hero assets, reducing render-blocking JavaScript, and reserving layout space.
Use it when the content genuinely matches the schema type: Organization/Business on homepage, Article/BlogPosting on editorial pages, Product/Offer on product pages, BreadcrumbList on interior pages, and FAQPage only for actual Q&A content.
Aim for 50–60 characters for title tags (put primary keyword near the front) and 120–160 characters for meta descriptions. Write for humans first, not search engines.
Full instructions (SKILL.md)
Source of truth, from affaan-m/ecc.
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/ecc and the wider catalog.
skill-comply
Measure whether agents actually follow skills, rules, and definitions across prompt strictness levels.
skill-scout
Search local, marketplace, GitHub, and web sources before creating a new skill.
skill-stocktake
Audit Claude skills and commands for quality, overlap, and currency using AI judgment.
social-graph-ranker
Weighted graph-ranking engine for discovering warm intro paths and bridge value across X and LinkedIn.
social-publisher
Schedule and publish social media posts across 13 platforms via SocialClaw API.
springboot-patterns
Spring Boot architecture patterns, REST API design, layered services, and production-grade backend patterns.