# Diagnose AI Visibility

Find out why AI search engines leave your brand out of an answer, and pick the one fix...

- Repository: https://github.com/ParadevAI/Paradev (15823 stars)
- Category: Marketing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ParadevAI/Paradev --skill diagnose-ai-visibility -g -a claude-code -y`
Codex: `npx skills add ParadevAI/Paradev --skill diagnose-ai-visibility -g -a codex -y`
Cursor: `npx skills add ParadevAI/Paradev --skill diagnose-ai-visibility -g -a cursor -y`
Gemini CLI: `npx skills add ParadevAI/Paradev --skill diagnose-ai-visibility -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ParadevAI/Paradev`

## Description

Find out why AI search engines leave your brand out of an answer, and pick the one fix that matches the cause, read the answers and the sources they cite, map the question to your own page, then decide if the page is broken, missing, weak, or outweighed by third-party sources. Use when the user asks why ChatGPT, Gemini, Perplexity or Google AI Overviews do not mention them, which prompts they lose, what content to write next, or how to improve AI visibility.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Diagnose before you create

A lost prompt has one of four causes, and each cause has a different fix. A new
page is the right fix for only one of them. Find the cause first.

## 1. Pick the prompts to diagnose

Run `list_projects`, then `list_brands` to find the brand with `is_own: true`.
If the user named no prompt, run `get_brand_report` for the last 14 days,
broken down by prompt, and take the 10 non-branded prompts with the lowest
visibility. Skip branded prompts: they measure recognition, not demand.

## 2. Read what the engines actually answered

For each prompt, run `list_chats` for the same window and `get_chat` on two or
three of them, from different engines. Record:

- the brands the answer named, and their order
- the `sources` it retrieved and the `links` it wrote into its text
- the `queries` it searched: these are the words the engine uses for the topic

`list_search_queries` for the prompt shows the same searches across all chats.

## 3. Decide the cause, in this order

Stop at the first one that applies.

1. **Technical.** Find your page that answers this question. Check that it
   loads, is in the sitemap, and is not blocked in `robots.txt`.
   `get_agent_visits` grouped by `request_path` and `response_status` shows if
   AI crawlers reach it and what status they get (it needs connected access
   logs). A failure here is the cause.
2. **Missing.** No page of yours answers this question directly. A page that
   mentions the topic in passing does not count.
3. **Weak.** Your page exists and crawlers reach it, but it does not answer the
   question in its first screen, has no direct comparison or steps, or has
   facts that are out of date. `get_url_report` shows if engines retrieve it
   but do not cite it. Name the exact gap.
4. **Third-party.** Your page is fine, but the answer is built from other
   sites. Run `get_url_content` on the top cited sources to see what each one
   says about you: absent, wrong, out of date, or fair.

The rest: https://github.com/ParadevAI/Paradev/blob/HEAD/plugins/peec/skills/diagnose-ai-visibility/SKILL.md