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/jdevalk/seo-graph/agents-mdgit clone --depth 1 https://github.com/jdevalk/seo-graphWhat 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.26734 | $0.26734 |
| Opus 5 | $0.13367 | $0.13367 |
| Sonnet 5 | $0.05347 | $0.05347 |
| Haiku 4.5 | $0.02673 | $0.02673 |
Grade A, and why
seo-graph 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 yesterday.
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.
Copies of this mod
1 near-identical copy found in the catalogue:
- seo-graph AGENTS.md — 89% identical, 1,170 lines differ
How it starts
The opening of the file, as written. The whole thing — 3,461 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — seo-graph
This file is for AI coding agents (Claude Code, Cursor, Copilot, etc.) building sites that use
@jdevalk/seo-graph-coreand/or@jdevalk/astro-seo-graph. It explains what the library does, how the pieces fit together, and which schema.org entities to use for every common site type.
What this library does
seo-graph builds valid, linked schema.org JSON-LD @graph arrays from typed
inputs. Instead of hand-writing JSON-LD (error-prone) or copying snippets
from schema.org docs (inconsistent), you call piece builders that return
strongly-typed entities, then wrap them in a @graph envelope.
Two packages:
@jdevalk/seo-graph-core— Pure TypeScript, no framework dependency. Piece builders, ID factory, graph assembler, deduplication. Use this from any runtime.@jdevalk/astro-seo-graph— Astro integration.<Seo>component, route factories for schema endpoints, schema map for agent discovery, Zod content helpers.
Contents
Schema core — concepts and builders for the JSON-LD graph:
Recipes and patterns — how to model real sites:
- Site type recipes
- Trust and credibility signals
- Choosing the right Article subtype
- Actions: telling agents what they can do
- Multi-type entities
- Rich Organization patterns
- Rich Person patterns
- Reference implementations
Astro integration — runtime component and build-time checks:
- Astro integration guide — the
<Seo>component, hreflang, schema endpoints - Build-time integration —
seoGraph()hook, H1 validation, metadata uniqueness, IndexNow,llms.txt - Complete integration example
- Advanced patterns
- Common mistakes
- Validating your output
- Repository structure
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.
- yesterday First seen · 3,461 lines · 26,734 tokens per session scan A 0cad536a4779
seo-graph AGENTS.md is an instructions file published in the GitHub repository jdevalk/seo-graph (48 stars, last pushed 15d ago), licensed MIT. It adds 26,734 tokens to every session, about $0.1337 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
seo-graph AGENTS.md
Instructions for iannuttall/seo-graph, covering agents.md — seo-graph, what this library does, architecture, installation and and, for astro projects.
seo-graph CLAUDE.md
Instructions for iannuttall/seo-graph, a project described as: Agent-ready SEO for JavaScript — schema.org JSON-LD graph builders, deterministic agent markdown with content negotiation, and an Astro integration.
specification.website CLAUDE.md
Claude Code instructions for jdevalk/specification.website, covering what this project is, status discipline, changelog, cardinal rules for content and architecture quick reference.
cocktail.glass CLAUDE.md
Instructions for jdevalk/cocktail.glass, covering cocktail.glass, stack, html principles, css principles and performance.
starwind-ui AGENTS.md
Instructions for starwind-ui/starwind-ui, covering agents.md, project shape, useful commands and contribution conventions.
stardrive AGENTS.md
Instructions for peltmonger/stardrive, covering 🛑 critical: repository bootstrap directive 🛑, general information and guidelines for ai agents, analyze your high-level use case first, how the .ai guidance files relate and this is an astro project.