Agent skill
seo-optimization
Optimize websites for search engines including on-page SEO, technical SEO, meta tags, schema markup, Core Web Vitals, and keyword optimization. Use when improving search rankings, auditing SEO, or optimizing content for Google.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/marketing/seo-optimization
SKILL.md
SEO Optimization Skill
Instructions
When optimizing for SEO:
1. On-Page SEO
Title Tags:
- 50-60 characters max
- Primary keyword near the beginning
- Include brand name at end
- Make it compelling and clickable
<title>Primary Keyword - Secondary Keyword | Brand Name</title>
Meta Descriptions:
- 150-160 characters
- Include primary keyword
- Call-to-action
- Unique for each page
<meta name="description" content="Compelling description with keyword that encourages clicks. Learn more about X today!">
Heading Structure:
<h1>One H1 per page with primary keyword</h1>
<h2>Section headings with secondary keywords</h2>
<h3>Subsections for organization</h3>
2. Technical SEO
Essential Meta Tags:
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="robots" content="index, follow">
<link rel="canonical" href="https://example.com/page/">
Open Graph (Social Sharing):
<meta property="og:title" content="Page Title">
<meta property="og:description" content="Description">
<meta property="og:image" content="https://example.com/image.jpg">
<meta property="og:url" content="https://example.com/page/">
<meta property="og:type" content="website">
Twitter Cards:
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Page Title">
<meta name="twitter:description" content="Description">
<meta name="twitter:image" content="https://example.com/image.jpg">
3. Schema Markup (JSON-LD)
Organization:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Company Name",
"url": "https://example.com",
"logo": "https://example.com/logo.png",
"contactPoint": {
"@type": "ContactPoint",
"telephone": "+1-xxx-xxx-xxxx",
"contactType": "customer service"
},
"sameAs": [
"https://facebook.com/company",
"https://twitter.com/company"
]
}
Product:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Product Name",
"image": "https://example.com/product.jpg",
"description": "Product description",
"brand": {"@type": "Brand", "name": "Brand"},
"offers": {
"@type": "Offer",
"price": "49.99",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "124"
}
}
Article/Blog Post:
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "Article Title",
"author": {"@type": "Person", "name": "Author Name"},
"datePublished": "2025-01-15",
"dateModified": "2025-01-20",
"image": "https://example.com/article-image.jpg"
}
FAQ:
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [{
"@type": "Question",
"name": "Question text?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Answer text."
}
}]
}
4. Core Web Vitals
LCP (Largest Contentful Paint) < 2.5s:
- Optimize images (WebP, lazy loading)
- Preload critical assets
- Use CDN
FID (First Input Delay) < 100ms:
- Minimize JavaScript
- Break up long tasks
- Use web workers
CLS (Cumulative Layout Shift) < 0.1:
- Set image dimensions
- Reserve space for ads/embeds
- Avoid inserting content above existing content
5. Image SEO
<img
src="image.webp"
alt="Descriptive alt text with keyword"
width="800"
height="600"
loading="lazy"
decoding="async"
>
6. URL Structure
Good:
example.com/category/product-nameexample.com/blog/how-to-do-something
Avoid:
example.com/p?id=123example.com/category/sub/sub/page
7. Internal Linking
- Use descriptive anchor text
- Link to related content
- Create topic clusters
- Maintain reasonable link depth (3 clicks max)
8. SEO Checklist
- Unique title tag with keyword
- Meta description with CTA
- One H1 with primary keyword
- Schema markup implemented
- Images optimized with alt text
- Internal links added
- Mobile-friendly
- Page speed optimized
- Canonical URL set
- XML sitemap updated
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?