Content Brief from Gaps

SKILL.md

Full skill file your agent reads.

---
name: content-brief-from-gaps
description: Turns missing and opportunity prompts into blog/content briefs. Use when planning editorial, landing pages, or GEO content from AI visibility gaps.
---

# Content Brief from Gaps

## 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?status=missing
- [ ] get_project_prompts?status=opportunities
- [ ] get_project_sources (see what formats AI cites)
- [ ] get_project_snippets (voice + facts)
```

## Per prompt (top 5–10 by business priority)

```markdown
### Target prompt: "..."
**Status:** missing | opportunities
**Search intent:** ...
**Outline:** H2s...
**Must-include:** (facts from snippets)
**Cite-worthy angle:** stat, comparison, or checklist
**Internal links:** existing sources if any
```

Match formats AI already cites (listicles, vs pages, how-tos) from source titles.

Related skills

• Comparison Page WriterDraft vs pages from snippet gaps