A collection of Agent Skills that give AI agents — Claude, ChatGPT, Codex, Cursor, and other Agent Skills-compatible tools — reusable SEO workflows built on the Semrush MCP server.
A skill is a self-contained Markdown instruction set that teaches an AI agent how to complete one specific task, such as
running a technical SEO audit or building a content brief. Each skill lives in its own folder in this repository and
contains a SKILL.md file with the workflow the agent follows. There is no service code here — only instructions.
Skills are designed to be used together with the Semrush MCP server: the skill defines the workflow, and the MCP server provides the underlying SEO data and tools. Once an agent has a skill loaded, it applies the same repeatable process every time instead of improvising a new approach.
| Category | Skill | What it does |
|---|---|---|
| Technical SEO | technical-seo-audit | Audit crawlability, Core Web Vitals, schema, and on-page signals in one pass |
| Technical SEO | internal-link-audit | Find orphan pages, broken internal links, depth issues, and missing hubs |
| Technical SEO | schema-markup | Audit, draft, and validate structured data without inventing entity facts |
| AI & Modern Search | ai-brand-visibility | Check whether ChatGPT, Gemini, and Perplexity mention your brand, and why |
| Keyword Research | keyword-research | Find keyword ideas with volume, difficulty, intent, and CPC, clustered by topic |
| Keyword Research | content-brief | Turn one keyword into a brief a writer can ship: intent, SERP context, outline, FAQs, linking plan |
| Rankings & SERPs | serp-analysis | Analyze the top 10 for any keyword: format, features, gaps, ranking strategy |
| Backlinks & Authority | backlink-audit | Audit a backlink profile: anchor distribution, toxicity, competitor gaps, broken-link recovery |
| Competitor Research | competitor-gap | Find keyword, content, and link gaps between your domain and your real search competitors |
These skills call Semrush data through the Semrush MCP server. Connect it in your agent first — setup instructions for Claude, Claude Code, ChatGPT, Cursor, VS Code, Perplexity and others are in the Semrush MCP documentation. Using Semrush MCP requires an eligible Semrush subscription with API access.
npx skills add semrush/skills
npx skills add semrush/skills/technical-seo-audit
Copy the skill's folder into your agent's skills directory (for example, .claude/skills/ for Claude Code), then
restart the agent so it picks up the new skill.
Once a skill is installed and Semrush MCP is connected, describe the task in plain language — for example, "run a technical SEO audit on example.com" — and the agent will follow the skill's workflow, pulling live data from Semrush as it goes.
AI responses may be incomplete or inaccurate. Verify results before using them for decisions, publication, or other critical work.
Licensed under the Apache License 2.0. See NOTICE for attribution requirements.
See CONTRIBUTING.md for how changes to this repository are reviewed and approved.