AkaiSEO
Back to Docs

Set up AkaiSEO Agent Skills

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

AkaiSEO Agent Skills are separate files from AkaiSEO MCP.

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

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

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

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 MohammedIbraAhmed/akaiseo

Option 2: Install all AkaiSEO skills

Use this if you want every AkaiSEO skill.

npx skills add MohammedIbraAhmed/akaiseo --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 MohammedIbraAhmed/akaiseo --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 MohammedIbraAhmed/akaiseo --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/MohammedIbraAhmed/akaiseo.git

# Codex
mkdir -p ~/.codex/skills
cp -R akaiseo/.agents/skills/* ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R akaiseo/.agents/skills/* ~/.claude/skills/

You can also review the source skills on GitHub:

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

Run a skill

After the skill files are available to your agent, run the matching slash command:

  • /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.