Setup
On first use, read setup.md for workspace integration.
When to Use
Agent needs to handle SEO: site audits, content optimization, keyword research, technical fixes, link strategies, local SEO, schema markup, or ranking improvements.
Architecture
SEO workspace at ~/seo/. See memory-template.md for setup.
~/seo/
├── memory.md # Site profiles, audit history, keyword tracking
├── audits/ # Site audit reports
└── content/ # SEO content drafts
Quick Reference
| Topic | File |
|---|---|
| Title tags, meta descriptions, headers, keyword placement | on-page.md |
| Core Web Vitals, crawlability, mobile, indexing | technical.md |
| Search intent, E-E-A-T, content writing | content.md |
| Google Business, NAP consistency, local keywords | local.md |
| JSON-LD, Article, LocalBusiness, FAQ, Product schema | schema.md |
| Internal linking, anchor text, backlink strategies | links.md |
| Keyword research and competitive analysis | keywords.md |
Core Rules
1. Audit Before Action
Run complete site audit before recommendations. Check: indexing, crawl errors, Core Web Vitals, mobile usability, duplicate content, broken links. No guessing.
2. Search Intent First
Match content format to query intent. Informational → guides. Transactional → product pages. Commercial → comparisons. Wrong format = no ranking.
3. Content That Ranks
Write SEO content that serves users AND search engines. Answer the query in first 100 words. Cover topic comprehensively. Include LSI keywords naturally. Add FAQ section for People Also Ask.
4. Technical Foundation
Core Web Vitals: LCP < 2.5s, INP < 200ms, CLS < 0.1. Mobile-first. HTTPS. Canonical URLs. Clean sitemap. No blocked resources. Technical issues kill rankings.
5. E-E-A-T Signals
Experience, Expertise, Authoritativeness, Trustworthiness. Author bios with credentials. About page. External citations. Especially critical for YMYL topics.
6. Link Strategy
Internal linking builds topical authority. Anchor text matters. External links to authoritative sources help. Never buy links or participate in schemes.
7. Measure Everything
Track rankings, organic traffic, CTR, conversions. Use Search Console data. Iterate based on results, not assumptions.
SEO Audit Checklist
Indexing:
[ ] Site indexed in Google (site:domain.com)
[ ] No important pages blocked in robots.txt
[ ] XML sitemap submitted to Search Console
[ ] No noindex on pages that should rank
Technical:
[ ] Core Web Vitals passing
[ ] Mobile-friendly
[ ] HTTPS with no mixed content
[ ] No crawl errors in Search Console
[ ] Clean URL structure
On-Page:
[ ] Unique title tags (50-60 chars)
[ ] Meta descriptions (150-160 chars)
[ ] One H1 per page with keyword
[ ] Proper heading hierarchy
[ ] Images with alt text
[ ] Internal links
Content:
[ ] Search intent matched
[ ] Comprehensive coverage
[ ] No thin content
[ ] No duplicate content
[ ] Fresh and updated
Off-Page:
[ ] Google Business Profile (local)
[ ] Quality backlink profile
[ ] No toxic links
Content Writing Process
Keyword research — Find target keyword, search volume, difficulty
Intent analysis — What format ranks? What do users want?
Outline — Cover all subtopics competitors cover + more
Write — Answer query fast, be comprehensive, natural keywords
Optimize — Title, meta, headers, internal links, schema
Publish — Submit to Search Console, monitor rankings
Common Traps
Writing content without checking search intent → won't rank
Ignoring Core Web Vitals → rankings tank
Keyword stuffing → penalties
Duplicate title tags → wasted crawl budget
No internal linking → poor topical authority
Buying links → manual action risk
Related Skills
Install with clawhub install <slug> if user confirms:
content-marketing— Content strategyanalytics— Traffic analysismarket-research— Competitive analysishtml— HTML optimizationweb— Web development
Feedback
If useful:
clawhub star seoStay updated:
clawhub sync