Back to Docs

Set up GeniusRank Agent Skills

Add GeniusRank skill files to your AI agent after connecting GeniusRank MCP.

GeniusRank Agent Skills are separate files from GeniusRank MCP.

On Claude Code or Claude Cowork, skip the steps below and use the GeniusRank plugin instead — it installs MCP and every skill in one step. On Codex CLI, use the GeniusRank plugin the same way.

First, set up GeniusRank MCP. MCP gives your agent access to GeniusRank data.

Then add the GeniusRank SKILL.md files you want your agent to use. Each skill gives your agent one SEO workflow.

ChatGPT

Use the ChatGPT setup guide. A directory plugin can include skills; a custom MCP connection provides tools only. You can ask for SEO research in plain language with those tools. The terminal commands below apply to agents with a local skills installer, such as Codex or Claude Code.

Choose an installation option

Pick the option that matches how you want to install the files.

Option 1: Install and choose interactively

Use this if you want the installer to show the available skills and agents.

npx skills add every-app/open-seo

Option 2: Install all GeniusRank skills

Use this if you want every GeniusRank skill.

npx skills add every-app/open-seo --skill '*'

Option 3: Install all skills for Claude Code only

Use this if the skills should be available in Claude Code only.

npx skills add every-app/open-seo --skill '*' --agent claude-code

Option 4: Install all skills for OpenAI Codex only

Use this if the skills should be available in Codex only.

npx skills add every-app/open-seo --skill '*' --agent codex

Option 5: Copy the skill files manually

Use this if you prefer to copy files into your agent's skills folder.

git clone https://github.com/every-app/open-seo.git

# Codex
mkdir -p ~/.codex/skills
cp -R open-seo/plugins/openseo/skills/* ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R open-seo/plugins/openseo/skills/* ~/.claude/skills/

You can also review the source skills on GitHub:

Each skill page also links to its source SKILL.md.

Update installed skills

Use the update prompt or commands for your installation method. Update the GeniusRank plugin if it supplies your skills; otherwise use the installer you originally chose or update your manual copies.

Run a skill

Use your agent's skill picker or ask for a workflow by name. In Codex, type $; Claude Code plugin skills use /openseo:skill-name. Other clients have their own invocation syntax. The available workflows include:

  • seo-project-setup
  • seo-coach
  • keyword-research
  • keyword-clustering
  • competitive-landscape
  • competitor-analysis
  • link-prospecting
  • local-seo
  • seo-audit

Next step

Start with SEO Project Setup if this is a new SEO project, or SEO Coach if you are not sure which workflow to run first.