claude-seo: Instructions file for Codex

AGENTS.md

claude-seo AGENTS.md is an instructions file for Codex, OpenCode from AgriciDaniel/claude-seo. It costs 2,398 tokens per session, scanned A, original, MIT.

Project instructions for using Claude SEO across different coding-agent tools, including Cursor, Gemini CLI, Codex CLI, and others. They explain how each agent environment loads the project and how to check portability.

In plain words
What is it for?
Use them when moving Claude SEO between agent platforms, checking instruction-file compatibility, or following the correct setup for a specific coding-agent environment.
Why use it?
They reduce differences between coding-agent environments and help reveal instructions that one environment may ignore. Portability means the same project guidance can work across multiple tools.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: mentions .claude-plugin; mentions CLAUDE.md; mentions subagents.

This is AgriciDaniel/claude-seo's own configuration. It tells Codex and OpenCode how to work on claude-seo itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything claude-seo configures →

About the project

Claude SEO is an open-source Claude Code plugin that runs specialized agents and skills to audit websites across technical SEO, content quality, structured data, AI-search optimization, local and e-commerce SEO, and international SEO. SEO practitioners use it to produce prioritized recommendations based on primary-source guidance, with optional extensions for external data and crawling.

AgriciDaniel/claude-seo · 19,878 stars · on GitHub

Reuse

Borrowing it

Nothing to install: this file belongs to AgriciDaniel/claude-seo. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo

Made for: Codex, OpenCode.

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 claude-seo AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/agricidaniel/claude-seo/agents-md/github.svg)](https://agentmods.dev/instructions/agricidaniel/claude-seo/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/agricidaniel/claude-seo/agents-md"><img src="https://agentmods.dev/badge/instructions/agricidaniel/claude-seo/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for claude-seo AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/agricidaniel/claude-seo/agents-md"><img src="https://agentmods.dev/badge/instructions/agricidaniel/claude-seo/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 2,398 This file is loaded in full into every session.
When invoked 2,398 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. ✓ AI security review Fable 5.1 · 6 Sept 2026 📄 Read the review
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.02398 $0.02398
Opus 5.5 $0.00959 $0.00959
Sonnet 5.5 $0.00480 $0.00480
Haiku 4.5 $0.00240 $0.00240

Measured 1mo ago against content hash 7f5d4b9ad77a, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

claude-seo AGENTS.md scanned grade A with 0 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 1mo 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 187 lines

How it starts

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

Claude SEO: Multi-Platform Agent Instructions

For Cursor, Cursor Cloud Agents, Google Antigravity, Gemini CLI, Grok Build, OpenAI Codex CLI, Cline, Aider, and any other agent harness that reads project-root agent instructions.

Claude Code users: see CLAUDE.md instead.

Cross-platform portability (v2.0.0)

Every skill in skills/*/SKILL.md is authored to a portable subset of the Claude Code skill spec. Validate compatibility with your harness via:

./scripts/claude-seo run portability_check.py

The check confirms each SKILL.md has the minimum frontmatter every harness expects (name, description, optional model, optional tools) and warns on Claude-Code-specific features (maxTurns, multi-line tool list with descriptive comments) that other harnesses may ignore but do not reject.

Per-harness notes

Harness How to load claude-seo
Cursor Symlink or copy skills/ and agents/ into .cursor/rules/. Commands are invoked as text prompts; the harness reads SKILL.md body as system context.
Cursor Cloud Agents Push the repo; Cloud Agents read AGENTS.md automatically at session start.
Google Antigravity Point the workspace at this repo root; Antigravity reads AGENTS.md first, falls back to skills/.
Gemini CLI gemini init in this repo loads AGENTS.md. Skills are activated via activate_skill <name> in conversation.
Grok Build Open this repository in Grok Build. It reads AGENTS.md and Claude Code compatible plugins and skills without a separate layout. Use grok inspect to verify discovery. See the official compatibility guide.
OpenAI Codex CLI Reads AGENTS.md from project root. Bash tools work as documented; some Claude-specific tool names (Read/Write/Edit) are aliased to Codex equivalents transparently.
Cline Loads AGENTS.md from project root. Skills appear as system messages; subagent delegation falls back to in-context expansion.
Aider Reads AGENTS.md if present; otherwise falls back to README. Aider does not support sub-agent dispatch; the seo-* skills run inline.

Read the full file on GitHub · 187 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. 1mo ago Changed · +2 lines · +51 tokens per session 7f5d4b9ad77a
  2. 1mo ago Changed 3febdc0d049c
  3. 1mo ago First seen · 185 lines · 2,347 tokens per session scan A 3f1510c4dcf3

Subscribe to this mod's changes

claude-seo AGENTS.md is an instructions file published in the GitHub repository AgriciDaniel/claude-seo (19,878 stars, last pushed 2d ago), licensed MIT. It adds 2,398 tokens to every session, about $0.0096 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 9,715 tokens

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,581 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).

microsoft/vscode · 5,262 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,680 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 4,261 tokens

vscode copilot-instructions.md

Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).

microsoft/vscode · 2,731 tokens