Index of every page on this site: llms.txt
All skills
Run it yourself

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.

Use this Skill: https://skilld.dev/gh/rightblogger/bloggingskills/ai-seo

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈112 tokens for metadata: the name and description. ≈1.7k when used: this file. ≈1.9k more on demand in 1 file.

Description uses 5.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈448 characters, or 5.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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. One summary, not two. The answer-first opening from check 1 is the summary engines quote. Add a separate "Key takeaways" list only to a long reference post readers will scan, and then make sure the conclusion doesn't recap the same points: a takeaways box plus a recap close is the shape readers and detectors flag as generated (see evidence.md). An existing TL;DR, Summary, or At a glance block stays only on a long reference post; otherwise move any fact only it holds into the opening and remove 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 opening 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 if the post earned one, 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

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning23d3 checks · Risk SAFE
  • Gen Agent Trust Hub23d

    The skill is designed to analyze and optimize blog posts for AI-powered search engines. It functions by processing user-provided text or URLs and comparing them against established SEO best practices. While the skill is generally safe, it possesses a surface for indirect prompt injection because it ingests untrusted external content without utilizing explicit boundary markers or sanitization. However, the lack of dangerous capabilities such as code execution or system modification significantly limits the potential risk.

  • Socket23d

    No alerts

  • Snyk23d

    Risk: MEDIUM · 1 issue

Signed by skilld at d2bfb76. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 3 days ago
metadata
{
  "version": "0.4.0"
}

README badge

README badge for rightblogger/bloggingskills/ai-seo