第 2 章 · 01 Skills 总览与安装

文档摘要

第 2 章 · 01 Skills 总览与安装本节摘要:本节是 Agent Skills 实战的总入口。Agent Skill 是可被 AI agent 调用的 SEO 能力包——一个文件,告诉你的 agent 「该跑哪一套 SEO 工作流、按什么步骤跑」。OpenSEO 提供 7 个官方 Skill,覆盖项目搭建、SEO 教练、关键词研究、关键词聚类、竞争格局、竞品分析、外链挖掘。我们先把 MCP 与 Skills 的关系讲清楚,再给出 5 种安装方式(交互式、全量、按 agent、手动复制等),让你在自己的 Claude Code 或 Codex 里把它们装起来。读完本节,你能区分「MCP 是数据、Skills 是工作流」,并完成 Skills 的安装。

第 2 章 · 01 Skills 总览与安装

本节摘要:本节是 Agent Skills 实战的总入口。Agent Skill 是可被 AI agent 调用的 SEO 能力包——一个 SKILL.md 文件,告诉你的 agent 「该跑哪一套 SEO 工作流、按什么步骤跑」。OpenSEO 提供 7 个官方 Skill,覆盖项目搭建、SEO 教练、关键词研究、关键词聚类、竞争格局、竞品分析、外链挖掘。我们先把 MCP 与 Skills 的关系讲清楚,再给出 5 种安装方式(交互式、全量、按 agent、手动复制等),让你在自己的 Claude Code 或 Codex 里把它们装起来。读完本节,你能区分「MCP 是数据、Skills 是工作流」,并完成 Skills 的安装。

内容来源:原项目英文文档 web/content/docs/skills/index.md 与 web/content/docs/skills/setup.md,汉化并套用体系化模板。

学习目标

阅读完本节,你应当能够:

说清 Agent Skill 与 MCP 的区别(数据访问 vs 工作流指令)。
列举 OpenSEO 的 7 个官方 Skill 及各自定位。
选出适合自己场景的 安装方式(交互式 / 全量 / 按 agent / 手动)。
在 Claude Code 或 Codex 里成功装好 Skills。
知道安装后用 斜杠命令 触发某个 Skill。

一、Skill 是什么:把 SEO 工作流交给 agent

OpenSEO Agent Skill 让你把可重复的 SEO 工作流交给 AI agent。当你需要做关键词研究、聚类、竞品分析、外链挖掘或项目搭建时,运行对应的斜杠命令(skill),skill 就会把工作流指令交给你的 agent。

核心理解:策略仍由你掌控,agent 只是依据 OpenSEO 数据与 skill 指令,返回建议、方案或候选清单。

💡 关键概念:MCP 与 Skills 是两层不同的东西,不要混淆。

MCP 把你的 agent 连到 OpenSEO 数据(能不能拿到关键词、SERP、反链数据)。

Skills 告诉你的 agent 用这些数据跑哪一套 SEO 工作流(怎么把数据组织成关键词研究、聚类、竞品分析)。

两者的安装关系如下:

二、7 个官方 Skill 全景

OpenSEO 当前提供 7 个 Skill,分两类:入门 / 搭建类 与 研究 / 推广类。

入门与搭建类

Skill	斜杠命令	解决什么问题
SEO Project Setup(项目搭建)	`/seo-project-setup`	建立持久的项目工作区,让 agent 跨会话复用目标、上下文、导出与偏好
SEO Coach(SEO 教练)	`/seo-coach`	新手或不知道先做什么时,选下一步工作流

研究类(Research)

Skill	斜杠命令	解决什么问题
Keyword Research(关键词研究)	`/keyword-research`	找出值得做的关键词,并解释为什么值得
Keyword Clustering(关键词聚类)	`/keyword-clustering`	把关键词列表变成页面分组、内容优先级与蚕食检查
Competitive Landscape(竞争格局)	`/competitive-landscape`	画出整个市场谁在赢、你的机会在哪
Competitor Analysis(竞品分析)	`/competitor-analysis`	深挖单个竞品,把研究转化为策略洞察

