Prompt Expansion

SKILL.md

Full skill file your agent reads.

---
name: prompt-expansion
description: Suggests new prompts to track based on winning clusters, competitor coverage, and source themes. Use when growing keyword/prompt coverage in AI SEO Tracker.
---

# Prompt Expansion

## Prerequisites

AI SEO Tracker MCP must be connected before running this skill.

1. Open AI SEO Tracker -> Project Settings -> Agent (`/p/{projectSlug}/settings/agent`).
2. Copy the MCP URL shown on that page (`https://aiseotracker.com/api/agent/mcp` for this environment).
3. Add it to your MCP-capable client. Cursor example:

```json
{
  "mcpServers": {
    "aiseotracker": {
      "url": "https://aiseotracker.com/api/agent/mcp"
    }
  }
}
```

4. Reload/restart your MCP client so it discovers the new server. In Cursor, reload the window after saving `.cursor/mcp.json`.
5. In Cursor, open Settings -> MCP, find `aiseotracker`, and click **Connect**.
6. Approve the AI SEO Tracker OAuth prompt in the browser. No API key or static token is required.
7. If a tool call returns `agent_auth_required`, the client has not completed OAuth yet. Reconnect/reload MCP from the Agent settings page and retry.

Available MCP tools:

- `get_project_sources` - citation URLs and domains; optional `domain` filter
- `get_project_prompts` - tracked prompts, visibility status, and ranks; optional `status`
- `get_project_snippets` - how AI describes a brand
- `get_project_competitors` - tracked competitor brands

## Workflow

```
- [ ] get_project_prompts (all)
- [ ] get_project_competitors
- [ ] get_project_sources
- [ ] get_project_snippets
```

## Output

1. **Themes** — cluster existing `query` strings by intent (3–6 themes)
2. **Whitespace** — 10–20 new prompt ideas competitors win but you do not track yet
3. **Defensive** — variations of winning prompts to protect
4. **Priority** — score each new prompt: volume proxy, commercial intent, citation opportunity

Format as a table the user can paste into AI SEO Tracker prompt import.

Do not add prompts already in the `get_project_prompts` list.

Related skills

• Weekly Visibility BriefMonday summary of wins, gaps, and moves