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
- bradydwardai/claude-skillstheir own version, first seen Nov 8, 2026
- yht-4403/jc-agent-skillstheir own version, first seen Nov 8, 2026
- ftzi/livespectheir own version, first seen Nov 8, 2026
- About-Intelligence/awesome-marketing-skillstheir own version, first seen Nov 8, 2026
- sogud/skillstheir own version, first seen Nov 1, 2026
- MoizIbnYousaf/marketing-clitheir own version, first seen Nov 1, 2026
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.
CesarjoquinSkillpopups
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
CesarjoquinSkillco-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
coreyhaines31Skillmarketing-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
timruebenachSkillcompetitor-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
prayceoSkillproduct-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
coreyhaines31Skillmarketing-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
Other versions88 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 88
- coreyhaines31/marketingskills★ 59ksame name
- KartikLabhshetwar/screenshot-studio★ 1.1ksame name
- KartikLabhshetwar/stage★ 1.1ksame name
- LeoYeAI/openclaw-marketing-skills★ 1ksame name
- msgbyte/cutia★ 879same name
- Nexus-JPF/note-companion★ 874same name
- Karanjot786/TermUI★ 238same name
- Cesarjoquin/Marketing-Skills★ 190same name
- b1rdmania/ghostclaw★ 91same name
- Yg0rAndrade/carcara-code★ 84same name
78 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- AGENTS.mdAGENTS.md
- articleSkill
- blog-contextSkill
- brand-voiceSkill
- content-planSkill
- house-styleSkill
- humanizeSkill
- internal-linksSkill
- keyword-researchSkill
- metaSkill
- refreshSkill
- seo-optimizeSkill
- serp-analysisSkill
- youtube-to-blogSkill
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
- Very specific: line 58
If .agents/blog-context.md exists, read it for the author, credentials, and the "Experience and proof" section.
- Very specific: line 60
Read the house-style rulebook at ../house-style/references/ai-tells.md before you write any new sentence.
- Distinctive: line 64
If you can search the web, look at how AI answers currently handle the question and which pages they cite.
- Distinctive: line 66
If the post is stale (old prices, versions, or a past year in the title), say so first and point to refresh.
- Distinctive: line 110
If the user asked a direct question (llms.txt, schema, a specific engine), answer it first in a few lines.
- Distinctive: line 123
Don't restate the post back to the user.
“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.
Files
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.txtfile. 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.mdexists, 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.mdbefore 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.
- 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.
- Opening third. The key facts, numbers, and the main recommendation appear in the first third of the post, not saved for the end.
- 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.
- 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.
- Specifics. Replace vague claims with numbers, names, dates, and sources. Flag any claim with no source rather than invent one.
- 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.
- 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.
- 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.
- 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 fornosnippet, a tinymax-snippet, ordata-nosnippeton 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
- If the user asked a direct question (llms.txt, schema, a specific engine), answer it first in a few lines.
- A short audit: which of the nine checks the post fails, worst first.
- 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.
- 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
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
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.

