agentleFS
RightBloggerRightBlogger/bloggingskills/skills/ai-seo/SKILL.md

ai-seo

Skill4 starsChanged 15 days agoMITView on GitHub

Edits a blog post so AI answer engines (ChatGPT search, Perplexity, Google AI Overviews and AI Mode, Gemini, Claude) can lift and cite it, and separates what helps from myths like llms.txt. Use when the user wants a post cited by AI, says 'AI SEO', 'AEO', 'GEO', or 'optimize for ChatGPT', or asks about llms.txt or AI Overviews. For keyword-focused on-page work, see seo-optimize. For an old post losing clicks to AI answers, see refresh.

88 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use popups, co-marketing and 10 more.

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.
  • CesarjoquinSkill

    popups

    When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions "exit intent," "popup conversions," "modal optimization," "lead capture popup," "email popup," "announcement banner," "overlay," "collect emails with a popup," "exit popup," "scroll trigger," "sticky bar," or "notification bar." Use this for any overlay or interrupt-style conversion element. For forms outside of popups, see cro. For general page conversion optimization, see cro.

    Also in 22 projects that use this

  • CesarjoquinSkill

    co-marketing

    When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says 'co-marketing,' 'partner marketing,' 'joint campaign,' 'who should we partner with,' 'integration marketing,' 'cross-promotion,' 'collaborate with another company,' 'partnership ideas,' or 'co-brand.' For customer referral programs, see referrals. For launch-specific partnerships, see launch.

    Also in 24 projects that use this

  • coreyhaines31Skill

    marketing-council

    When the user wants multiple expert perspectives on a marketing question — a simulated board of advisors staffed by legendary marketers (Seth Godin, David Ogilvy, Eugene Schwartz, April Dunford, Rory Sutherland, Alex Hormozi, Byron Sharp, and more). Also use when the user mentions 'marketing council,' 'board of advisors,' 'advisory board,' 'what would Seth Godin say,' 'what would Ogilvy think,' 'channel Hormozi,' 'get multiple perspectives,' 'debate this,' 'have the council review,' 'marketing mentors,' or asks how a famous marketer would approach their problem. The council gives each advisor's take through their documented frameworks, surfaces where they disagree, and synthesizes a recommendation. For executing the winning direction, hand off to positioning, offers, copywriting, ads, or the relevant skill.

    Also in 18 projects that use this

  • timruebenachSkill

    competitor-profiling

    When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions 'competitor profile,' 'competitor research,' 'competitor analysis,' 'profile this competitor,' 'analyze competitor,' 'competitive intelligence,' 'competitor deep dive,' 'who are my competitors,' 'competitor landscape,' 'competitor dossier,' 'competitive audit,' or 'research these competitors.' Input is a list of competitor URLs. Output is structured competitor profile markdown files. For creating comparison/alternative pages from profiles, see competitor-alternatives. For sales-specific battle cards, see sales-enablement.

    Also in 26 projects that use this

  • prayceoSkill

    product-marketing

    Applies Meghan Keaney Anderson and Mary Sheehan's Mastering Product Marketing frameworks to build influence and demonstrate impact by delivering great products to market successfully. Covers product positioning, go-to-market strategy, and launch planning and tiering. Activates when making decisions about your product's positioning, planning feature or product launches, defining go-to-market strategy, or crafting product messaging. For pricing and packaging frameworks, see consumer-subscription. Triggers when someone asks about positioning, go-to-market, launch planning, competitive differentiation, or says "how should we position this?" or "how do we launch this feature?

    Also in 32 projects that use this

  • coreyhaines31Skill

    marketing-loops

    When the user wants to set up a recurring, self-running marketing workflow — a repeatable loop an AI agent runs on a cadence (weekly, daily, on a trigger) rather than a one-off task. Also use when the user mentions 'marketing loop,' 'recurring marketing workflow,' 'automate my marketing,' 'marketing on autopilot,' 'weekly marketing review,' 'ad fatigue check,' 'weekly ads check,' 'content refresh loop,' 'churn watch,' 'ranking drop alert,' 'run my SEO,' 'SEO operator,' 'daily SEO agent,' 'run my outbound,' 'AI SDR,' 'reply triage,' 'always-on marketing,' 'marketing automation workflow,' or 'run this every week.' Use this to pick, adapt, and schedule an ongoing marketing loop that orchestrates the other marketing skills. For one-off marketing ideas, see marketing-ideas. For the experimentation loop specifically, see ab-testing.

    Also in 10 projects that use this

  • +6 more from Cesarjoquin

The file

We split this skill into the rules it gives an agent

6 rules. 0 are common, 4 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 83 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If .agents/blog-context.md exists, read it for the author, credentials, and the "Experience and proof" section.

    line 58
  2. Very specific:

    Read the house-style rulebook at ../house-style/references/ai-tells.md before you write any new sentence.

    line 60
  3. Distinctive:

    If you can search the web, look at how AI answers currently handle the question and which pages they cite.

    line 64
  4. Distinctive:

    If the post is stale (old prices, versions, or a past year in the title), say so first and point to refresh.

    line 66
  5. Distinctive:

    If the user asked a direct question (llms.txt, schema, a specific engine), answer it first in a few lines.

    line 110
  6. Distinctive:

    Don't restate the post back to the user.

    line 123

“Common” is measured: kept by at least 6 in 10 of the 83 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 SEO

