Weekly Visibility Brief

SKILL.md

Full skill file your agent reads.

---
name: weekly-visibility-brief
description: Produces a weekly AI visibility brief from prompts, sources, competitors, and snippets. Use when the user wants a Monday report, weekly recap, or visibility summary for stakeholders.
---

# Weekly Visibility Brief

## 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 statuses)
- [ ] get_project_sources (top domains)
- [ ] get_project_competitors
- [ ] get_project_snippets (own brand)
```

## Output format

1. **Headline** — one sentence on the week
2. **Wins** — prompts with `winning` status + rank highlights
3. **Gaps** — `missing` and `opportunities` with suggested actions
4. **Sources** — new or high-mention domains
5. **Competitive** — who gained on shared prompts
6. **Next week** — 3 prioritized moves

Keep it scannable. Use real numbers from MCP data only.

Related skills

• Prompt ExpansionFind new prompts from winning clusters