agentleFS
egenilegenil/sitelemetry-claude-plugin/skills/ai-visibility/SKILL.md

ai-visibility

Skill0 starsChanged 46 days agoMITView on GitHub

Use the Sitelemetry AI visibility (GEO/AEO) and technical SEO audits on a site the user owns to propose evidence-backed changes such as robots.txt rules for AI crawlers, schema.org JSON-LD structured data, an llms.txt file and content edits, each only where the findings support it. Use when the user asks how AI assistants and AI search can crawl, understand or cite their site, or wants to improve GEO, AEO or structured data.

15 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use content-brief and seo-audit.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • LangChainSkill

    content-brief

    Turn a vague or multi-asset design ask into a brief. Pull what is already known, ask at most two questions with reasons, decide the rest and say what you decided.

    Also in 3 projects that use this

  • AnthropicSkill

    seo-audit

    Run a comprehensive SEO audit — keyword research, on-page analysis, content gaps, technical checks, and competitor comparison. Use when assessing a site's SEO health, when finding keyword opportunities and content gaps competitors own, or when you need a prioritized action plan split into quick wins and strategic investments.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 14 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Only audit sites the user owns or is authorized to test.

    line 11
  2. Distinctive:

    Content: write edits in the site's voice and mark them as drafts for the user to review.

    line 45
  3. Very specific:

    After the user publishes the changes, offer to re-run the same audits with the same arguments and compare the results by findingKey, as in …

    line 65

“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

AI visibility

Ground rules

  • Reply in the user's language. For the audit tools, set lang as described in the website-audit skill. lang changes the report wording, not the measurement criteria.
  • Only audit sites the user owns or is authorized to test. If that is not clear, ask first.
  • Be precise about what is measured. audit_ai_visibility checks entity clarity, answerability, source signals and AI-crawler policy on the site's own pages. The prompts option runs content-readiness checks against the site; it does not query any AI provider. competitors are names used to assess comparison content; competitor sites are not audited. Nothing here measures or guarantees whether an AI assistant mentions or cites the site. Say this when you present results.

1. Run the audits

  1. audit_ai_visibility on the target.
    • brand: pass it if the user gives one or the site name is ambiguous; otherwise it is inferred from the site.
    • prompts: real questions the site's audience asks, supplied by the user (up to 24, each up to 500 characters). Only as many prompts as the connected account's prompt limit are checked, and any beyond it are left out. If the result shows fewer prompts than were supplied, say so.
    • competitors: names only, if the user supplies them (up to 8).
    • maxPages and promptLimit: leave them out unless the user asks; defaults follow the connected account.
  2. audit_seo on the same target when structured data, crawlability, indexation or metadata matter to the request. Start it only after the first audit has a final status.

Handle running, action_required and errors as in the website-audit skill: poll with pollArguments exactly as returned, never start a duplicate audit, and relay access or limit messages neutrally.

2. Map findings to changes

Propose a change only when a returned finding, or its evidence, supports it. Cite the finding next to each proposal.

Finding areaChange to propose
AI-crawler policy: crawlers blocked, rules unclear or inconsistentrobots.txt rules per crawler
Structured data missing, invalid or not describing the main entityschema.org JSON-LD for the real organization, site and page types
Entity clarityclear statements of who the organization is, what it offers and where, on the home and about pages
Answerabilityanswer-first sections and FAQs based on real customer questions
Source signalsauthor and date information, about and contact pages, references, consistent names
No machine-readable site summary, when reported or when the user asksan llms.txt file

Crawler names, robots.txt patterns and JSON-LD and llms.txt templates: AI crawlers, JSON-LD and llms.txt.

3. Rules for each change

  • robots.txt: the site owner decides which crawlers may access the site. Explain the difference between crawlers that collect training data and those that fetch pages for search or for a user's request. Keep the existing rules and the Sitemap line, and never block general search crawlers such as Googlebot or Bingbot by accident.
  • JSON-LD: describe only facts that are true and visible on the page. Ask the user for facts you do not have (legal name, logo URL, official profiles). Never invent ratings, reviews, prices, addresses, opening hours or FAQs. Use one stable @id per entity across pages, and check the markup with a structured-data validator before publishing.
  • llms.txt: present it as an optional, low-effort convention that not every AI provider reads. Link only to real, public pages.
  • Content: write edits in the site's voice and mark them as drafts for the user to review. Do not add claims the user has not confirmed.

4. Present and re-test

Group the proposals by effort: configuration first (robots.txt, llms.txt), then markup (JSON-LD), then content. For each, name the finding it addresses, the change and where it goes.

AI visibility for https://example.com/ (score <score> if returned)
What this measures: content-readiness signals on your pages, not live AI answers.

1. Configuration
   - Finding: <title> (<severity>). Change: <robots.txt rule>. Where: /robots.txt
2. Markup
   - Finding: <title> (<severity>). Change: Organization JSON-LD. Where: home page head
3. Content
   - Finding: <title> (<severity>). Change: <draft edit>. Where: <page>

Not measured: <anything the result marks as unavailable or partial>

After the user publishes the changes, offer to re-run the same audits with the same arguments and compare the results by findingKey, as in the fix-and-retest skill. Report what changed and what is still open or not measured.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.