Using Gracker
Working with Prompts
Visibility Diagnosis

Visibility Diagnosis

Visibility Diagnosis answers one question for a prompt where your brand isn't getting cited: why not, and what should I do about it? It turns a lost prompt into a specific piece of work - either a page to write or an existing page to fix.

Visibility Diagnosis


What it does

Point Visibility Diagnosis at a prompt you're losing. It looks at the competitor pages AI is citing instead of you, checks whether you already have a page that answers the prompt, and returns one of two outcomes:

OutcomeYou getWhat it means
You already have contentA gap reportYour ranking page compared side-by-side with the competitor page that's winning, and what yours is missing
You have no contentA content briefAn outline of the page to write to compete for that prompt

Content briefs are produced per competitor citation; gap reports are produced per ranking page of yours. Even when you already have a page, a competitor covering a topic you don't yet will still return a brief. It all comes back grouped as one diagnosis run.


How it works

  1. We search your own site for a page that already answers the prompt.
  2. We pull the competitor pages AI cited for that prompt from your recent monitoring, and keep only the ones that are genuine competitors.
  3. Then we branch:
    • If you have a page, we compare it against the winning competitor page and write a gap report - one for each of your ranking pages. We also automatically kick off an AEO Audit on that ranking page, so its AEO + technical score is ready alongside the gap report.
    • If you don't, we write a content brief for each competitor citation.

Because step 2 reads the competitor citations your monitors captured, a diagnosis is only as complete as your recent monitoring. If a prompt hasn't been run lately, run its monitor first so the diagnosis has fresh citations to work from.


Running a diagnosis

  1. Find a prompt you're losing. Start from Lost Prompts or any prompt where a competitor is cited and you aren't.
  2. Run Visibility Diagnosis on that prompt.
  3. Open the result to see a brief (write new) or a gap report (fix existing) for each competitor page.
  4. Act on it - send a brief to Articles, or open the flagged page's AEO Audit (run automatically as part of the gap report) and work the gap report against it directly.

Reading the results

  • Content brief - an outline of the page to create, tied to the competitor page that earned the citation. This is your starting point when you have nothing ranking yet.
  • Gap report - your ranking page versus the competitor's, with what's missing. Each of your ranking pages gets its own report, paired with the competitor it's up against (or on its own if there's no clear match).
  • One row per competitor citation - all rows from a single run share the run, so you can work them as a set.

Visibility Diagnosis Detail

Find it: open any losing prompt → Diagnose


Where Visibility Diagnosis fits

Visibility Diagnosis is the bridge between seeing a gap and closing it.

When a diagnosis finds you already have a ranking page, it returns a gap report comparing that page against the winning competitor page - so you see exactly what it's missing, right next to the gap.

Limits & gotchas

  • Diagnosis reads the competitor citations your monitors captured recently. Run the prompt's monitor first if it hasn't run lately.
  • It needs your competitors set up - it uses them to tell real rivals apart from incidental links.
  • Results reflect the prompt at diagnosis time; re-run after you ship a fix to confirm you've closed the gap.

Next Steps