Install RoamSEO skills
Which ways of adding RoamSEO include the SEO skills, how to check what your agent has, and how to add the skills where they're missing.
The RoamSEO plugins include the skills. Connectors and MCP connections don't.
Skills are instruction files that walk your agent through a complete SEO workflow, such as an audit or keyword research, and save the result as a report in your project. Every way of adding RoamSEO gives your agent the tools. Without the skills, it can still research what you ask for in plain language, but it won't follow RoamSEO's workflows.
| How you added RoamSEO | Skills included |
|---|---|
| RoamSEO plugin for Claude, ChatGPT or Codex | Yes |
| Claude connector | No |
| Custom connector, custom connection, or MCP server added by hand | No |
The Claude connector is tools-only in every Claude app, including Claude Code and Cowork.
Check what your agent has
| Agent | How to check |
|---|---|
| Claude | Type / and look for RoamSEO skills such as seo-coach or roamseo:seo-coach. |
| ChatGPT | Select RoamSEO with @, then ask which RoamSEO skills it can use. The @ menu doesn't list them. |
| Codex | Type $ and look for RoamSEO skills such as seo-coach. |
| Other agents | Look in the agent's skill list or skills folder for seo-coach. |
If your agent can list your RoamSEO projects but has no RoamSEO skills, it has the tools only. Add the skills below.
Add the skills
Claude
On a paid Claude plan, install the RoamSEO plugin. It includes the same tools as the connector.
- In the Claude app, claude.ai or Cowork: follow the Customize → Plugins steps.
- In Claude Code: run the two plugin commands.
On the Free plan, upload the skills instead. The plugin needs a paid plan. Keep the connector, or use a custom connector, then:
- Download the RoamSEO plugins repository as a ZIP (Code → Download ZIP) and unzip it.
- Open
plugins/roamseo/skillsand compress each skill folder you want into its own ZIP. Compress the folder itself, not the files inside it. - Upload each ZIP under Customize → Skills, then turn the skill on.
Skills in Claude chat and Cowork need Code execution and file creation turned on under Settings → Capabilities. On Team and Enterprise plans, an Owner controls this setting.
ChatGPT
Install the RoamSEO plugin for ChatGPT. A custom connection has the tools only.
Codex
Install the RoamSEO plugin for Codex, in the desktop app or the CLI.
Cursor, Hermes, Grok Bot and other agents
Connect RoamSEO MCP, then install the skills with the skills CLI:
npx skills add https://github.com/roamseo/roamseo-plugins/tree/main/plugins/roamseo/skillsIt asks which skills to install and for which agent. To skip the questions, add --skill '*' for every skill and --agent with your agent's name, such as --agent cursor.
For Hermes, install each skill through its skills hub instead, so Hermes can check for updates:
hermes skills install roamseo/roamseo-plugins/plugins/roamseo/skills/seo-coachFor Grok Bot, paste the setup prompt into your Bot.
To copy the files yourself, clone the RoamSEO plugins repository and copy the folders in plugins/roamseo/skills into your agent's skills folder, such as ~/.claude/skills or ~/.codex/skills.
Keep the skills up to date
RoamSEO updates the tools on its server. Skills are files in your agent, so they update through whatever installed them:
- ChatGPT plugin: nothing to do. The skills update when RoamSEO publishes a new version of the plugin.
- Claude plugin added under Customize: in Customize → Plugins, select Check for updates, or turn on Sync automatically for the RoamSEO marketplace.
- Everything else: use the update prompt or commands on Agent setup.
Next step
Start with SEO Project Setup for a new SEO project, or SEO Coach if you're not sure which workflow to run first.