You make a blog post the source AI answer engines quote: ChatGPT search, Perplexity, Google AI Overviews and AI Mode, Gemini, and Claude. These engines retrieve pages from a search index first and then quote passages that answer the question cleanly, so a page has to be findable, and then easy to lift and safe to cite. You work on the second part and check the first.

You're done when the post answers its core question in its opening, each section leads with a self-contained answer, every important claim is specific and sourced, the trust signals are visible, and the user knows which off-page steps matter.

What helps and what doesn't

Give the user this distinction plainly, because the AEO and GEO space is full of paid advice that isn't backed by the engines themselves.

What helps, and why:

  • Ranking. AI features retrieve from the same index and ranking systems as regular search, often for several related sub-queries at once. A page that can't rank for any of them rarely gets cited.
  • Front-loaded answers. Engines quote the opening of a page far more than the end.
  • Self-contained, specific sentences with numbers, names, and dates. Engines quote sentences, not pages.
  • Focused pages. A page that answers one question well beats an "ultimate guide" that answers twenty thinly.
  • First-hand experience, original data, and a named author with real credentials. These make a quote safe to cite.
  • Freshness that's real. ChatGPT and Perplexity lean toward recently updated pages, and a substantive update is worth showing with a visible date.
  • Mentions elsewhere. Engines weigh what other sites, forums, and videos say about a brand, not only what the brand says about itself.

What doesn't, per Google's own guidance on AI search:

  • An llms.txt file. Google Search ignores it, and there's no evidence it earns citations elsewhere.
  • Chopping a page into tiny chunks or rewriting it in a special "AI style."
  • Special schema for AI features. Structured data still helps regular rich results (Article, Product, VideoObject), but FAQ markup no longer produces rich results for most sites.
  • A separate page for every phrasing of a question. That's scaled content abuse, and it can get a site demoted.
  • Self-ranked "best X" lists that put the publisher first. Engines tend to cite those pages while leaving the publisher out of the answer.

references/evidence.md has the sources and numbers behind these, dated. Cite them when the user asks why.

Initial assessment

  • If .agents/blog-context.md exists, read it for the author, credentials, and the "Experience and proof" section. A captured voice still wins over any rule here.
  • Read the house-style rulebook at ../house-style/references/ai-tells.md before you write any new sentence.
  • Take the post as text or a URL. State the one question it answers in a sentence. If you can't, the page has no answer for an engine to lift; fix that first.
  • If you can search the web, look at how AI answers currently handle the question and which pages they cite. That's the bar.
  • If the post is stale (old prices, versions, or a past year in the title), say so first and point to refresh. Engines favor current pages, and no amount of restructuring makes an outdated answer safe to cite.

Method

Audit against these checks, then apply or propose each edit.

  1. Answer first. The core question gets a direct, self-contained answer in the first 100 words, about 40 to 60 words long, quotable with no surrounding context. When this collides with another rule, a clear, quotable answer beats an exact word count.
  2. Opening third. The key facts, numbers, and the main recommendation appear in the first third of the post, not saved for the end.
  3. Section leads. Each H2 opens with one or two sentences that answer that section's question on their own. Rewrite headings toward how people actually ask only where that is how they search.
  4. Sub-questions. List the follow-up questions a person (or an engine's fan-out) would ask next. Cover the missing ones inside this page, briefly. Don't propose new pages for each.
  5. Specifics. Replace vague claims with numbers, names, dates, and sources. Flag any claim with no source rather than invent one.
  6. Trust signals. A named author with relevant credentials, a visible publish or updated date, first-hand evidence (a test, a photo, original data), and links to primary sources.
  7. A summary block. One short "Key takeaways" list near the top helps skimmers and gets quoted. Check the post doesn't already have one under another name (TL;DR, Summary, At a glance) before adding it.
  8. FAQ. Add 3 to 5 questions only if readers still have real questions the body didn't answer. It's for readers and answer engines, not for rich results.
  9. Access. If you can read the site's robots.txt, confirm it doesn't block the search crawlers the user cares about: Googlebot, Bingbot (Copilot draws on Bing), OAI-SearchBot for ChatGPT search, Claude-SearchBot, and PerplexityBot. Blocking a training crawler like GPTBot doesn't remove a site from those search results. For Google, two more switches decide eligibility: the site must be opted in to generative AI features in Search Console (an opted-out site gets no AI Overview or AI Mode citations), and the page must allow a snippet, so check for nosnippet, a tiny max-snippet, or data-nosnippet on the answer. If you can't see these settings, ask the user to confirm them.

One answer-first block and one takeaways list is the point. Don't stack summary boxes.

Output

  1. If the user asked a direct question (llms.txt, schema, a specific engine), answer it first in a few lines.
  2. A short audit: which of the nine checks the post fails, worst first.
  3. The edits, ready to paste, in this order: the answer-first opening, the takeaways list, the rewritten section leads, the added sub-question coverage, and the FAQ if it earned one.
  4. Off-page steps, in two or three lines: where the brand should be mentioned or reviewed, a YouTube video if the topic suits one, and how to watch results. AI referrers (chatgpt.com, perplexity.ai, gemini.google.com, copilot.microsoft.com, claude.ai) belong in their own analytics channel. Search Console's generative AI report and Bing's AI Performance report show citations and impressions but not clicks, so read them as visibility, not traffic.

Don't restate the post back to the user.

Related skills

seo-optimize · serp-analysis · refresh · article · humanize · house-style

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.