ai-visibility SKILL.md skillA

ai-visibility from fangx-ai/geo-doctor is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add fangx-ai/geo-doctor/ai-visibility@v1.8.0

Pins v1.8.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
fangx-ai/geo-doctor
Path
skills/ai-visibility/SKILL.md
Versions recorded
2
Latest version
v1.8.0, committed Nov 17, 2026
First version recorded
Nov 16, 2026
Size
6,307 bytes
Repository stars
610
License
MIT

Measure whether AI assistants actually name and recommend a brand, and diagnose why they name competitors instead. Use when the user asks if ChatGPT, Doubao, DeepSeek, Yuanbao, Qwen, Kimi, Perplexity or Google AI Overviews recommend them, wants to know which brands AI lists for their category, or wants a repeatable sampling protocol instead of one-off screenshots. Builds question sets, samples answers, compares batches and reports the gap. For page-level crawlability first, see ai-crawler-audit.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AI 可见度实测

只回答一个问题:**在用户真会问的问题上,AI 提到我了吗,推荐的是谁,凭的是什么。** 用数据说话,不用感觉。

用用户的语言交流;本文件是中文的,读懂后用用户的语言转述。

## 什么时候用

- "豆包 / DeepSeek / ChatGPT 会推荐我吗?"
- "AI 一提这个行业就只报竞品的名字,为什么?"
- "怎么证明 AI 提过我?" / 要给老板或客户一份可复现的实测
- "上次做的优化有没有用?"(复查)

不接的活:页面能不能被抓到 → `ai-crawler-audit`;写内容 → `ai-content-writer`;发布 → `geo-publish`。

## 四条必须守住的证据纪律

这四条是这个技能的全部价值,违反任何一条,报告就作废:

1. **问的是用户会问的问题**,不是品牌名。问"哪款记账 App 好用"能测出可见度,问"XX 记账 App 怎么样"只能测出它认不认识这个词。
2. **"提到 / 推荐 / 引用"是三件不同的事**:提到 = 回答里出现品牌名;推荐 = 明确建议用你;引用 = 把你当来源链接。分开统计,不许合并成一个"AI 可见度"数字。
3. **AI 没回答 ≠ AI 没提到你。** 拒答、超时、返回错误单独记,不进分母,也不记成"未提及"。
4. **API 的回答不等于用户在 App 里看到的回答**。API 结果必须标"入口=API"、单独成批、只看趋势;要下结论就在真实 App 里人工采样确认。

## 流程

以本 `SKILL.md` 所在目录为技能根,模板在 `assets/`,脚本在 `scripts/geo-probe.mjs`(零依赖)。

### 1. 出问题基线 → `geo/questions.csv`

按 `references/questions.md` 写,模板见 `assets/questions.csv`。这一步不是"随手编 20 道题":问题集本身是测量的一部分,换一套问法结论就会变,所以每道题都要有类型、形状、限定条件、来源、证据等级和判定标准。

- **四类题**:A 不带品牌的推荐(约 40%,主战场)、B 品牌事实(30%)、C 不适合场景(20%,至少 2 道)、D 使用排错(10%)。
- **两层题集**:12–18 道标 `核心` 的**仪表题**,冻结后只用于报率和复查;另外 10–20 道 `一般` 的**雷达题**每轮可换。
- **问法形状**至少覆盖 5 种(品类发现、找替代、直接对比、排错……),写法与陷阱见 `references/question-shapes.md`。形状决定 AI 会不会真的去检索:商业意图类提问触发检索的比例远高于"什么是 X"。

写完先体检,再采样:
…

Read the whole file at its exact version.

How to install

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_eljxzka3wm5vmhjl/e89b7ee4546f79b7d5ea50968f71718cddb3b6e097ee65750aeaaa4abfd00871.json

Then /plugin install ai-visibility@markdownregistry-eljxzka3wm5vmhjl in Claude Code. It installs v1.8.0, the one graded A here, pinned to the commit it was graded at, and leaves it there.

The exact contents, by fingerprint
mdr add fangx-ai/geo-doctor/ai-visibility@sha256:e89b7ee4546f79b7

