RoamSEO

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 RoamSEOSkills included
RoamSEO plugin for Claude, ChatGPT or CodexYes
Claude connectorNo
Custom connector, custom connection, or MCP server added by handNo

The Claude connector is tools-only in every Claude app, including Claude Code and Cowork.

Check what your agent has

AgentHow to check
ClaudeType / and look for RoamSEO skills such as seo-coach or roamseo:seo-coach.
ChatGPTSelect RoamSEO with @, then ask which RoamSEO skills it can use. The @ menu doesn't list them.
CodexType $ and look for RoamSEO skills such as seo-coach.
Other agentsLook 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.

On the Free plan, upload the skills instead. The plugin needs a paid plan. Keep the connector, or use a custom connector, then:

  1. Download the RoamSEO plugins repository as a ZIP (Code → Download ZIP) and unzip it.
  2. Open plugins/roamseo/skills and compress each skill folder you want into its own ZIP. Compress the folder itself, not the files inside it.
  3. 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/skills

It 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-coach

For 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.