seo-llmo

seo-llmo is a skill for Claude Code from ziniman/ai-instruct. It costs 278 tokens per session (12,516 once invoked), scanned C, original, Apache-2.0.

A guide for making public websites and web apps easier for search engines, AI tools, and automated agents to understand and use. It covers search metadata, social previews, structured data, machine-readable content, and programmatic access points.

In plain words
What is it for?
Use it when building, reviewing, or preparing a public website or web app, especially to add metadata, JSON-LD structured data, content signals, Markdown output, or advertised APIs.
Why use it?
It provides a checklist for discoverability and agent access before a site launches, including information that ordinary page text may not clearly expose.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Claude Code; mentions AGENTS.md; mentions Codex.

Part of the ai-instruct plugin — 5 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ziniman/ai-instruct/seo-llmo
Any agent
npx skills add ziniman/ai-instruct --skill seo-llmo
Clone the repo
git clone --depth 1 https://github.com/ziniman/ai-instruct

Made for: Claude Code.

Or install ai-instruct, the plugin that ships this one along with the rest of its 5 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for seo-llmo

README.md
[![agentmods](https://agentmods.dev/badge/skills/ziniman/ai-instruct/seo-llmo.svg)](https://agentmods.dev/skills/ziniman/ai-instruct/seo-llmo)
Your own site
<a href="https://agentmods.dev/skills/ziniman/ai-instruct/seo-llmo"><img src="https://agentmods.dev/badge/skills/ziniman/ai-instruct/seo-llmo.svg" alt="Measured on agentmods" height="20"></a>
Per session 278 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 12,516 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00278 $0.12516
Opus 5 $0.00139 $0.06258
Sonnet 5 $0.00056 $0.02503
Haiku 4.5 $0.00028 $0.01252

Measured 6d ago against content hash 13855b0b43e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade C, and why

seo-llmo scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -s https://yourdomain.com/ | python3 -c "import sys,json,re; [print(b['description']) for b in json.loads(re.search(r'application/ld\+json[^>]*>(.*?)</script>', sys.stdin.read(), re.S).group(1)).get('@graph', []) if

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

Verify: `curl -s https://yourdomain.com/llms.txt` - confirm the file is accessible and the H1 and blockquote render correctly.
skills/seo-llmo/SKILL.md · 1,140 lines

How it starts

The opening of the file, as written. The whole thing — 1,140 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SEO & LLMO Implementation Guide

Applies to: Any website or web app | Updated: April 2026

A practical guide for implementing Search Engine Optimization (SEO), Large Language Model Optimization (LLMO), and agent-readiness - making your site discoverable and usable by search engines, AI chat tools, and autonomous agents.

Agents (ChatGPT deep research, Claude with web, Perplexity, Cloudflare Agents, browser agents) don't just index your page, they fetch and act on it. That raises the bar on three things beyond classic SEO: telling crawlers what they may do with your content (Content Signals), serving a clean Markdown version on demand, and advertising any programmatic entry points you expose. You can check your agent-readiness score at isitagentready.com.


Section 0: Before You Start

Answer these questions before generating any code. Each has a default - use it if the user hasn't said otherwise.

Q: What kind of site is this? (blog, online shop, company/marketing site, web app, documentation) Default: company/marketing site - drives which schema types to prioritize.

Q: How is the site built? (plain HTML, React/Vue/Angular SPA, Next.js/Astro/Nuxt with server rendering, WordPress/CMS) Default: if a framework config file (e.g. vite.config.*, next.config.*, astro.config.*) is visible in the project, detect from that; otherwise assume plain HTML.

Q: Where are your visitors? (one country, multiple countries/languages, worldwide) Default: worldwide, single language - skip hreflang unless multiple languages are confirmed.

Q: What's your main goal with SEO? (show up in Google search, get cited by AI chat tools like ChatGPT/Perplexity, be usable by autonomous agents, social sharing, all of the above) Default: all of the above - the baseline checklist covers Google + AI chat citation + agent-readiness in one pass.

Q: Do you already have a robots.txt, sitemap, or structured data set up? Default: no - but check for existing files before creating new ones, and merge rather than overwrite.

Read the full file on GitHub · 1,140 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 1,140 lines · 278 tokens per session scan C 13855b0b43e3

Subscribe to this mod's changes

seo-llmo is a skill published in the GitHub repository ziniman/ai-instruct (28 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 278 tokens to every session and 12,516 once invoked, about $0.0014 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

launchworthy

Production readiness audit that turns a demo into a real product. Built for apps shipped fast with AI coding tools (Lovable, Bolt, v0, Cursor, Claude Code). Auto-detects your stack and audits 5 domains (Frontend, Backend & Data, Auth & Security, Infrastructure, Operations), then produces a scored scorecard and a…

Wunderlandmedia/launchworthy · 161 tokens

exploration-workflow

SME-facing orchestrator for the Business Exploration Loop. Supports 4 session types (greenfield, brownfield, discovery-only, spike) with adaptive phase selection. Manages state via exploration-dashboard.md, enforces phase gates, and routes to child skills in sequence. Phases can be skipped based on session type.…

richfrem/agent-plugins-skills · 121 tokens

subagent-driven-prototyping

Builds a prototype component by component, self-reviewing each component against the Discovery Plan before moving to the next. Invoked by prototype-builder after the layout direction is confirmed. Trigger phrases: "build the prototype", "let's build it", "start building". Also invoked by prototype-builder-agent after…

richfrem/agent-plugins-skills · 74 tokens

eval-autoresearch-fit

Trigger with "evaluate autoresearch fit", "score this skill for karpathy loop", "is this a good autoresearch candidate", "assess autoresearch viability for", "which skills are best for autonomous loop optimization", "score skills for 3-file architecture", or when the user wants to determine if a skill is a good…

richfrem/agent-plugins-skills · 85 tokens

optimize-agent-instructions

Audits and rewrites AI agent instruction files (CLAUDE.md, GEMINI.md, .github/copilot-instructions.md) in any repo. Strips stale or foreign content, applies Karpathy's four behavioral principles, ensures platform-specific sections, and makes each file authoritative rather than a copy of another. Trigger when the user…

richfrem/agent-plugins-skills · 130 tokens

vibe-reengineer

Top-level orchestration skill coordinating the entire 7-step surgical vibe-to-enterprise reengineering pipeline with automated safety and economic optimization controls.

richfrem/agent-plugins-skills · 33 tokens