diff --git a/.agents/skills/create-repo-skill/SKILL.md b/.agents/skills/create-repo-skill/SKILL.md index 45227b9..dec3da9 100644 --- a/.agents/skills/create-repo-skill/SKILL.md +++ b/.agents/skills/create-repo-skill/SKILL.md @@ -34,11 +34,11 @@ metadata: ln -s ../../.agents/skills/ .claude/skills/ ``` - - **Public product skill** (a customer-facing SEO workflow): no `internal` flag, usually no `.claude/skills` symlink (repo agents don't need customer workflows). Register it everywhere users discover skills: - - `web/content/docs/skills/.mdx` — docs page (mirror a sibling like `competitor-analysis.mdx`: what it does, when to use it, what you get back, how to get the best result) + - **Public product skill** (a customer-facing SEO workflow): no `internal` flag, prefix `` with `openseo-` (e.g. `openseo-competitor-analysis`) so it's easy to find and doesn't clash with skills from other sources when a user installs skills from multiple repos. Usually no `.claude/skills` symlink (repo agents don't need customer workflows). The `openseo-` prefix applies to the skill directory, its `name:` frontmatter, and the slash command/install docs — **not** the website doc slug: the site is already `openseo.so`, so `web/content/docs/skills/.mdx` and its links keep the short, unprefixed slug (e.g. `competitor-analysis.mdx`, linked from a skill's `RunSkillCallout` as `/openseo-competitor-analysis` but cross-referenced from other doc pages as `/docs/skills/competitor-analysis`). Register it everywhere users discover skills: + - `web/content/docs/skills/.mdx` — docs page (mirror a sibling like `competitor-analysis.mdx`: what it does, when to use it, what you get back, how to get the best result) - `web/content/docs/skills/index.md` — bullet in the right workflow section - `web/content/docs/skills/meta.json` — nav entry - - `.agents/skills/seo-coach/SKILL.md` — one line in the "What each workflow does" roster + - `.agents/skills/openseo-coach/SKILL.md` — one line in the "What each workflow does" roster - Optional: `web/src/lib/feature-pages.ts` and `web/content/docs/skills/setup.md` if it deserves marketing/setup placement 3. If the skill references MCP tools, use exact tool names and keep them in sync with `src/server/mcp/server.ts` — the tool names in skills are load-bearing for agents following them. diff --git a/.agents/skills/seo-audit/SKILL.md b/.agents/skills/openseo-audit/SKILL.md similarity index 93% rename from .agents/skills/seo-audit/SKILL.md rename to .agents/skills/openseo-audit/SKILL.md index 0da5a1a..b68f7eb 100644 --- a/.agents/skills/seo-audit/SKILL.md +++ b/.agents/skills/openseo-audit/SKILL.md @@ -1,5 +1,5 @@ --- -name: seo-audit +name: openseo-audit description: "Audit a website and deliver a one-page, plain-language SEO report anyone can act on, centered on a single do-this-week action." --- @@ -9,7 +9,7 @@ description: "Audit a website and deliver a one-page, plain-language SEO report Audit a domain and produce a one-page HTML report that anyone, including a complete SEO beginner, can read once and act on. The whole report exists to support ONE action the owner can take this week; everything else is supporting detail. -Use this when asked for an SEO audit or review of a domain, especially when the output is a shareable report for a non-expert. For expert-facing analysis of a competitor or market, use `competitor-analysis` or `competitive-landscape` instead. +Use this when asked for an SEO audit or review of a domain, especially when the output is a shareable report for a non-expert. For expert-facing analysis of a competitor or market, use `openseo-competitor-analysis` or `openseo-competitive-landscape` instead. ## Required inputs @@ -25,7 +25,7 @@ Use this when asked for an SEO audit or review of a domain, especially when the - `get_domain_overview`: estimated organic traffic and organic keyword count. Skip when the site is clearly dead. - `research_keywords`: keyword ideas with volume and difficulty, used to propose a starting focus area. One call with 1-3 seeds taken from what the site is actually about. Skip when the site is down. -Keep total spend modest: one audit, one backlinks overview, at most one domain overview, and at most one keyword-research call. Only the overview and keyword lookups spend credits. +Keep total spend modest: one audit, one backlinks overview, at most one domain overview, and at most one keyword research call. Only the overview and keyword lookups spend credits. ## Workflow @@ -39,7 +39,7 @@ Keep total spend modest: one audit, one backlinks overview, at most one domain o - Dead domain, live successor site: permanent redirect via hosting support, with the exact sentence to send them. - Blocked or noindexed pages: remove the block. It must be doable this week by a non-technical person, with copy-paste-ready mechanics included. -7. When the site is healthy, propose a starting focus area: run one `research_keywords` call seeded from the site's actual topic, then pick one theme and 3 to 5 specific, low-difficulty keywords the site can realistically rank for, each with the page or post to make. This is a starting direction, not a keyword strategy; point the user at the `keyword-research` skill for the full workflow. Skip this step entirely when the site is down — the one thing is all that matters there. +7. When the site is healthy, propose a starting focus area: run one `research_keywords` call seeded from the site's actual topic, then pick one theme and 3 to 5 specific, low-difficulty keywords the site can realistically rank for, each with the page or post to make. This is a starting direction, not a keyword strategy; point the user at the `openseo-keyword-research` skill for the full workflow. Skip this step entirely when the site is down — the one thing is all that matters there. 8. Write the report using `template.html` in this skill directory (see Output format). 9. Review before delivering: run an adversarial pass with a second agent or model if your environment has one, otherwise do a fresh self-review. Give the reviewer the verified facts and have it attack four things: claims beyond the facts, unglossed jargon, anything overwhelming for a beginner, and dramatic language. The reviewer may also flag true facts it was not given; check those against your evidence instead of "fixing" them. 10. Deliver the report: if your environment can publish or preview HTML (for example as an artifact), do that; otherwise save the HTML file and tell the user to open it in their browser. diff --git a/.agents/skills/seo-audit/template.html b/.agents/skills/openseo-audit/template.html similarity index 100% rename from .agents/skills/seo-audit/template.html rename to .agents/skills/openseo-audit/template.html diff --git a/.agents/skills/seo-coach/SKILL.md b/.agents/skills/openseo-coach/SKILL.md similarity index 79% rename from .agents/skills/seo-coach/SKILL.md rename to .agents/skills/openseo-coach/SKILL.md index 82bbebb..f9f2dae 100644 --- a/.agents/skills/seo-coach/SKILL.md +++ b/.agents/skills/openseo-coach/SKILL.md @@ -1,5 +1,5 @@ --- -name: seo-coach +name: openseo-coach description: Enter a friendly OpenSEO coach mode that explains workflows, recommends next steps, and helps users use agents, web search, scraping, and MCP data effectively. --- @@ -38,14 +38,14 @@ Good starting points: ## What each workflow does -- `seo-project-setup`: sets up the workspace, verifies MCP, captures goals and positioning, and connects Google Search Console (or imports GSC exports). -- `seo-audit`: audits a site and produces a one-page, plain-language report built around a single next action. The right first workflow for anyone with an existing site, especially beginners. -- `keyword-research`: finds search opportunities from seed topics and evaluates volume, difficulty, CPC, intent, and SERPs. -- `keyword-clustering`: groups keywords by intent and maps clusters to existing or proposed pages. -- `competitive-landscape`: identifies who wins across a market and what content/backlink patterns are working. -- `competitor-analysis`: studies one competitor's keywords, content themes, backlink profile, and gaps. -- `local-seo`: audits a Google Business Profile against local competitors and maps Maps visibility around a location. -- `link-prospecting`: finds likely link opportunities, discovers contact paths, and drafts outreach. +- `openseo-project-setup`: sets up the workspace, verifies MCP, captures goals and positioning, and connects Google Search Console (or imports GSC exports). +- `openseo-audit`: audits a site and produces a one-page, plain-language report built around a single next action. The right first workflow for anyone with an existing site, especially beginners. +- `openseo-keyword-research`: finds search opportunities from seed topics and evaluates volume, difficulty, CPC, intent, and SERPs. +- `openseo-keyword-clustering`: groups keywords by intent and maps clusters to existing or proposed pages. +- `openseo-competitive-landscape`: identifies who wins across a market and what content/backlink patterns are working. +- `openseo-competitor-analysis`: studies one competitor's keywords, content themes, backlink profile, and gaps. +- `openseo-local-seo`: audits a Google Business Profile against local competitors and maps Maps visibility around a location. +- `openseo-link-prospecting`: finds likely link opportunities, discovers contact paths, and drafts outreach. ## Tool coaching diff --git a/.agents/skills/competitive-landscape/SKILL.md b/.agents/skills/openseo-competitive-landscape/SKILL.md similarity index 97% rename from .agents/skills/competitive-landscape/SKILL.md rename to .agents/skills/openseo-competitive-landscape/SKILL.md index 0883708..b61c7db 100644 --- a/.agents/skills/competitive-landscape/SKILL.md +++ b/.agents/skills/openseo-competitive-landscape/SKILL.md @@ -1,5 +1,5 @@ --- -name: competitive-landscape +name: openseo-competitive-landscape description: Map SEO market leaders, winning content themes, keyword coverage, backlinks, and strategic gaps. --- @@ -9,7 +9,7 @@ description: Map SEO market leaders, winning content themes, keyword coverage, b Answer: "Who is winning this SEO market, what content is working for them, and where are the openings?" -Use this when the user wants a market-level view across several competitors. For a deep dive on one domain, use `competitor-analysis`. +Use this when the user wants a market-level view across several competitors. For a deep dive on one domain, use `openseo-competitor-analysis`. ## Required inputs diff --git a/.agents/skills/competitor-analysis/SKILL.md b/.agents/skills/openseo-competitor-analysis/SKILL.md similarity index 98% rename from .agents/skills/competitor-analysis/SKILL.md rename to .agents/skills/openseo-competitor-analysis/SKILL.md index 1ca9333..66d500e 100644 --- a/.agents/skills/competitor-analysis/SKILL.md +++ b/.agents/skills/openseo-competitor-analysis/SKILL.md @@ -1,5 +1,5 @@ --- -name: competitor-analysis +name: openseo-competitor-analysis description: "Analyze one competitor's organic footprint, ranking keywords, content themes, backlinks, and gaps." --- @@ -9,7 +9,7 @@ description: "Analyze one competitor's organic footprint, ranking keywords, cont Analyze one competitor deeply enough to decide what to learn from, avoid, counter-position against, or outrank. -Use this for a named competitor. For identifying the market leaders first, use `competitive-landscape`. +Use this for a named competitor. For identifying the market leaders first, use `openseo-competitive-landscape`. ## Required inputs diff --git a/.agents/skills/keyword-clustering/SKILL.md b/.agents/skills/openseo-keyword-clustering/SKILL.md similarity index 99% rename from .agents/skills/keyword-clustering/SKILL.md rename to .agents/skills/openseo-keyword-clustering/SKILL.md index 0fbadf7..1371fba 100644 --- a/.agents/skills/keyword-clustering/SKILL.md +++ b/.agents/skills/openseo-keyword-clustering/SKILL.md @@ -1,5 +1,5 @@ --- -name: keyword-clustering +name: openseo-keyword-clustering description: Cluster keywords by intent and map them to existing or proposed pages. --- diff --git a/.agents/skills/keyword-research/SKILL.md b/.agents/skills/openseo-keyword-research/SKILL.md similarity index 99% rename from .agents/skills/keyword-research/SKILL.md rename to .agents/skills/openseo-keyword-research/SKILL.md index 4bdfc40..65893c9 100644 --- a/.agents/skills/keyword-research/SKILL.md +++ b/.agents/skills/openseo-keyword-research/SKILL.md @@ -1,5 +1,5 @@ --- -name: keyword-research +name: openseo-keyword-research description: "Discover keyword opportunities, evaluate metrics and SERPs, and save/tag promising terms." --- diff --git a/.agents/skills/link-prospecting/SKILL.md b/.agents/skills/openseo-link-prospecting/SKILL.md similarity index 99% rename from .agents/skills/link-prospecting/SKILL.md rename to .agents/skills/openseo-link-prospecting/SKILL.md index e9b9fb7..f2c3fa7 100644 --- a/.agents/skills/link-prospecting/SKILL.md +++ b/.agents/skills/openseo-link-prospecting/SKILL.md @@ -1,5 +1,5 @@ --- -name: link-prospecting +name: openseo-link-prospecting description: Find link prospects, discover contact paths, and draft outreach from SERPs and backlink signals. --- diff --git a/.agents/skills/local-seo/SKILL.md b/.agents/skills/openseo-local-seo/SKILL.md similarity index 97% rename from .agents/skills/local-seo/SKILL.md rename to .agents/skills/openseo-local-seo/SKILL.md index a7e7f3a..24fcae2 100644 --- a/.agents/skills/local-seo/SKILL.md +++ b/.agents/skills/openseo-local-seo/SKILL.md @@ -1,5 +1,5 @@ --- -name: local-seo +name: openseo-local-seo description: "Audit a Google Business Profile, compare it to local competitors, and map Maps visibility around a location." --- @@ -9,7 +9,7 @@ description: "Audit a Google Business Profile, compare it to local competitors, Work out why a business does or does not show up in Google Maps and the local pack near its customers, and what to fix first. -Use this when rankings depend on a physical location or service area. For national organic work, use `competitor-analysis` or `keyword-research`. +Use this when rankings depend on a physical location or service area. For national organic work, use `openseo-competitor-analysis` or `openseo-keyword-research`. ## Required inputs diff --git a/.agents/skills/seo-project-setup/SKILL.md b/.agents/skills/openseo-project-setup/SKILL.md similarity index 89% rename from .agents/skills/seo-project-setup/SKILL.md rename to .agents/skills/openseo-project-setup/SKILL.md index 688397e..73e958b 100644 --- a/.agents/skills/seo-project-setup/SKILL.md +++ b/.agents/skills/openseo-project-setup/SKILL.md @@ -1,5 +1,5 @@ --- -name: seo-project-setup +name: openseo-project-setup description: Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake. --- @@ -98,7 +98,7 @@ Do not run research tools just to test connectivity; `whoami` and `list_projects GSC is the richest first-party signal: existing impressions, near-ranking terms, cannibalization, and pages that already have search demand. -**Preferred (hosted): connect it natively.** On the project's Integrations page, connect Google Search Console and pull live data with `get_search_console_performance`. Once connected, the agent reads it directly in `keyword-research` and `keyword-clustering` — no manual files to maintain. +**Preferred (hosted): connect it natively.** On the project's Integrations page, connect Google Search Console and pull live data with `get_search_console_performance`. Once connected, the agent reads it directly in `openseo-keyword-research` and `openseo-keyword-clustering` — no manual files to maintain. **Fallback (self-hosted, or if the user prefers files):** ask the user to export CSVs from Search Console into the SEO working folder. @@ -134,12 +134,12 @@ Ask for or discover: After intake, recommend one next OpenSEO workflow: -- `seo-audit`: when the site already exists and the user wants to know what to fix or do first, especially if they are new to SEO -- `keyword-research`: when the user needs ideas from seed topics -- `keyword-clustering`: when they have keywords or GSC data to map to pages -- `competitive-landscape`: when the market is unclear -- `competitor-analysis`: when they know a competitor to study -- `link-prospecting`: when they have a linkable asset or target page +- `openseo-audit`: when the site already exists and the user wants to know what to fix or do first, especially if they are new to SEO +- `openseo-keyword-research`: when the user needs ideas from seed topics +- `openseo-keyword-clustering`: when they have keywords or GSC data to map to pages +- `openseo-competitive-landscape`: when the market is unclear +- `openseo-competitor-analysis`: when they know a competitor to study +- `openseo-link-prospecting`: when they have a linkable asset or target page ## Output format diff --git a/.agents/skills/simple-issue-description/SKILL.md b/.agents/skills/openseo-simple-issue-description/SKILL.md similarity index 98% rename from .agents/skills/simple-issue-description/SKILL.md rename to .agents/skills/openseo-simple-issue-description/SKILL.md index 1c096d2..6b52373 100644 --- a/.agents/skills/simple-issue-description/SKILL.md +++ b/.agents/skills/openseo-simple-issue-description/SKILL.md @@ -1,6 +1,6 @@ --- -name: simple-issue-description -description: Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior. Use when a contributor asks to simplify an issue, explain what a PR is for, create the corresponding issue for a PR, remove implementation detail from a report, or invokes /simple-issue-description. +name: openseo-simple-issue-description +description: Turn a rough bug report, feature request, support note, or pull request into a short, plain-language issue focused on the problem and desired behavior. Use when a contributor asks to simplify an issue, explain what a PR is for, create the corresponding issue for a PR, remove implementation detail from a report, or invokes /openseo-simple-issue-description. --- # Simple Issue Description diff --git a/.agents/skills/openseo-simple-issue-description/agents/openai.yaml b/.agents/skills/openseo-simple-issue-description/agents/openai.yaml new file mode 100644 index 0000000..b6acf85 --- /dev/null +++ b/.agents/skills/openseo-simple-issue-description/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: "OpenSEO Simple Issue Description" + short_description: "Turn rough reports into clear, simple issues" + default_prompt: "Use $openseo-simple-issue-description to turn this report or PR into a clear issue focused on the problem and desired behavior." diff --git a/.agents/skills/simple-issue-description/agents/openai.yaml b/.agents/skills/simple-issue-description/agents/openai.yaml deleted file mode 100644 index da55673..0000000 --- a/.agents/skills/simple-issue-description/agents/openai.yaml +++ /dev/null @@ -1,4 +0,0 @@ -interface: - display_name: "Simple Issue Description" - short_description: "Turn rough reports into clear, simple issues" - default_prompt: "Use $simple-issue-description to turn this report or PR into a clear issue focused on the problem and desired behavior." diff --git a/README.md b/README.md index 9a874a2..13ecc4f 100644 --- a/README.md +++ b/README.md @@ -70,10 +70,10 @@ Creating clear issues is the best way to contribute. Read more here: [`docs/CONTRIBUTING.md`](./docs/CONTRIBUTING.md) -We have this skill: `/simple-issue-description` which helps. +We have this skill: `/openseo-simple-issue-description` which helps. ```sh -npx skills add every-app/open-seo --skill simple-issue-description +npx skills add every-app/open-seo --skill openseo-simple-issue-description ``` ## Community diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 1004c98..6e1d3fe 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -24,25 +24,25 @@ Yup! I just won't merge them right now. But, making a PR can be a good way to im Videos demoing the feature also help a lot here too since its a sign that the PR wasn't just made by Claude and never tested. -### /simple-issue-description +### /openseo-simple-issue-description -For ease of review, I would appreciate if you used the `/simple-issue-description` to refine your issue. I'm hoping that everything being written in the same voice and format will make it easier to understand issues without a lot of back and forth. +For ease of review, I would appreciate if you used the `/openseo-simple-issue-description` to refine your issue. I'm hoping that everything being written in the same voice and format will make it easier to understand issues without a lot of back and forth. Install it with: ```sh -npx skills add every-app/open-seo --skill simple-issue-description +npx skills add every-app/open-seo --skill openseo-simple-issue-description ``` See [Set up OpenSEO Agent Skills](https://openseo.so/docs/skills/setup) for other install options. -Here is what we're aiming for with `/simple-issue-description`: +Here is what we're aiming for with `/openseo-simple-issue-description`: - There is sufficient detail in the issue. - What is the problem you're facing? - What is the full user experience for the feature you're proposing? - Succinct i.e. not default Claude output. - - I have an `/explain-simply` skill I use all the time which inspired `/simple-issue-description` + - I have an `/explain-simply` skill I use all the time which inspired `/openseo-simple-issue-description` - I can't understand the default Claude / Codex output at this point. ### Our Roadmap diff --git a/specs/0005-onboarding-agent.md b/specs/0005-onboarding-agent.md index bb21fef..ac0989d 100644 --- a/specs/0005-onboarding-agent.md +++ b/specs/0005-onboarding-agent.md @@ -132,14 +132,14 @@ v1. Free: the full strategy, positioning, themes, capped starter keyword list (~15–20), and the "do next" list. Gated (execution): rank-tracking the proposed keywords, full keyword expansion, content briefs per theme, and the ongoing -`seo-coach`. Every gated action is a named thing tied to a strategy item the +`openseo-coach`. Every gated action is a named thing tied to a strategy item the user already believes in — stronger pull than "refine further." GSC stays behind the gate; we do **not** prompt for it during onboarding (connecting then hitting a paywall is exactly the bait-and-switch the UX audit warned against). -## Unify the seo-coach skill +## Unify the openseo-coach skill -Update the `seo-coach` skill (and `onboarding-checklist`) so the coach and the +Update the `openseo-coach` skill (and `onboarding-checklist`) so the coach and the onboarding agent are one continuous experience: the coach reads Project Context via MCP, picks up where onboarding left off ("here's your strategy — let's work the backlog"), and can answer both SEO questions and OpenSEO product questions. diff --git a/src/routes/_app/ai.tsx b/src/routes/_app/ai.tsx index af3d5f6..5a57c90 100644 --- a/src/routes/_app/ai.tsx +++ b/src/routes/_app/ai.tsx @@ -14,13 +14,13 @@ const DISCORD_URL = "https://discord.gg/c9uGs3cFXr"; const SUPPORT_EMAIL = "ben@openseo.so"; const SAM_GITHUB_URL = "https://github.com/every-app/sam"; const SKILL_NAMES = [ - "seo-project-setup", - "seo-coach", - "keyword-research", - "keyword-clustering", - "competitive-landscape", - "competitor-analysis", - "link-prospecting", + "openseo-project-setup", + "openseo-coach", + "openseo-keyword-research", + "openseo-keyword-clustering", + "openseo-competitive-landscape", + "openseo-competitor-analysis", + "openseo-link-prospecting", ]; const SKILLS_INSTALL = `npx skills add every-app/open-seo`; const ALL_SKILLS_INSTALL = `npx skills add every-app/open-seo --skill '*'`; @@ -267,7 +267,7 @@ function AiPage() {

