# API 产品介绍页策划 Skill 安装指南

> 面向 AI Agent 的机器可读安装说明。HTML 页面不能直接当作 Skill 文件安装。

- 技能包：https://www.vibemarketing.work/packages/skill-api-page/1.0.0/skill-api-page.zip
- 原始 SKILL.md：https://www.vibemarketing.work/raw/skill-api-page/SKILL.md
- 校验：https://www.vibemarketing.work/packages/skill-api-page/1.0.0/SHA256SUMS
- 版本：1.0.0｜许可证：MIT｜上游：https://github.com/kostja94/marketing-skills/blob/70987bad4ebe9dce1f74858c1c64f3f8810f18e4/skills/pages/content/api/SKILL.md

## 通用步骤

1. 下载完整 ZIP 并解压，保留 SKILL.md 及全部配套文件。
2. 按下面对应 Agent 的方式放入其技能目录。
3. 安装完成后报告实际安装目录。
4. 用一个只读小任务验证 Skill 已被识别。
5. 若缺少联网、下载或写目录权限，直接告知用户需要手工完成的步骤。

## 各 Agent 安装方式

### WorkBuddy

```text
技能 → 添加技能 → 上传技能 → 选择本地技能包
```

验证：在“已安装”中搜索 Skill 名称，启用后用一个只读样本任务检查是否被正确调用。

### OpenClaw

```text
openclaw skills install ./skill-api-page --as api_page_skill
```

验证：运行 openclaw skills list 确认技能已注册，再用一条只读样本命令检查调用。

### Hermes Agent

```text
mkdir -p ~/.hermes/skills && cp -R ./skill-api-page ~/.hermes/skills/
```

验证：在消息入口里发一条只读任务，确认 Hermes 报出 Skill 名称与将要执行的步骤。

### Codex

```text
mkdir -p ~/.agents/skills && cp -R ./skill-api-page ~/.agents/skills/
```

验证：让 Codex 列出可用 Skill 并复述本次要执行的步骤，再跑一个只读小任务。

### Claude Code

```text
mkdir -p ~/.claude/skills && cp -R ./skill-api-page ~/.claude/skills/
```

验证：在项目里提一个只读任务并点名 Skill，确认它按 SKILL.md 的步骤复述计划。

### TRAE

```text
在 Skills 设置中导入包含 SKILL.md 的 skill-api-page 目录；项目级 Skill 可放入 .agents/skills/skill-api-page
```

验证：在 Skills 设置里确认已启用，再让它对一个页面或一份材料做只读检查。

### ZCode

```text
mkdir -p ~/.zcode/skills && cp -R ./skill-api-page ~/.zcode/skills/
```

验证：在设置页确认技能已启用，对话中输入 $ 选择技能，再跑一个只读小任务。

## 这个 Skill 做什么

面向开发者和技术决策者，完成 API 产品介绍页的信息架构、API 价值主张、API 使用场景、开发文档与注册 CTA，以及面向开发者搜索需求的 SEO 元数据。

需要准备：API 类型、产品能力、目标行业、典型集成场景，以及开发者和技术决策者各自关心的问题；现有 API 页面 URL、截图或页面稿，开发文档、API Reference、快速开始与注册入口；认证方式、如适用的公开价格与使用限制、如有的 SDK 与工具清单，以及已经确认的示例和产品术语；品牌语气、目标产品词或行业 API 关键词、首页与功能页链接、SEO 和结构化数据要求

最终交付：API 产品介绍页结构：价值主张、核心能力、使用场景、快速开始、认证概览，以及如适用的价格或限制、如有的 SDK 或工具；关键文案：H1、副标题、核心能力说明、典型用例，以及通往开发文档或注册入口的 CTA；内部链接建议：首页、功能页和资源页通往 API 页面，API 页面通往快速开始、API Reference 或注册入口；API SEO 元数据：Title、Description、产品词或行业词加 API，以及 WebPage 或 SoftwareApplication Schema 候选字段