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.
npx agentmods add instructions/iannuttall/seo/agents-mdgit clone --depth 1 https://github.com/iannuttall/seoWrote 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.
[](https://agentmods.dev/instructions/iannuttall/seo/agents-md)<a href="https://agentmods.dev/instructions/iannuttall/seo/agents-md"><img src="https://agentmods.dev/badge/instructions/iannuttall/seo/agents-md.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.05130 | $0.05130 |
| Opus 5 | $0.02565 | $0.02565 |
| Sonnet 5 | $0.01026 | $0.01026 |
| Haiku 4.5 | $0.00513 | $0.00513 |
Grade A, and why
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 5d 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.
How it starts
The opening of the file, as written. The whole thing — 499 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Agent Notes
This is the source for seo, a local-first TypeScript SEO CLI, library,
router skill, and stdio MCP server. The public repository is
iannuttall/seo. The public npm package is the unscoped seo package.
PRODUCT.md is the durable product definition: users, purpose, brand
personality, vocabulary, and anti-references. Read it before writing any
user-facing copy or making product-shape decisions. This file owns the
engineering contract.
CONTENT.md is the durable writing guide for website copy, documentation,
report pages, command help, onboarding, metadata, and README content. Read it
before writing or editing user-facing language.
Reading CONTENT.md is mandatory in the same task before writing, editing, or
generating user-facing copy. Do not rely on memory or treat shared template
copy as an exception.
The product has two primary users:
- Humans start with a guided prompt flow and one main report.
- Agents use explicit flags, structured JSON, the router skill, and MCP tools.
Keep the human path calm. Keep the agent path powerful. Both paths must use the same core report logic and return the same evidence.
CLAUDE.md must stay a symlink to this file. Do not maintain separate copies of
agent instructions.
Product Direction
- The product is local first. Do not add a required hosted backend, account, database, job queue, or telemetry service.
- Reports, tokens, project profiles, and caches stay on the user's machine.
- Optional research providers extend first-party evidence with keyword, result, domain, competitor, and link estimates. They must never replace or silently blend with Search Console, Google Analytics, crawl, or live result evidence.
- Optional provider packages may add analytics or research adapters through the public provider SDK. The main package owns the contracts, installation, credentials, resource limits, registry, report semantics, and provenance. Provider packages return normalized evidence and never add report findings, public commands, MCP tools, or skill files.
- A future hosted API or remote MCP may live in this monorepo and deploy to Cloudflare, but local CLI and library use must remain first class.
- Report accuracy, deterministic output, and simple onboarding matter more than adding another surface or speculative score.
- The moat is the
seopackage, product quality, verified OAuth app, test corpus, report depth, brand, and release velocity. Do not hide core report logic behind private packages. - The license is Apache-2.0. Brand and trademark rules belong in a separate public policy, not in code-level restrictions.
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.
- 5d ago First seen · 499 lines · 5,130 tokens per session scan A e21cf190faad
seo AGENTS.md is an instructions file published in the GitHub repository iannuttall/seo (438 stars, last pushed 4d ago), licensed Apache-2.0. It adds 5,130 tokens to every session, about $0.0256 per session on Opus 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.
Other instructions, from other repositories
gini-agent AGENTS.md
AGENTS.md instructions for Open-Curiosity/gini-agent, covering gini agent instructions, shape, adrs, boundaries and branches.
plur CLAUDE.md
Claude Code instructions for plur-ai/plur, covering claude.md, what is plur, development, package dependency and version bumps.
barkeep AGENTS.md
AGENTS.md instructions for iannuttall/barkeep, covering agent notes, product rules, repo map, commands and app structure.
rondoflow CLAUDE.md
Claude Code instructions for rondoflow/rondoflow, covering rondoflow, project overview, tech stack, development and setup.
blz AGENTS.md
Instructions for outfitter-dev/blz, covering blz repository instructions for ai agents, important, working memory, use blz and 🚀 quick start for agents.
linggen CLAUDE.md
Claude Code instructions for linggen/linggen, covering claude.md, doc and spec, build, test, run, architecture and configuration.