AI SEO Malaysia
Back to Docs

Set up AI SEO Agent Skills

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

AI SEO Agent Skills are separate files from AI SEO MCP.

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

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

Then add the AI SEO 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 insightseomy/aiseo-plugin

Option 2: Install all AI SEO skills

Use this if you want every AI SEO skill.

npx skills add insightseomy/aiseo-plugin --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 insightseomy/aiseo-plugin --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 insightseomy/aiseo-plugin --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/insightseomy/aiseo-plugin.git

# Codex
mkdir -p ~/.codex/skills
cp -R aiseo-plugin/plugins/aiseo/skills/* ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R aiseo-plugin/plugins/aiseo/skills/* ~/.claude/skills/

Update installed skills

Use the update prompt or commands for your installation method. Update the AI SEO 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 /aiseo: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.