Ben Senescu 68fdcd9bf9
feat(skills): add seo-audit agent skill (#430)
* feat(skills): add beginner-seo-audit agent skill

A portable agent skill that audits a domain with OpenSEO and delivers a
one-page, plain-language HTML report for a non-SEO owner, centered on a
single do-this-week action. Ships with a frozen report template and a
docs page under Agent Skills.

* feat(skills): add starting-focus keyword step; cross-link from coach and project setup

- beginner-seo-audit now proposes a 'Where to focus first' area on healthy
  sites: one research_keywords call, one theme, 3-5 winnable keywords with
  what to make for each. Skipped entirely when the site is down.
- seo-coach and seo-project-setup now recommend beginner-seo-audit as the
  first workflow for a beginner with an existing site.
- Docs pages updated to match.

* refactor(skills): rename beginner-seo-audit to seo-audit

Audience-neutral name; the plain-language, one-action framing moves to
the description. Docs slug, meta.json, and coach/project-setup
cross-references updated to match.
2026-07-29 20:47:14 -04:00

51 lines
2.4 KiB
Markdown

---
title: "OpenSEO Agent Skills"
description: "Add OpenSEO Agent Skills to Claude Code, Codex, or another AI agent so it can run repeatable SEO workflows with live OpenSEO data."
---
OpenSEO Agent Skills let you hand repeatable SEO workflows to your AI agent.
Run a slash command when you need keyword research, clustering, competitor analysis, link prospecting, or project setup. The skill gives your agent the workflow instructions.
You stay in charge of strategy. Your agent uses OpenSEO data and the skill instructions to return a recommendation, plan, or shortlist.
## Set up OpenSEO Agent Skills
1. [Set up OpenSEO MCP](/docs/mcp).
2. [Set up OpenSEO Agent Skills](/docs/skills/setup).
MCP connects your agent to OpenSEO data. Skills tell your agent which SEO workflow to run.
## Start here
- [SEO Project Setup](/docs/skills/seo-project-setup): set up a durable project workspace so your agent can reuse goals, context, exports, and preferences across sessions.
- [SEO Coach](/docs/skills/seo-coach): choose the next workflow when you are new to SEO or unsure what to run first.
## Audit workflows
- [SEO Audit](/docs/skills/seo-audit): audit a site and get a one-page, plain-language report built around a single next action.
## Research workflows
- [Keyword Research](/docs/skills/keyword-research): find keywords worth targeting and explain why they fit.
- [Keyword Clustering](/docs/skills/keyword-clustering): turn keyword lists into page groups, content priorities, and cannibalization checks.
- [Competitive Landscape](/docs/skills/competitive-landscape): map who is winning across a market and where your openings are.
- [Competitor Analysis](/docs/skills/competitor-analysis): analyze one competitor and turn the research into strategic takeaways.
## Promotion workflows
- [Link Prospecting](/docs/skills/link-prospecting): find qualified outreach prospects and the angle that makes each one relevant.
## Learn more about skills
OpenSEO uses the same `SKILL.md` pattern supported by modern AI agents. To learn how skills work in your agent, read:
- [Claude Code skills documentation](https://docs.claude.com/en/docs/claude-code/skills)
- [OpenAI Skills documentation](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)
## Read the actual skills
These pages explain what each skill is for. The source instructions live in GitHub:
- [OpenSEO Agent Skills on GitHub](https://github.com/every-app/open-seo/tree/main/.agents/skills)