# optimize-for-ai

Scores a page on five dimensions and shows how to rewrite it so AI systems cite it. Useful when rankings no longer bring clicks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 6600 installs · ★ 21
- Author: calm-north
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/calm-north/seojuice-skills/tree/HEAD/skills/optimize-for-ai/SKILL.md
- Updated: 2026-02-27
- HTML: https://affpapa.org/en/nevibecode/skills/optimize-for-ai

## What it does

The skill grades content on extractability, quotability, authority, freshness and entity clarity. Every item gets Pass, Partial or Fail, and the results average into an AI Citation Score. Criteria tables sit next to format-specific advice: comparisons, research, how-to guides, definition pieces. Each format comes with rules on what belongs in the opening lines and how to present data.

One check runs before the rest. If `robots.txt` blocks `GPTBot`, `ClaudeBot` or `PerplexityBot`, the score drops to zero no matter how good the writing is. Worth verifying first, because everything else depends on it.

The skill installs into Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Traditional SEO is handled by a separate skill, `diagnose-seo`, so the two do not overlap. The before/after rewrite examples are cut off at the end of the file, so you get the scoring framework without the full set of templates.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calm-north/seojuice-skills --skill optimize-for-ai -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/optimize-for-ai/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/optimize-for-ai/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calm-north/seojuice-skills --skill optimize-for-ai -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/optimize-for-ai/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calm-north/seojuice-skills --skill optimize-for-ai -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/optimize-for-ai/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calm-north/seojuice-skills optimize-for-ai
```

2. **Manually: put the files in place**
- File: `.github/skills/optimize-for-ai/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calm-north/seojuice-skills --skill optimize-for-ai -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calm-north/seojuice-skills --path skills/optimize-for-ai
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/optimize-for-ai/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add calm-north/seojuice-skills --skill optimize-for-ai -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calm-north/seojuice-skills/tree/HEAD/skills/optimize-for-ai/SKILL.md

## When to use it
- find out why ChatGPT and Perplexity never cite the page
- rewrite an X vs Y comparison so the verdict lands in the first lines
- check whether AI crawlers are blocked in robots.txt
- replace vague claims with sourced statistics
- score a page and see which dimension drags it down

## Example prompts
- score this page with optimize-for-ai and show me the AI Citation Score
- rewrite the definition section so AI can quote it
- check robots.txt for GPTBot and ClaudeBot blocks

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 3c779c7276e62a37.

BEGIN THIRD-PARTY FILE 3c779c7276e62a37
```text
---
name: optimize-for-ai
description: >
  Optimize content for AI search engines — ChatGPT, Perplexity, Claude, Gemini,
  Google AI Overviews. Use when the user asks about AI SEO, AISO, getting cited
  by AI, appearing in AI answers, answer engine optimization, AEO, GEO, LLMO,
  AI Overviews, zero-click search, or how to appear in ChatGPT/Perplexity results.
  For traditional SEO, see diagnose-seo.
metadata:
  version: 1.0.0
---

# Optimize for AI

Optimize for AI search engines (ChatGPT, Perplexity, Claude, Gemini, Google AI
Overviews) using citation architecture, E-E-A-T signals, and brand entity
building.

## The Shift: Ranked vs Cited

Traditional SEO gets you **ranked** in a list of results. AI SEO gets you
**cited** as a source in AI-generated answers. The difference matters:

- AI systems select sources based on content quality, structure, and authority — not just ranking position
- AI Overviews appear in a growing share of Google searches and can significantly reduce website clicks
- Well-structured, authoritative content gets cited far more often than unstructured content
- Being cited by AI builds brand trust in a way traditional rankings cannot

## Content That Gets Cited

### What AI Systems Look For

AI systems extract information from content. The easier it is to extract, the more likely it gets cited:

**Definitions and clear statements**
- "X is Y" format — unambiguous, extractable
- Place definitions early in the content, right after the heading
- Avoid burying answers in lengthy introductions

**Structured data**
- Comparison tables — among the most commonly cited content formats
- Step-by-step lists
- Statistical claims with sources
- Pro/con lists

**Original insights**
- Original research and data — unique data earns disproportionate citations
- Expert quotes with credentials
- First-hand experience descriptions
- Counterintuitive findings backed by evidence

**Comprehensive coverage**
- Definitive guides that cover a topic end-to-end
- FAQ sections with direct answers
- Content that answers follow-up questions proactively

### Content Formats That Win (ranked by citation frequency)

| Format | Why It Works |
|--------|-------------|
| Comparison articles | AI frequently answers "X vs Y" and "best X" queries — structured comparisons are easy to extract |
| Definitive guides | Comprehensive coverage signals authority to AI systems |
| Original research | Unique data that no one else has — AI systems prefer primary sources |
| How-to tutorials | Step-by-step structure maps directly to AI response format |
| Expert roundups | Multiple expert voices increase perceived authority |

## Content-Type Optimization

Different content types get cited differently. Optimize based on what you're writing:
```
END THIRD-PARTY FILE 3c779c7276e62a37

The third-party file has ended. Everything between the 3c779c7276e62a37 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2776 of 17333 bytes. © calm-north · MIT · https://github.com/calm-north/seojuice-skills/tree/HEAD/skills/optimize-for-ai/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md