From a0047597008e30e84ed5853fe97ce1401e614a54 Mon Sep 17 00:00:00 2001 From: Ben Senescu <44480372+bensenescu@users.noreply.github.com> Date: Tue, 18 Aug 2026 23:00:37 -0400 Subject: [PATCH] Revert "Prefix public agent skills with "openseo-" (#502)" (#503) This reverts commit b9df03d20f0f20230072aaa49df1abf56422addb. --- .../SKILL.md | 4 ++-- .../SKILL.md | 4 ++-- .agents/skills/create-repo-skill/SKILL.md | 6 +++--- .../SKILL.md | 2 +- .../SKILL.md | 2 +- .../SKILL.md | 2 +- .../{openseo-local-seo => local-seo}/SKILL.md | 4 ++-- .../agents/openai.yaml | 4 ---- .../{openseo-audit => seo-audit}/SKILL.md | 8 ++++---- .../{openseo-audit => seo-audit}/template.html | 0 .../{openseo-coach => seo-coach}/SKILL.md | 18 +++++++++--------- .../SKILL.md | 16 ++++++++-------- .../SKILL.md | 4 ++-- .../agents/openai.yaml | 4 ++++ README.md | 4 ++-- docs/CONTRIBUTING.md | 10 +++++----- specs/0005-onboarding-agent.md | 6 +++--- src/routes/_app/ai.tsx | 16 ++++++++-------- .../docs/skills/competitive-landscape.mdx | 4 ++-- .../docs/skills/competitor-analysis.mdx | 4 ++-- web/content/docs/skills/keyword-clustering.mdx | 4 ++-- web/content/docs/skills/keyword-research.mdx | 4 ++-- web/content/docs/skills/link-prospecting.mdx | 4 ++-- web/content/docs/skills/local-seo.mdx | 2 +- web/content/docs/skills/seo-audit.mdx | 4 ++-- web/content/docs/skills/seo-coach.mdx | 4 ++-- web/content/docs/skills/seo-project-setup.mdx | 4 ++-- web/content/docs/skills/setup.md | 16 +++++++--------- 28 files changed, 81 insertions(+), 83 deletions(-) rename .agents/skills/{openseo-competitive-landscape => competitive-landscape}/SKILL.md (97%) rename .agents/skills/{openseo-competitor-analysis => competitor-analysis}/SKILL.md (98%) rename .agents/skills/{openseo-keyword-clustering => keyword-clustering}/SKILL.md (99%) rename .agents/skills/{openseo-keyword-research => keyword-research}/SKILL.md (99%) rename .agents/skills/{openseo-link-prospecting => link-prospecting}/SKILL.md (99%) rename .agents/skills/{openseo-local-seo => local-seo}/SKILL.md (97%) delete mode 100644 .agents/skills/openseo-simple-issue-description/agents/openai.yaml rename .agents/skills/{openseo-audit => seo-audit}/SKILL.md (93%) rename .agents/skills/{openseo-audit => seo-audit}/template.html (100%) rename .agents/skills/{openseo-coach => seo-coach}/SKILL.md (79%) rename .agents/skills/{openseo-project-setup => seo-project-setup}/SKILL.md (89%) rename .agents/skills/{openseo-simple-issue-description => simple-issue-description}/SKILL.md (98%) create mode 100644 .agents/skills/simple-issue-description/agents/openai.yaml diff --git a/.agents/skills/openseo-competitive-landscape/SKILL.md b/.agents/skills/competitive-landscape/SKILL.md similarity index 97% rename from .agents/skills/openseo-competitive-landscape/SKILL.md rename to .agents/skills/competitive-landscape/SKILL.md index b61c7db..0883708 100644 --- a/.agents/skills/openseo-competitive-landscape/SKILL.md +++ b/.agents/skills/competitive-landscape/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-competitive-landscape +name: 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 `openseo-competitor-analysis`. +Use this when the user wants a market-level view across several competitors. For a deep dive on one domain, use `competitor-analysis`. ## Required inputs diff --git a/.agents/skills/openseo-competitor-analysis/SKILL.md b/.agents/skills/competitor-analysis/SKILL.md similarity index 98% rename from .agents/skills/openseo-competitor-analysis/SKILL.md rename to .agents/skills/competitor-analysis/SKILL.md index 66d500e..1ca9333 100644 --- a/.agents/skills/openseo-competitor-analysis/SKILL.md +++ b/.agents/skills/competitor-analysis/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-competitor-analysis +name: 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 `openseo-competitive-landscape`. +Use this for a named competitor. For identifying the market leaders first, use `competitive-landscape`. ## Required inputs diff --git a/.agents/skills/create-repo-skill/SKILL.md b/.agents/skills/create-repo-skill/SKILL.md index dec3da9..45227b9 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, 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) + - **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) - `web/content/docs/skills/index.md` — bullet in the right workflow section - `web/content/docs/skills/meta.json` — nav entry - - `.agents/skills/openseo-coach/SKILL.md` — one line in the "What each workflow does" roster + - `.agents/skills/seo-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/openseo-keyword-clustering/SKILL.md b/.agents/skills/keyword-clustering/SKILL.md similarity index 99% rename from .agents/skills/openseo-keyword-clustering/SKILL.md rename to .agents/skills/keyword-clustering/SKILL.md index 1371fba..0fbadf7 100644 --- a/.agents/skills/openseo-keyword-clustering/SKILL.md +++ b/.agents/skills/keyword-clustering/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-keyword-clustering +name: keyword-clustering description: Cluster keywords by intent and map them to existing or proposed pages. --- diff --git a/.agents/skills/openseo-keyword-research/SKILL.md b/.agents/skills/keyword-research/SKILL.md similarity index 99% rename from .agents/skills/openseo-keyword-research/SKILL.md rename to .agents/skills/keyword-research/SKILL.md index 65893c9..4bdfc40 100644 --- a/.agents/skills/openseo-keyword-research/SKILL.md +++ b/.agents/skills/keyword-research/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-keyword-research +name: keyword-research description: "Discover keyword opportunities, evaluate metrics and SERPs, and save/tag promising terms." --- diff --git a/.agents/skills/openseo-link-prospecting/SKILL.md b/.agents/skills/link-prospecting/SKILL.md similarity index 99% rename from .agents/skills/openseo-link-prospecting/SKILL.md rename to .agents/skills/link-prospecting/SKILL.md index f2c3fa7..e9b9fb7 100644 --- a/.agents/skills/openseo-link-prospecting/SKILL.md +++ b/.agents/skills/link-prospecting/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-link-prospecting +name: link-prospecting description: Find link prospects, discover contact paths, and draft outreach from SERPs and backlink signals. --- diff --git a/.agents/skills/openseo-local-seo/SKILL.md b/.agents/skills/local-seo/SKILL.md similarity index 97% rename from .agents/skills/openseo-local-seo/SKILL.md rename to .agents/skills/local-seo/SKILL.md index 24fcae2..a7e7f3a 100644 --- a/.agents/skills/openseo-local-seo/SKILL.md +++ b/.agents/skills/local-seo/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-local-seo +name: 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 `openseo-competitor-analysis` or `openseo-keyword-research`. +Use this when rankings depend on a physical location or service area. For national organic work, use `competitor-analysis` or `keyword-research`. ## Required inputs diff --git a/.agents/skills/openseo-simple-issue-description/agents/openai.yaml b/.agents/skills/openseo-simple-issue-description/agents/openai.yaml deleted file mode 100644 index b6acf85..0000000 --- a/.agents/skills/openseo-simple-issue-description/agents/openai.yaml +++ /dev/null @@ -1,4 +0,0 @@ -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/openseo-audit/SKILL.md b/.agents/skills/seo-audit/SKILL.md similarity index 93% rename from .agents/skills/openseo-audit/SKILL.md rename to .agents/skills/seo-audit/SKILL.md index b68f7eb..0da5a1a 100644 --- a/.agents/skills/openseo-audit/SKILL.md +++ b/.agents/skills/seo-audit/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-audit +name: seo-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 `openseo-competitor-analysis` or `openseo-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 `competitor-analysis` or `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 `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. +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. 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/openseo-audit/template.html b/.agents/skills/seo-audit/template.html similarity index 100% rename from .agents/skills/openseo-audit/template.html rename to .agents/skills/seo-audit/template.html diff --git a/.agents/skills/openseo-coach/SKILL.md b/.agents/skills/seo-coach/SKILL.md similarity index 79% rename from .agents/skills/openseo-coach/SKILL.md rename to .agents/skills/seo-coach/SKILL.md index f9f2dae..82bbebb 100644 --- a/.agents/skills/openseo-coach/SKILL.md +++ b/.agents/skills/seo-coach/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-coach +name: seo-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 -- `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. +- `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. ## Tool coaching diff --git a/.agents/skills/openseo-project-setup/SKILL.md b/.agents/skills/seo-project-setup/SKILL.md similarity index 89% rename from .agents/skills/openseo-project-setup/SKILL.md rename to .agents/skills/seo-project-setup/SKILL.md index 73e958b..688397e 100644 --- a/.agents/skills/openseo-project-setup/SKILL.md +++ b/.agents/skills/seo-project-setup/SKILL.md @@ -1,5 +1,5 @@ --- -name: openseo-project-setup +name: seo-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 `openseo-keyword-research` and `openseo-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 `keyword-research` and `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: -- `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 +- `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 ## Output format diff --git a/.agents/skills/openseo-simple-issue-description/SKILL.md b/.agents/skills/simple-issue-description/SKILL.md similarity index 98% rename from .agents/skills/openseo-simple-issue-description/SKILL.md rename to .agents/skills/simple-issue-description/SKILL.md index 6b52373..1c096d2 100644 --- a/.agents/skills/openseo-simple-issue-description/SKILL.md +++ b/.agents/skills/simple-issue-description/SKILL.md @@ -1,6 +1,6 @@ --- -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. +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. --- # Simple Issue Description diff --git a/.agents/skills/simple-issue-description/agents/openai.yaml b/.agents/skills/simple-issue-description/agents/openai.yaml new file mode 100644 index 0000000..da55673 --- /dev/null +++ b/.agents/skills/simple-issue-description/agents/openai.yaml @@ -0,0 +1,4 @@ +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 13ecc4f..9a874a2 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: `/openseo-simple-issue-description` which helps. +We have this skill: `/simple-issue-description` which helps. ```sh -npx skills add every-app/open-seo --skill openseo-simple-issue-description +npx skills add every-app/open-seo --skill simple-issue-description ``` ## Community diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 6e1d3fe..1004c98 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. -### /openseo-simple-issue-description +### /simple-issue-description -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. +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. Install it with: ```sh -npx skills add every-app/open-seo --skill openseo-simple-issue-description +npx skills add every-app/open-seo --skill 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 `/openseo-simple-issue-description`: +Here is what we're aiming for with `/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 `/openseo-simple-issue-description` + - I have an `/explain-simply` skill I use all the time which inspired `/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 ac0989d..bb21fef 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 -`openseo-coach`. Every gated action is a named thing tied to a strategy item the +`seo-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 openseo-coach skill +## Unify the seo-coach skill -Update the `openseo-coach` skill (and `onboarding-checklist`) so the coach and the +Update the `seo-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 5a57c90..af3d5f6 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 = [ - "openseo-project-setup", - "openseo-coach", - "openseo-keyword-research", - "openseo-keyword-clustering", - "openseo-competitive-landscape", - "openseo-competitor-analysis", - "openseo-link-prospecting", + "seo-project-setup", + "seo-coach", + "keyword-research", + "keyword-clustering", + "competitive-landscape", + "competitor-analysis", + "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{" "} - /openseo-project-setup + /seo-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 2da03bd..83af522 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/openseo-competitive-landscape) +- [Competitive Landscape skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/competitive-landscape) ## Related skills diff --git a/web/content/docs/skills/competitor-analysis.mdx b/web/content/docs/skills/competitor-analysis.mdx index ff59c52..2d29892 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/openseo-competitor-analysis) +- [Competitor Analysis skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/competitor-analysis) ## Related skills diff --git a/web/content/docs/skills/keyword-clustering.mdx b/web/content/docs/skills/keyword-clustering.mdx index e961c47..296ebcb 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/openseo-keyword-clustering) +- [Keyword Clustering skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/keyword-clustering) ## Related skills diff --git a/web/content/docs/skills/keyword-research.mdx b/web/content/docs/skills/keyword-research.mdx index a28213d..8ebd1a7 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/openseo-keyword-research) +- [Keyword Research skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/keyword-research) ## Related skills diff --git a/web/content/docs/skills/link-prospecting.mdx b/web/content/docs/skills/link-prospecting.mdx index 6b4bbc6..40483cc 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/openseo-link-prospecting) +- [Link Prospecting skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/link-prospecting) ## Related skills diff --git a/web/content/docs/skills/local-seo.mdx b/web/content/docs/skills/local-seo.mdx index bd31f44..7698c4c 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 6ee3d42..f4770dd 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/openseo-audit) +- [SEO Audit skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-audit) ## Related skills diff --git a/web/content/docs/skills/seo-coach.mdx b/web/content/docs/skills/seo-coach.mdx index bac9785..06c4ced 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/openseo-coach) +- [SEO Coach skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-coach) ## Related skills diff --git a/web/content/docs/skills/seo-project-setup.mdx b/web/content/docs/skills/seo-project-setup.mdx index ccd9a05..c15bdb5 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/openseo-project-setup) +- [SEO Project Setup skill](https://github.com/every-app/open-seo/tree/main/.agents/skills/seo-project-setup) ## Related skills diff --git a/web/content/docs/skills/setup.md b/web/content/docs/skills/setup.md index 281a906..451648f 100644 --- a/web/content/docs/skills/setup.md +++ b/web/content/docs/skills/setup.md @@ -71,15 +71,13 @@ Each skill page also links to its source `SKILL.md`. After the skill files are available to your agent, run the matching slash command: -- `/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` +- `/seo-project-setup` +- `/seo-coach` +- `/keyword-research` +- `/keyword-clustering` +- `/competitive-landscape` +- `/competitor-analysis` +- `/link-prospecting` ## Next step