Start with{" "} - /seo-project-setup + /openseo-project-setup . It will ask about your project and help configure your workspace. diff --git a/web/content/docs/skills/competitive-landscape.mdx b/web/content/docs/skills/competitive-landscape.mdx index 83af522..2da03bd 100644 --- a/web/content/docs/skills/competitive-landscape.mdx +++ b/web/content/docs/skills/competitive-landscape.mdx @@ -3,7 +3,7 @@ title: "Competitive Landscape Agent Skill" description: "Run competitive SEO research with your AI agent: map market leaders, content patterns, keyword coverage, backlinks, and gaps." --- - + The Competitive Landscape Agent Skill maps the SEO market before you decide what to build. @@ -44,7 +44,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can research keywords, inspect SER The source `SKILL.md` lives on GitHub: -- [Competitive Landscape skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/competitive-landscape) +- [Competitive Landscape skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-competitive-landscape) ## Related skills diff --git a/web/content/docs/skills/competitor-analysis.mdx b/web/content/docs/skills/competitor-analysis.mdx index 2d29892..ff59c52 100644 --- a/web/content/docs/skills/competitor-analysis.mdx +++ b/web/content/docs/skills/competitor-analysis.mdx @@ -3,7 +3,7 @@ title: "Competitor Analysis Agent Skill" description: "Analyze one competitor's keywords, pages, backlinks, content themes, and SEO gaps with your AI agent." --- - + The Competitor Analysis Agent Skill studies one competitor and turns the research into strategic takeaways. @@ -46,7 +46,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can inspect domain overview data, The source `SKILL.md` lives on GitHub: -- [Competitor Analysis skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/competitor-analysis) +- [Competitor Analysis skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-competitor-analysis) ## Related skills diff --git a/web/content/docs/skills/keyword-clustering.mdx b/web/content/docs/skills/keyword-clustering.mdx index 296ebcb..e961c47 100644 --- a/web/content/docs/skills/keyword-clustering.mdx +++ b/web/content/docs/skills/keyword-clustering.mdx @@ -3,7 +3,7 @@ title: "Keyword Clustering Agent Skill" description: "Cluster keywords by intent and map them to existing or proposed pages with your AI agent." --- - + The Keyword Clustering Agent Skill turns a messy keyword list into a page plan. @@ -45,7 +45,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can read saved keywords, inspect S The source `SKILL.md` lives on GitHub: -- [Keyword Clustering skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/keyword-clustering) +- [Keyword Clustering skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-keyword-clustering) ## Related skills diff --git a/web/content/docs/skills/keyword-research.mdx b/web/content/docs/skills/keyword-research.mdx index 8ebd1a7..a28213d 100644 --- a/web/content/docs/skills/keyword-research.mdx +++ b/web/content/docs/skills/keyword-research.mdx @@ -3,7 +3,7 @@ title: "Keyword Research Agent Skill" description: "Find keyword opportunities from live SEO data with Claude Code, Codex, or another AI agent." --- - + The Keyword Research Agent Skill finds keywords your site can target. @@ -45,7 +45,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can research live keyword metrics, The source `SKILL.md` lives on GitHub: -- [Keyword Research skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/keyword-research) +- [Keyword Research skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-keyword-research) ## Related skills diff --git a/web/content/docs/skills/link-prospecting.mdx b/web/content/docs/skills/link-prospecting.mdx index 40483cc..6b4bbc6 100644 --- a/web/content/docs/skills/link-prospecting.mdx +++ b/web/content/docs/skills/link-prospecting.mdx @@ -3,7 +3,7 @@ title: "Link Prospecting Agent Skill" description: "Find relevant link prospects from SERPs, competitor backlinks, and topical publishers with your AI agent." --- - + The Link Prospecting Agent Skill finds relevant outreach prospects for a page or asset. @@ -46,7 +46,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can inspect SERPs, backlink overvi The source `SKILL.md` lives on GitHub: -- [Link Prospecting skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/link-prospecting) +- [Link Prospecting skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-link-prospecting) ## Related skills diff --git a/web/content/docs/skills/local-seo.mdx b/web/content/docs/skills/local-seo.mdx index 7698c4c..bd31f44 100644 --- a/web/content/docs/skills/local-seo.mdx +++ b/web/content/docs/skills/local-seo.mdx @@ -3,7 +3,7 @@ title: "Local SEO Agent Skill" description: "Audit a Google Business Profile, compare it to local competitors, and map Google Maps visibility around a location with your AI agent." --- - + The Local SEO Agent Skill works out why a business does or does not show up in Google Maps and the local pack near its customers, and what to fix first. diff --git a/web/content/docs/skills/seo-audit.mdx b/web/content/docs/skills/seo-audit.mdx index f4770dd..6ee3d42 100644 --- a/web/content/docs/skills/seo-audit.mdx +++ b/web/content/docs/skills/seo-audit.mdx @@ -3,7 +3,7 @@ title: "SEO Audit Agent Skill" description: "Audit a website with your AI agent and get a one-page, plain-language SEO report built around a single next action." --- - + The SEO Audit Agent Skill audits a site and writes a one-page HTML report that anyone can act on, including someone who has never done SEO. @@ -46,7 +46,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can run the audit and read backlin The source `SKILL.md` lives on GitHub: -- [SEO Audit skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-audit) +- [SEO Audit skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-audit) ## Related skills diff --git a/web/content/docs/skills/seo-coach.mdx b/web/content/docs/skills/seo-coach.mdx index 06c4ced..bac9785 100644 --- a/web/content/docs/skills/seo-coach.mdx +++ b/web/content/docs/skills/seo-coach.mdx @@ -3,7 +3,7 @@ title: "SEO Coach Agent Skill" description: "Learn SEO basics, choose the right workflow, and decide what to do next with your AI agent." --- - + The SEO Coach Agent Skill helps you decide what to do next. @@ -49,7 +49,7 @@ The coach can help before MCP is connected, but your agent needs [OpenSEO MCP](/ The source `SKILL.md` lives on GitHub: -- [SEO Coach skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-coach) +- [SEO Coach skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-coach) ## Related skills diff --git a/web/content/docs/skills/seo-project-setup.mdx b/web/content/docs/skills/seo-project-setup.mdx index c15bdb5..ccd9a05 100644 --- a/web/content/docs/skills/seo-project-setup.mdx +++ b/web/content/docs/skills/seo-project-setup.mdx @@ -3,7 +3,7 @@ title: "SEO Project Setup Agent Skill" description: "Create a local SEO workspace where your AI agent can save project context, notes, goals, exports, and preferences over time." --- - + The SEO Project Setup Agent Skill gives your agent the context it needs before doing SEO work for a site. @@ -46,7 +46,7 @@ Set up [OpenSEO MCP](/docs/mcp) so your agent can confirm the right OpenSEO proj The source `SKILL.md` lives on GitHub: -- [SEO Project Setup skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-project-setup) +- [SEO Project Setup skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/openseo-project-setup) ## Related skills diff --git a/web/content/docs/skills/setup.md b/web/content/docs/skills/setup.md index 451648f..281a906 100644 --- a/web/content/docs/skills/setup.md +++ b/web/content/docs/skills/setup.md @@ -71,13 +71,15 @@ Each skill page also links to its source `SKILL.md`. 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` +- `/openseo-project-setup` +- `/openseo-coach` +- `/openseo-audit` +- `/openseo-keyword-research` +- `/openseo-keyword-clustering` +- `/openseo-competitive-landscape` +- `/openseo-competitor-analysis` +- `/openseo-local-seo` +- `/openseo-link-prospecting` ## Next step