SEO for AI AgentsThe honest manual
Use it well: judgement first
This pack puts a rigorous SEO method in an AI agent's hands, and that's exactly why it needs a page like this. The method is careful; the power is real; the judgement is still yours. Here's why that's not a limitation, how to run it safely, and the short list of things you should never let an agent do.
The core belief
Why human judgement always wins
Agents keep getting better at execution, and this pack is built to grow with them. What doesn't transfer is the part of SEO that was never mechanical. Treat the agent's output as a well-argued draft from a very fast junior: worth having, never the verdict.
The agent has no taste
It can verify that a title tag exists and matches the page. It cannot feel that the title is boring, off-brand, or quietly wrong for the audience you're actually after. Every judgement about what your site should say belongs to a human.
It has no strategy
The method finds and fixes what's broken, in the right order. It cannot decide whether you should even compete for a term, walk away from a market, or spend the next quarter on content instead of code. Strategy is choosing what not to do, and that's yours.
It has no accountability
When a change goes wrong, the agent doesn't feel it, and it isn't the one explaining a traffic drop. Whoever reviews and approves the change owns it. That's not a flaw to engineer away; it's the reason review exists.
It doesn't know what it doesn't know
An agent works from the page and the codebase. It can't know that the odd canonical is deliberate, that the thin page is a legal requirement, or that the redirect protects a partnership. Context lives with people, which is why the pack flags rather than bulldozes.
The practical conclusion isn't "trust nothing". It's a division of labour: the agent verifies, executes and remembers; the human decides, reviews and owns. Sites run that way get the speed of the machine and keep the sense of the person.
The path
How to use it well
Six habits that separate teams who get compounding value from this pack from teams who get a mess.
Start read-only
First run, change nothing. Use the read-only audit prompt so the agent diagnoses and reports without touching a file. You learn what state the site is in and how the agent reasons, at zero risk.
Review like a pull request
When you do let it fix, read the diff the way you'd review a colleague's work: is each change what was described, is it minimal, is anything along for the ride? Everything stays in version control, so nothing is final until you say so.
Fix bottom-up, in order
Follow the ladder: a broken lower rung caps everything above it. Polishing content on a page crawlers can't render is wasted work. The orchestrator sequences this for you; resist the urge to jump to the shiny layer.
Re-run, don't re-start
The audit remembers through the .seo/ folder. Re-running re-verifies old fixes (deploys quietly break things), finds what's new, and advances the backlog. Treat it like continuous testing, not an annual event.
Automate only the mechanical
Wire the unambiguous checks into CI so a deploy that makes pages uncrawlable fails the build. Keep the judgement calls, content quality, strategy, trust, in the periodic human-reviewed run where they belong.
Escalate when stakes are high
Migrations on revenue-bearing sites, manual actions, YMYL topics, big brands: bring in an experienced professional and let the pack be their accelerant. Knowing when you're out of depth is itself the judgement that wins.
The hard lines
What not to do
Most of these the pack refuses to do for you. All of them you shouldn't do either, because the cost lands months later and lands hard.
Don't auto-apply on a live site you haven't read
Letting an agent fix a production site unreviewed is how rankings get lost in an afternoon. The pack defaults to safe changes and flags the rest; keep it that way.
Don't fabricate trust signals, ever
Fake authors, invented reviews, placeholder ratings, credentials no one holds: the pack refuses these by design, and adding them by hand invites the penalty it was protecting you from. Missing trust signals are a to-do list for humans, not a fill-in-the-blank for machines.
Don't chase guarantees
Nothing guarantees rankings, and nothing guarantees AI citations. Anyone or anything promising either is overselling. The honest ceiling is eligibility: earning the right to compete.
Don't bump dates or fake freshness
Re-dating an unchanged post reads as fresh for a week and as dishonest forever. If a page genuinely changed, let the dates say so; if it didn't, leave them alone.
Don't mass-generate content
Filler at scale is the thin content every quality system is built to catch. The content skills edit what's real and brief what's missing; they don't spin. Neither should you.
Don't mark up what the page doesn't show
Structured data describes the visible page. Schema that claims more than the page shows risks losing rich results across the whole site, not just the offending URL.
Don't skip rungs
AEO formatting on a page that can't rank, content polish on a page crawlers can't see: work done above a broken rung is work wasted. Diagnose top-down, fix bottom-up.
Don't paste secrets into chats
API keys and tokens go in environment variables, never in a prompt, a commit, or the .seo/ folder. The pack's own integrations are built around that rule.
Knowing the limit
When to bring in a professional
The pack is a safety net for people building without an SEO, and a force-multiplier for people who have one. Some situations deserve the second kind:
- A migration or redesign on a site whose traffic pays salaries
- A manual action or a suspected penalty
- YMYL territory: health, finance, legal, safety
- A large brand where mistakes are public
- Sustained ranking loss with no obvious technical cause
- Competitive markets where strategy, not correctness, decides
Whoever you bring in, this pack still helps: it gives them a verified technical baseline on day one, and it gives you the vocabulary to evaluate what they propose. An informed client plus a good professional plus a tireless agent is the strongest team this field currently has.
Get the pack