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
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a claude-codeWhat 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.txtfile and configurerobots.txtfor 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.txtfile and configurerobots.txtfor 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-code2Manually: put the files in place
~/.claude/skills/seo-visibility-expert/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-visibility-expert/
1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a codex2Manually: put the files in place
.agents/skills/seo-visibility-expert/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a cursor2Manually: put the files in place
.cursor/skills/seo-visibility-expert/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install curiositech/some_claude_skills .claude/skills/seo-visibility-expert2Manually: put the files in place
.github/skills/seo-visibility-expert/SKILL.md1Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a gemini-cli2Platform CLI
gemini skills install https://github.com/curiositech/some_claude_skills --path .claude/skills/seo-visibility-expertManually: put the files in place
.devin/skills/seo-visibility-expert/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add curiositech/some_claude_skills --skill seo-visibility-expert -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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) | <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:**
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