What is the SEO Skill for OpenCode?
OpenCode is an open-source coding agent for the terminal: it reads `AGENTS.md` for project instructions, switches between a planning agent and a building agent, understands your code through language servers, and runs on Anthropic, OpenAI, Google or a local model — your key, your choice. The SEOAgent Skill gives it an SEO procedure: a technical audit with a fix per finding, keyword research with real volume and difficulty, briefs and articles written as files in your repository, and a daily sync loop. OpenCode reads the Skill through `AGENTS.md`, runs the `seoagent` commands in its shell, and shows every edit for review. Nothing publishes on its own.
Three steps, about three minutes
- Choose how you work. The card above asks once; pick Coding agent, then Other and type your site.
- Paste the prompt. One paste into your coding agent installs the Skill, binds the site to your account and runs the first audit.
- Watch it bind. The card turns green the moment the code is redeemed; if nothing happens in three minutes it asks what you saw and routes you.
How to use SEOAgent in OpenCode
Create the prompt on this page
Type your site in the card above and choose Coding agent → Other. The paste block carries a one-time setup code: it installs the CLI, runs `seoagent init --code <code>`, and tells the agent where the Skill lives. The code is bound to your account and works once.
Paste it into OpenCode, in the repo
In a terminal, `cd` into the repository that builds your site, start `opencode`, and paste the block in build mode. OpenCode asks before running shell commands — approve the install and the `init`. `seoagent init` writes the Skill bundle (`.agents/skills/seoagent/` when the repo uses `.agents/`, otherwise `.claude/skills/seoagent/`) and adds a SEOAgent section to `AGENTS.md` — the file OpenCode already reads on every session.
Nothing else to configure
Because `seoagent init` writes the pointer into `AGENTS.md`, OpenCode finds the Skill on its own from the next session. If your team keeps a global `~/.config/opencode/AGENTS.md`, one line there — `For SEO work, read the SEOAgent SKILL.md in the project` — carries it across repos.
Plan the audit, build the fixes
In plan mode say "audit my site and propose the fixes". The Skill fetches the homepage, sitemap and robots.txt and reports findings with the exact change for each. Switch to build and OpenCode applies them — metadata, schema, canonicals, internal links — showing each diff. Approve what makes sense.
Write content into the repo
Ask for keyword research and an article or landing page. The Skill writes the files where your framework expects them, internally linked into the cluster, and `seoagent content track` tells the dashboard what shipped. A reviewed commit puts them live.
Give it a weekday routine
OpenCode has no scheduler, so the block adds a cron line — `0 9 * * 1-5 cd <repo> && seoagent sync --silent` — that keeps `.seoagent/inbox/` fresh. Each weekday morning start `opencode` in the repo and say "process the inbox"; it works the items and runs `seoagent ack` for each, and writes what it learns to `.seoagent/` for the next session.
What SEOAgent does in OpenCode
Technical audits with the fix attached
Each finding names the file and the change, so build mode applies it instead of describing it.
Any provider, any model
The Skill is a procedure and a CLI, not a model. It works on whichever provider OpenCode is configured for — including a local one.
AGENTS.md-native
`seoagent init` writes the pointer into the file OpenCode already reads, so there is no extra rule to maintain.
Keyword research with real numbers
`seoagent keywords` pulls volume and difficulty so content targets queries you can win.
Content as files
Articles and landing pages are written into the repo with metadata and internal links already set.
Search Console grounding
`seoagent login` connects Google Search Console once; the Skill then reads your real queries and pages.
Approval before every write
OpenCode shows each edit and asks before shell commands; the block tells it to stop and report if the bind fails.
AI search readiness
`seoagent llms` builds an `llms.txt` from your page inventory; `seoagent okf` serves an Open Knowledge Format bundle.
Frequently asked questions
How do I add SEO to OpenCode?
Create the prompt on this page and paste it into `opencode` running in the repository that builds your site. It installs the SEOAgent CLI and Skill, binds the site to your account, adds the pointer to `AGENTS.md`, and runs the first audit.
Is the SEO Skill for OpenCode free?
Yes. The Skill runs on the model you already bring to OpenCode and is free forever. Autopilot ($49 per site per month, 7-day free trial at the first bind) adds Search Console measurement, keyword and competitor research, and briefs and articles written for you.
Does it work with a local model?
The Skill is a procedure and a CLI, so it runs on whatever model OpenCode uses. Smaller local models follow the audit checklist well; writing long articles is better on a frontier model, and Autopilot can write them for you either way.
Will OpenCode publish content without me?
No. Every edit is shown for approval, and pages go live when you commit and deploy. SEOAgent never publishes to a CMS itself.
What if the paste fails?
The block tells the agent to stop and report the exact error, never to continue unbound. The card waits for the bind and, after three minutes, asks what you saw and routes you. Codes live 14 days and work once.
Does it work on a site without a repository?
If the site is on a hosted platform (WordPress.com, Shopify, Webflow, Wix and others) the block says so and OpenCode runs the setup in an empty folder; delivery goes through the platform’s API or the editor. With no agent at all, use the "Just my website" door.
How is this different from writing SEO instructions in AGENTS.md?
Instructions are context; the Skill is a procedure plus a CLI that fetches real data — `seoagent crawl`, `seoagent keywords`, `seoagent indexing`. `AGENTS.md` only needs to point at it, and `seoagent init` writes that pointer for you.
How do I update the Skill?
Run `npm install -g @seoagent-official/seoagent@latest`, then `seoagent init` again in the project. It refreshes the bundle and leaves `.seoagent/` untouched.
See also
Give OpenCode the SEO harness
Enter your site, create the prompt, and paste it into OpenCode — the Skill installs, the site binds, and the first audit runs in minutes.
Want measurement on top? See Autopilot pricing.
What do you use to work on your site?
Claude Code, Cursor, Codex or another terminal agent, in the repo that builds your site.
You get a prompt with a one-time code. Paste it into your coding agent; it installs the Skill, binds the site, and runs the first audit.
Free for your own agent. Autopilot is the paid part.
Start your 7-day free trial, no card · $49/site/month after · we stop if nothing improves