SiteGPT Docs

SiteGPT Agent Skills

面向 AI Agent 的官方 SiteGPT 技能。

这些技能会教 Agent 如何通过 SiteGPT CLI 使用 SiteGPT，让它们能在 Agent 环境中管理聊天机器人、知识、对话、设置、团队访问权限和账户资源。

SiteGPT 还为支持 Auth.md 风格发现机制的 Agent 环境发布了 https://sitegpt.ai/auth.md，用于发现无需注册即可先试用的引导流程。

安装

作为 Claude Code 插件（也适用于 Cowork）：

/plugin marketplace add sitegpt/agent-skills
/plugin install sitegpt@sitegpt

使用 skills CLI（适用于任何支持 Agent Skills 的 Agent 环境）：

npx skills add sitegpt/agent-skills

两种方式安装的都是同一项技能。此仓库采用双重打包：Agent Skills 仓库（skills.sh）和 Claude Code 插件市场（.claude-plugin/）。

可用技能

sitegpt

入门技能：介绍 SiteGPT、应使用哪个入口（CLI、MCP 连接器、REST API 或无需注册的引导流程），以及在哪里查找深入工作流。将终端操作引导至 sitegpt-cli。

sitegpt-cli

使用 SiteGPT CLI，通过 Codex、Claude Code、Cursor、OpenCode、Gemini CLI、Windsurf、Cline 及其他兼容技能的编码 Agent 等 AI Agent 管理 SiteGPT 账户和聊天机器人。

适用于以下场景：

• 从网站创建 SiteGPT 聊天机器人。
• 当用户尚无 SiteGPT 账户时，通过 Agent 优先的引导流程创建先试用再注册的聊天机器人。
• 从链接、网站、站点地图、文件、YouTube 视频、文本和已连接的数据源添加知识。
• 管理角色设定、指令、设置、对话开场白、后续跟进内容和自定义回复。
• 读取和管理对话、消息、潜在客户、标签、成员、邀请、用量、账单和 API 令牌。
• 排查 SiteGPT CLI 命令用法问题。

此技能是一个独立完整的 SKILL.md 文件，包含面向 Agent 的工作流、发现简介、引导和账户操作手册、命令映射及安全规则。SiteGPT CLI 本身是准确命令语法的权威来源；Agent 会运行 sitegpt <command> --help 查看标志，因此此技能有意不重复列出每条命令的参考信息。

在 Cursor 中安装

此仓库也作为 Cursor 插件提供（技能 + 远程 MCP 服务）。在 Cursor 中运行 /add-plugin 并选择 SiteGPT，或从市场列表安装。MCP 服务通过浏览器 OAuth 连接你的 SiteGPT 账户；无需账户即可通过 Agent 优先的引导流程使用这些技能。

安装

使用开源 skills CLI 安装 SiteGPT CLI 技能：

npx skills add sitegpt/agent-skills --skill sitegpt-cli

安装到指定 Agent：

npx skills add sitegpt/agent-skills --skill sitegpt-cli -a codex
npx skills add sitegpt/agent-skills --skill sitegpt-cli -a claude-code
npx skills add sitegpt/agent-skills --skill sitegpt-cli -a cursor

全局安装：

npx skills add sitegpt/agent-skills --skill sitegpt-cli --global

列出可用技能但不安装：

npx skills add sitegpt/agent-skills --list

稍后更新已安装的技能：

npx skills update sitegpt-cli

SiteGPT CLI 前置条件

skills CLI 用于安装此 Agent 技能。安装技能后，Agent 实际运行的命令行工具是 SiteGPT CLI。

请先安装 SiteGPT CLI：

npm install -g @sitegpt/cli

然后选择适合的流程：

• 尚无 SiteGPT 账户：不要先登录。让 Agent 运行 sitegpt onboarding start <website-url>，配置并测试临时聊天机器人， 然后分享引导 URL 以供预览和认领。
• 已有 SiteGPT 账户：先完成身份验证，然后使用常规账户命令。

已有账户可通过设备登录进行身份验证：

sitegpt login

你也可以从 SiteGPT 控制面板创建 API 令牌并手动保存：

sitegpt login --token <sitegpt-api-token>

示例提示词

安装技能后，可以这样向 Agent 提问：

Try SiteGPT for https://example.com. Inspect the website, create a temporary chatbot, add knowledge, configure persona and instructions, test it, and give me the onboarding URL so I can preview and claim it.

I already have a SiteGPT account. Create a chatbot for https://example.com inside my account, configure knowledge and branding, and give me the dashboard link.

Audit my SiteGPT chatbot knowledge sources and resync any failed or stale documents.

Show recent conversations for my SiteGPT chatbot, summarize unresolved issues, and tag the conversations that need human follow-up.

技能结构

skills/
  sitegpt-cli/
    SKILL.md

版本管理与发布

Skill 版本位于每个 SKILL.md 中的 metadata.version 以及根目录的 package.json 中。

发布需手动进行。发布新版本时：

1. 更新 package.json。
2. 更新每个已更改的 SKILL.md 中的 metadata.version。
3. 更新 CHANGELOG.md。
4. 使用 chore: release <version> 提交。
5. 创建并推送对应的 Git 标签，例如 v0.1.2。
6. 为该标签创建 GitHub Release。

通过 npx skills add sitegpt/agent-skills 安装的用户之后可以使用 npx skills update 更新。

相关链接

• SiteGPT
• SiteGPT CLI on npm
• SiteGPT CLI 文档
• skills.sh
• Agent Skills 规范

许可证

MIT