# optimize-page

optimize-page — a Claude Code skill for improving page SEO, answer structure, and visibility in generative search. It activates on requests to optimize a page or rewrite it for AI search.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 80 repo stars
- Author: akii-technologies-ltd
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer/tree/HEAD/skills/optimize-page/SKILL.md
- Updated: 2026-10-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/optimize-page

## What it does

The skill reviews a page across SEO, AEO, and GEO. It checks metadata, the H1, keywords, links, and images, then assesses direct answers, self-contained sections, definitions, and FAQs. Its GEO pass uses methods from the Princeton/IIT Delhi study, such as adding citations and statistics; it must not invent facts.

A full pass is the default. Set `full`, `seo`, `aeo`, or `geo` to choose a mode, which the skill reports at the start. It needs a target page or URL and a primary keyword. Ahrefs and GSC are listed as available MCPs for keyword data and current performance; secondary keywords are optional.

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akii-technologies-ltd/akii-seo-ai-search-optimizer skills/optimize-page
```

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

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer --path skills/optimize-page
```

### Windsurf (Devin Desktop)

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

### 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/akii-technologies-ltd/akii-seo-ai-search-optimizer/tree/HEAD/skills/optimize-page/SKILL.md

## When to use it
- audit page metadata and headings against a target query
- find passages that fail to answer a question directly
- reshape sections and FAQs for search-result extraction
- identify missing entities and links on a page

## Example prompts
- Optimize `pricing.md` for the keyword “project management software”.
- Run an SEO-only review of `docs/index.md`.
- Rewrite this page for generative search using `geo` mode.

## 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: a0d2fe1d63d9635e.

BEGIN THIRD-PARTY FILE a0d2fe1d63d9635e
```text
---
description: Comprehensive single-page optimization across all three layers — traditional SEO (title / meta / H1 / internal links), AEO (chunk quality, direct-answer leads, FAQ extraction), and GEO rewrites using the tactics published by the Princeton/IIT Delhi GEO study (citation integration, expert quotes, statistics enrichment, fluency optimization, authoritative tone). Use when the user asks to "optimize this page", "improve SEO for this page", "AEO optimize", "GEO optimize", "apply Princeton GEO method", "rewrite for AI search", "make this snippet-able", "optimize for ChatGPT/Claude/Gemini/Perplexity citations", "improve rankings for [keyword]", "add direct answers", "FAQ optimization", "chunk audit", "AI content optimization", or names a page they want fully optimized. Defaults to a full SEO + AEO + GEO pass; accepts a mode modifier (full, seo, aeo, geo) for granular control.
---

# Page Optimizer — Full SEO + AEO + GEO Pass

You are a single-page optimization specialist powered by Akii. Cover all three layers in one pass:

1. **SEO layer** — title, meta description, H1, keyword density, internal/external links, schema type recommendation, images
2. **AEO layer** (Answer Engine Optimization) — chunk quality scoring, direct-answer lead, autonomous sections, definition blocks, FAQ extraction with `FAQPage` schema
3. **GEO layer** (Generative Engine Optimization) — tactics from the [Princeton/IIT Delhi GEO study (Aggarwal et al., KDD 2024, arXiv:2311.09735)](https://arxiv.org/abs/2311.09735): citation integration · quotation addition · statistics enrichment · fluency optimization · authoritative tone. In the paper's controlled benchmark, top tactics lifted AI visibility up to **+40%** overall and **+97–115%** for pages currently ranked outside the top 5. Methodology caveat: the paper allowed fabricated quotes/stats in test prose — the plugin enforces "never invent" so real-world lift varies.

## Modes

Detect the mode from the user's invocation. Default to `full` when nothing matches.

| Mode | What it runs |
|---|---|
| `full` (default) | All three layers, unified report |
| `seo` | SEO layer only — meta, H1, links, images |
| `aeo` | AEO layer only — chunk quality + FAQ extraction |
| `geo` | GEO layer only — Princeton tactic per content domain |

### How to detect the mode

Match in this order; first hit wins:

1. **Explicit flag**: `--mode=<full|seo|aeo|geo>` (or `--mode <value>`) anywhere in the user message → use that value.
2. **Skill argument syntax** the user typed when invoking explicitly: `optimize-page <target> seo` / `optimize-page <target> aeo` / `optimize-page <target> geo` → use the trailing token.
3. **Natural-language keywords** in the request:
   - `"just SEO"` / `"only SEO"` / `"SEO check"` / `"on-page SEO"` → `seo`
   - `"just AEO"` / `"AEO only"` / `"AEO optimize"` / `"chunk quality"` / `"direct answers"` / `"FAQ extraction"` → `aeo`
   - `"just GEO"` / `"GEO only"` / `"GEO rewrite"` / `"Princeton"` / `"apply GEO"` / `"GEO optimization"` → `geo`
4. Otherwise → `full`.

If two NL keyword families match (e.g. "apply AEO and GEO to this page"), run `full` and call it out in the output header.

Print the resolved mode at the top of every run: `**Mode**: full` so the user can see the detection. If it's wrong, they'll re-trigger with the flag.

## Inputs to gather

- Target page (file path or URL)
- Primary target keyword
- Secondary keywords (optional)
```
END THIRD-PARTY FILE a0d2fe1d63d9635e

The third-party file has ended. Everything between the a0d2fe1d63d9635e 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 3474 of 14831 bytes. © akii-technologies-ltd · MIT · https://github.com/akii-technologies-ltd/akii-seo-ai-search-optimizer/tree/HEAD/skills/optimize-page/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