推广类(Promotion)

Skill	斜杠命令	解决什么问题
Link Prospecting(外链候选挖掘)	`/link-prospecting`	找到合格的外链拓展对象,并给出每个对象的相关切入角度

⚠️ 注意:这些页面(本教程的各子节)解释每个 skill 是干什么的;skill 的真正源指令(SKILL.md)在 GitHub 仓库的 .agents/skills/ 目录下。OpenSEO 用的是现代 AI agent 通用支持的 SKILL.md 模式。

三、安装前置:先装好 MCP

Skills 是独立于 MCP 的文件,但前提是 先接入 OpenSEO MCP——MCP 给 agent 访问 OpenSEO 数据的能力。MCP 的接入见第 1 章「接入 OpenSEO MCP」一节,这里不再重复。

装好 MCP 后,再把你想用的 OpenSEO SKILL.md 文件加给 agent。每个 skill 等于给 agent 一套 SEO 工作流。

四、5 种安装方式

下面 5 种方式,选一种最贴合你工作习惯的。

方式 1:交互式安装并选择

希望安装器把可用 skills 与 agents 列出来让你挑,用这个:


npx skills add every-app/open-seo

方式 2:安装全部 OpenSEO Skills

希望把每个 OpenSEO skill 都装上,用这个:


npx skills add every-app/open-seo --skill '*'

方式 3:只为 Claude Code 装全部 Skills

希望 skills 只在 Claude Code 里可用,用这个:


npx skills add every-app/open-seo --skill '*' --agent claude-code

方式 4:只为 OpenAI Codex 装全部 Skills

希望 skills 只在 Codex 里可用,用这个:


npx skills add every-app/open-seo --skill '*' --agent codex

方式 5:手动复制 skill 文件

偏好自己把文件拷进 agent 的 skills 目录,用这个:


git clone https://github.com/every-app/open-seo.git

# Codex
mkdir -p ~/.codex/skills
cp -R open-seo/.agents/skills/* ~/.codex/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -R open-seo/.agents/skills/* ~/.claude/skills/

💡 技巧:不确定选哪种,推荐 方式 1(交互式)——它会把可用 skill 一一列出来,你按需勾选即可,避免装太多用不上的 skill 干扰 agent 的判断。每个 skill 页面(本教程对应子节)也都指向其源 SKILL.md,可先行阅读再决定。

五、安装后:用斜杠命令触发

skill 文件交给 agent 后,运行对应的斜杠命令即可触发:

/seo-project-setup
/seo-coach
/keyword-research
/keyword-clustering
/competitive-landscape
/competitor-analysis
/link-prospecting

⚠️ 注意:斜杠命令只是「入口」,真正驱动 agent 的是 SKILL.md 里的指令。如果你换了 agent(Claude Code ↔ Codex),需要重新对该 agent 装一遍 skill 文件,命令才会生效。

本节要点回顾

两层模型:MCP 给数据访问,Skills 给工作流指令——二者缺一不可。
7 个 Skill:项目搭建、SEO 教练、关键词研究、关键词聚类、竞争格局、竞品分析、外链挖掘。
策略你掌控:agent 只产出建议、方案、候选清单,决策权在你。
安装前置:先按第 1 章接入 OpenSEO MCP,再装 Skills。
5 种安装方式:npx skills add 系列(交互/全量/按 agent)与手动 cp 复制。
触发方式:安装后用斜杠命令(如 /keyword-research)调用对应 Skill。
跨 agent 重装:换了 agent 要重装 skill 文件,命令才生效。

装好之后,从哪里开始?如果你是新 SEO 项目,下一节我们先做「SEO 项目工作区」搭建;如果你不确定该先跑哪个工作流,可以直接跳到「SEO 教练」。