The line at the top of this page pins the label v1.8.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_eljxzka3wm5vmhjl.svg)](https://markdownregistry.com/a/art_eljxzka3wm5vmhjl)

2 badge image fetches in 30 days. What the badge shows.

Ask from your agent
claude mcp add --transport http markdownregistry https://markdownregistry.com/mcp/registry

Then ask it: what changed in fangx-ai/geo-doctor/ai-visibility since the version I have? It reads every saved version here, no key and no account. Any agent that speaks MCP can add it.

Got a copy of ai-visibility from somewhere else? Ask it: where did my ai-visibility come from, and what was changed? It names the public original, the version yours is closest to and every changed line. The text is not kept.

Versions

The registry has recorded 2 versions of this file, between Nov 16, 2026 and Nov 17, 2026, more than one a day.

Watch this file (sign in, one email per new version)

versioncommittedcommitsizeaudit
v1.8.0 latest2026-11-17 d7af7ca 6,307 BA view · diff
v1.8.02026-11-16 179fff4 5,249 BA view
Keep it current by itself, install once

Committed this skill to a repository? Install the markdownregistry skill updates app on it, or on all of them. When the registry saves a newer version, a pull request brings your copy to it within minutes, the newest version first, then what changed and any check it newly trips. A copy you edited is never touched, and nothing is deleted.

Install on GitHub

It asks to read and write contents and pull requests, and to read metadata. No workflow file, no Actions setting, nothing runs on your runners. Uninstall it and everything the registry kept about your repository is deleted.

Keep it current by itself

Committed this skill to a repository? Add one workflow file, and when a newer version is saved, a pull request brings your copy to it, the newest version first, then what changed and any check it newly trips. A copy you edited is never touched, and nothing is deleted.

mkdir -p .github/workflows && curl -fsSL https://markdownregistry.com/ci/skill-updates.yml -o .github/workflows/skill-updates.yml

It runs daily on GitHub Actions, no key and no account. Read the workflow before you add it.

Check a whole project

From the root of your project, one line hashes each installed skill's SKILL.md, your AGENTS.md and your CLAUDE.md, and asks the registry once. Only the fingerprints and paths are sent.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --data-binary @- https://markdownregistry.com/api/v1/check-copies

In CI, add --fail-with-body: the answer is 409 when any file is behind, so the step fails and still prints which files.

sha256sum .claude/skills/*/SKILL.md AGENTS.md CLAUDE.md | curl -s --fail-with-body --data-binary @- https://markdownregistry.com/api/v1/check-copies

No sha256sum on your machine? shasum -a 256 prints the same lines.

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6307 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

fangx-ai/geo-doctor · 610 stars · license MIT · pushed 2026-11-17 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_eljxzka3wm5vmhjl
GET https://markdownregistry.com/api/v1/resolve?ref=fangx-ai/geo-doctor/ai-visibility
GET https://markdownregistry.com/api/v1/blob/e89b7ee4546f79b7d5ea50968f71718cddb3b6e097ee65750aeaaa4abfd00871

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from fangx-ai/geo-doctor

llms.txt llms.txt file
fangx-ai/geo-doctor · llms.txt
git:20261020.aed1050 · audit A · 610 stars
ai-content-writer SKILL.md skill
fangx-ai/geo-doctor · skills/ai-content-writer/SKILL.md · Write pages that AI assistants can quote correctly, starting from a fact card instead of from memory. Use when the user…
v1.8.0 · audit A · 610 stars
ai-crawler-audit SKILL.md skill
fangx-ai/geo-doctor · skills/ai-crawler-audit/SKILL.md · Audit whether AI crawlers can reach and read one page, then name exactly what blocks them. Use when the user asks why…
v1.8.0 · audit A · 610 stars
geo-doctor SKILL.md skill
fangx-ai/geo-doctor · skills/geo-doctor/SKILL.md · Full GEO program: route a generative engine optimization request to the right focused skill and run the loop end to…
v1.8.0 · audit A · 610 stars
geo-publish SKILL.md skill
fangx-ai/geo-doctor · skills/geo-publish/SKILL.md · Plan and run multi-platform publishing for GEO content: the official site publishes directly, third-party platforms get…
v1.8.0 · audit A · 610 stars
llms-txt SKILL.md skill
fangx-ai/geo-doctor · skills/llms-txt/SKILL.md · Build the files AI reads first: llms.txt, facts.json, robots.txt, sitemap.xml and a static fact site generated from a…
v1.8.0 · audit A · 610 stars

Every file in fangx-ai/geo-doctor

Other files named ai-visibility

ai-visibility SKILL.md skill
ryze-ai-adgent/open-seo-mcp-skills · skills/ai-visibility/SKILL.md · Measure real AI-engine visibility — traffic from ChatGPT, Perplexity, Claude, Gemini and which pages they cite — from…
git:20261027.f587b0a · audit A · 10,539 stars
ai-visibility SKILL.md skill
akii-technologies-ltd/akii-seo-ai-search-optimizer · skills/ai-visibility/SKILL.md · Fast-path AI visibility analysis using public web signals, with a per-engine proxy map for ChatGPT, Claude, Gemini…
git:20261112.923e98d · audit B · 80 stars

Browse by kind, by grade A, or by owner.