Skip to main content
skill CX Codex

seo-visibility-expert — Claude Code skill: what it does and setup

seo-visibility-expert configures technical SEO, llms.txt files for AI scrapers, and schema markup. Useful when preparing web projects for launch.

MIT 224 installs ★ 274 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a claude-code
Open on GitHub

What seo-visibility-expert does

This skill guides search visibility across traditional search engines and AI answer engines. It generates llms.txt files, JSON-LD structured data, and tailored robots.txt rules that permit bots like GPTBot or Claude-Web. It also provides timing templates for launches on Product Hunt, Hacker News, and Reddit.

Speed targets are strict. The instructions enforce Core Web Vitals targets: LCP under 2.5s, INP under 200ms, and CLS below 0.1. To inspect projects, the skill uses file inspection and network tools including Glob, Grep, Bash, and WebFetch.

This skill does not handle PPC ads, email marketing, or paid social campaigns.

What it helps with

  • generate an llms.txt file and configure robots.txt for AI crawlers
  • add JSON-LD structured data for rich search snippets
  • audit page metadata, canonical links, and Open Graph tags
  • plan launch timing for Product Hunt, Hacker News, and Reddit

Example prompts for the agent

  • Generate an llms.txt file and configure robots.txt for AI crawlers
  • Audit our landing page metadata and check Core Web Vitals metrics
  • Prepare the launch checklist for Hacker News and Product Hunt

How to install seo-visibility-expert

1Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-visibility-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-visibility-expert/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-visibility-expert

How do I install seo-visibility-expert in Claude Code?

Run npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a claude-code. The skill will be placed at ~/.claude/skills/seo-visibility-expert/SKILL.md.

What does seo-visibility-expert do?

It handles technical SEO audits, JSON-LD schema setup, AI crawler optimization, and social launch checklists for web applications.

Can seo-visibility-expert help with paid advertising?

No. The skill explicitly excludes PPC advertising, paid marketing, and social media content creation.

Source text

SKILL.md · MIT
---
name: seo-visibility-expert
description: 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,
  HN, Reddit), and Answer Engine Optimization (AEO). Activate on 'SEO', 'discoverability', 'llms.txt', 'robots.txt', 'Product Hunt', 'launch strategy', 'get traffic', 'be found', 'search ranking'. NOT for
  paid advertising, PPC campaigns, or social media content creation (use marketing skills).
allowed-tools: Read,Write,Edit,Bash,Glob,Grep,WebFetch,WebSearch
metadata:
  category: Business & Monetization
  pairs-with:
  - skill: claude-ecosystem-promoter
    reason: Promote with SEO backing
  - skill: technical-writer
    reason: SEO-optimized documentation
  tags:
  - seo
  - llms-txt
  - discoverability
  - product-hunt
  - aeo
---

# SEO & Visibility Expert

Get your web projects discovered by both traditional search engines AND AI systems.

## Quick Start

1. **Create llms.txt** at site root → AI crawlers find your content
2. **Add JSON-LD schema** → Rich snippets in search results
3. **Verify robots.txt** → Allow good bots, block bad ones
4. **Generate sitemap.xml** → Help crawlers index everything
5. **Check Core Web Vitals** → PageSpeed Insights score >90
6. **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

```html
<!-- 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

```markdown
# 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 `references/launch-checklists.md` for full checklist

### Hacker News
- Post 6-8 AM PST, Tuesday-Thursday
- Title: `Show HN: [Tool] – [Plain English description]`
- Be technical, humble, genuine
- Respond to every comment

### Reddit
- 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) | &lt;2.5s | 2.5-4s | &gt;4s |
| INP (Interaction to Next Paint) | &lt;200ms | 200-500ms | &gt;500ms |
| CLS (Cumulative Layout Shift) | &lt;0.1 | 0.1-0.25 | &gt;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:**
1. Organic search impressions/clicks
2. Referral traffic from social launches
3. Core Web Vitals scores
4. AI citations (search your brand in ChatGPT/Claude)

## Reference Files

| File | Contents |
|------|----------|
| `references/llms-txt-examples.md` | Full llms.txt examples for SaaS, docs, OSS, blogs |
| `references/schema-templates.md` | JSON-LD templates for all content types |
| `references/launch-checklists.md` | 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)

© curiositech · MIT · curiositech/some_claude_skills

Similar skills

All skills for SEO and GEO →

From the same set180

The whole set →
grief-companion grief-companion is a Claude Code skill for grief education, memorial writing, and practical tasks after a loss. It responds to requests about bereavement, remembrance, or handling affairs after a death. CX Codex +1 229installs crisis-detection-intervention-ai The crisis-detection-intervention-ai skill detects crisis signals in user text and routes them through a safer escalation flow. It fits support, recovery, and mental health apps. CX Codex +1 227installs drone-inspection-specialist drone-inspection-specialist — a skill for drone footage analysis: fire detection, roof and hail inspection, thermal checks, and 3D Gaussian Splatting reconstruction. CX Codex +1 227installs drizzle-migrations drizzle-migrations — a skill for schema work with Drizzle ORM on SQLite: tables, columns, indexes, migration generation and applying them. Fits projects where schema changes need to stay repeatable. CX Codex +1 226installs mcp-creator mcp-creator is a Claude Code skill for building MCP servers that connect agents to external services. It activates on requests to create or develop an MCP server. CX Codex +1 222installs chatbot-analytics chatbot-analytics adds conversation monitoring and token usage tracking for AI chats while respecting HIPAA constraints. CX Codex +1 221installs technical-writer technical-writer structures developer docs, API references, ADRs, and runbooks using the Diátaxis framework with working code examples. CX Codex +1 221installs reactive-dashboard-performance reactive-dashboard-performance sets up React dashboard performance patterns and speeds up async test suites. Helps replace spinners with skeletons and resolve test runner timeouts. CX Codex +1 220installs

Project sponsors

Companies that keep this analytics open