Some_claude_skills seo-visibility-expert
Comprehensive SEO, discoverability, and AI crawler optimization for web projects. Use for technical SEO audits, llms.txt/robots.txt setup, schema markup, social launch strategies (Product Hunt,
git clone https://github.com/curiositech/some_claude_skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/curiositech/some_claude_skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/seo-visibility-expert" ~/.claude/skills/curiositech-some-claude-skills-seo-visibility-expert && rm -rf "$T"
.claude/skills/seo-visibility-expert/SKILL.mdSEO & Visibility Expert
Get your web projects discovered by both traditional search engines AND AI systems.
Quick Start
- Create llms.txt at site root → AI crawlers find your content
- Add JSON-LD schema → Rich snippets in search results
- Verify robots.txt → Allow good bots, block bad ones
- Generate sitemap.xml → Help crawlers index everything
- Check Core Web Vitals → PageSpeed Insights score >90
- Add Open Graph tags → Beautiful social previews
When to Use
Use for:
- Technical SEO audits and fixes
- llms.txt for AI crawlers
- Schema.org/JSON-LD structured data
- Launch strategies (Product Hunt, HN, Reddit)
- Core Web Vitals optimization
NOT for:
- Paid advertising/PPC campaigns
- Social media content creation
- Email marketing campaigns
The Modern Discovery Stack
┌─────────────────────────────────────────────┐ │ AI ANSWER ENGINES │ │ ChatGPT, Claude, Perplexity, Google AI │ │ → llms.txt, structured data, AEO │ ├─────────────────────────────────────────────┤ │ TRADITIONAL SEARCH │ │ Google, Bing, DuckDuckGo │ │ → Technical SEO, content, backlinks │ ├─────────────────────────────────────────────┤ │ SOCIAL DISCOVERY │ │ Product Hunt, HN, Reddit, Twitter/X │ │ → Launch timing, community, narratives │ └─────────────────────────────────────────────┘
Technical SEO Essentials
Metadata Must-Haves
<!-- Every page needs these --> <title>Primary Keyword | Brand Name</title> <meta name="description" content="150-160 chars with keywords"> <link rel="canonical" href="https://yoursite.com/page"> <!-- Open Graph for social --> <meta property="og:title" content="Title for social shares"> <meta property="og:image" content="https://yoursite.com/og-image.png">
URL Rules
- Lowercase, hyphen-separated
- Include primary keyword
- Keep under 60 characters
- No query parameters for content pages
AI Crawler Optimization (AEO)
llms.txt Quick Template
# Your Site Name > Brief tagline describing what you do ## Overview 2-3 sentences for AI systems. ## Key Features - Feature 1: Description - Feature 2: Description ## Documentation - [Getting Started](/docs/getting-started) - [API Reference](/docs/api)
robots.txt for AI Era
# AI Crawlers - Allow them! User-agent: GPTBot Allow: / User-agent: Claude-Web Allow: / User-agent: PerplexityBot Allow: / # Sitemaps Sitemap: https://yoursite.com/sitemap.xml
Decision tree:
- Want AI to reference your content? → Allow GPTBot, Claude-Web
- Training data concerns? → Disallow Google-Extended
Social Launch Quick Guide
Product Hunt
- Launch at 12:01 AM PST exactly
- Best days: Tuesday, Wednesday, Thursday
- Never ask for upvotes directly → "Would love your feedback!"
- See
for full checklistreferences/launch-checklists.md
Hacker News
- Post 6-8 AM PST, Tuesday-Thursday
- Title:
Show HN: [Tool] – [Plain English description] - Be technical, humble, genuine
- Respond to every comment
- Participate before promoting (90/10 rule)
- Find niche subreddits for your domain
- r/SideProject, r/webdev, r/InternetIsBeautiful
Core Web Vitals Targets
| Metric | Good | Needs Work | Poor |
|---|---|---|---|
| LCP (Largest Contentful Paint) | <2.5s | 2.5-4s | >4s |
| INP (Interaction to Next Paint) | <200ms | 200-500ms | >500ms |
| CLS (Cumulative Layout Shift) | <0.1 | 0.1-0.25 | >0.25 |
Quick fixes: Optimize images (LCP), minimize JS (INP), set explicit dimensions (CLS)
Anti-Patterns
1. "Build It and They Will Come"
Symptom: Great product, zero traffic Fix: Spend 50% of time on marketing/distribution
2. Ignoring AI Crawlers
Symptom: No llms.txt, blocking AI user agents Fix: Create llms.txt, allow AI crawlers in robots.txt
3. Keyword Stuffing
Symptom: Unnatural keyword repetition Fix: Write for humans first, keywords naturally
4. Launch and Abandon
Symptom: Big launch, then silence Fix: Build in public, regular updates, consistent presence
5. No Schema Markup
Symptom: Plain search results, no rich snippets Fix: Add JSON-LD for your content type (see references)
6. Ignoring Mobile
Symptom: Desktop-only testing Fix: Mobile-first indexing is default. Test on devices.
Measurement
Free tools:
- Google Search Console - Search performance
- PageSpeed Insights - Core Web Vitals
- Schema Validator - Structured data testing
Track these:
- Organic search impressions/clicks
- Referral traffic from social launches
- Core Web Vitals scores
- AI citations (search your brand in ChatGPT/Claude)
Reference Files
| File | Contents |
|---|---|
| Full llms.txt examples for SaaS, docs, OSS, blogs |
| JSON-LD templates for all content types |
| Detailed checklists for PH, HN, Reddit |
Covers: Technical SEO | AI Crawler Optimization | Social Launch Strategy | Core Web Vitals | Schema Markup
Use with: content-marketer (content strategy) | web-design-expert (landing pages) | indie-monetization-strategist (conversion)