# Soda SkillHub 安装指导手册

本包里的每个 skill 都是一个标准目录，目录内至少包含 `SKILL.md`。

推荐统一放到：

```bash
$HOME/soda-skillhub/skills
```

安装完成后的结构应为：

```text
$HOME/soda-skillhub/skills/<skill-slug>/SKILL.md
```

## 适用框架

Claude Code、Cursor、Hermes 或其它兼容 Agent Skills 目录结构的 agent 框架，都可以使用本包。

通用规则只有一个：把完整的 `<skill-slug>` 目录放到该框架会扫描的 skills 目录里。

如果你的框架扫描 `~/.claude/skills`、`~/.cursor/skills`、项目内 `./skills` 或其它目录，把下面命令里的 `AGENT_SKILLS_DIR` 换成实际目录即可。

## 方式一：从当前项目目录安装

适合已经拿到本交付包源码目录的情况。

```bash
AGENT_SKILLS_DIR="$HOME/soda-skillhub/skills"
SKILL_SLUG="<skill-slug>"
mkdir -p "$AGENT_SKILLS_DIR"
cp -R "writing/$SKILL_SLUG" "$AGENT_SKILLS_DIR/$SKILL_SLUG"
```

上面示例里的 `writing` 需要替换成实际分类目录，例如：

```text
writing
programming
learning
research
life
productivity
rag
```

验证：

```bash
ls "$AGENT_SKILLS_DIR/$SKILL_SLUG/SKILL.md"
```

## 方式二：从 zip 安装

每个 skill 目录下都有同名 zip 包，例如：

```text
programming/agentic-security-audit/agentic-security-audit.zip
```

zip 解压后会直接得到 `<skill-slug>/...` 目录，不会额外带 `programming/`、`writing/` 这类上级分类目录。

```bash
AGENT_SKILLS_DIR="$HOME/soda-skillhub/skills"
SKILL_SLUG="<skill-slug>"
mkdir -p "$AGENT_SKILLS_DIR"
unzip "<category>/$SKILL_SLUG/$SKILL_SLUG.zip" -d "$AGENT_SKILLS_DIR"
```

验证：

```bash
ls "$AGENT_SKILLS_DIR/$SKILL_SLUG/SKILL.md"
```

## 方式三：链接到框架目录

如果你想先统一存放到 `$HOME/soda-skillhub/skills`，再让不同 agent 框架读取，可以软链接：

```bash
SODA_SKILLS_DIR="$HOME/soda-skillhub/skills"
AGENT_SKILLS_DIR="./skills"
SKILL_SLUG="<skill-slug>"
mkdir -p "$AGENT_SKILLS_DIR"
ln -sfn "$SODA_SKILLS_DIR/$SKILL_SLUG" "$AGENT_SKILLS_DIR/$SKILL_SLUG"
```

不支持软链接时，复制：

```bash
SODA_SKILLS_DIR="$HOME/soda-skillhub/skills"
AGENT_SKILLS_DIR="./skills"
SKILL_SLUG="<skill-slug>"
mkdir -p "$AGENT_SKILLS_DIR"
cp -R "$SODA_SKILLS_DIR/$SKILL_SLUG" "$AGENT_SKILLS_DIR/$SKILL_SLUG"
```

## OpenClaw 官方 skill 安装说明

`writing`、`programming`、`learning`、`research`、`life`、`productivity` 下的 72 个 skill 是安装型 skill：它们本身可以被 Claude Code、Cursor、Hermes 加载；加载后会指导 agent 安装对应的 OpenClaw 官方 skill。

如果你要直接安装 OpenClaw 官方 skill，可执行：

```bash
INSTALL_ROOT="$HOME/soda-skillhub/skills"
mkdir -p "$INSTALL_ROOT"
clawhub install <skill-slug> --dir "$INSTALL_ROOT"
```

没有 `clawhub` 时：

```bash
INSTALL_ROOT="$HOME/soda-skillhub/skills"
mkdir -p "$INSTALL_ROOT"
npx clawhub@latest install <skill-slug> --dir "$INSTALL_ROOT"
```

`rag` 分类是清小搭官方完整 skill，不需要通过 ClawHub 下载，直接复制目录或解压 zip 即可。

## Skill Slug 清单

### 写作 (`writing`)

- `academic-writer`：LaTeX 论文写作助手
- `academic-writing`：学术论文结构写作专家
- `academic-writing-refiner`：顶会论文润色器
- `blog-writer`：技术博客写作助手
- `critical-article-writer`：观点评论文章生成器
- `brand-voice-profile`：品牌语气定制器
- `content-recycler`：长文多平台改写器
- `blogburst`：文章一键拆帖工具
- `skywork-document`：联网正式文档生成器
- `bluente-translate`：保格式文档翻译器
- `comms-md`：沟通偏好说明书生成器
- `chain-of-density`：高密度摘要压缩器

### 编程 (`programming`)

- `audit-code`：代码安全审查器
- `agents-skill-tdd-helper`：Agent TDD 测试助手
- `doc-accurate-codegen`：查文档再写代码助手
- `cicd-pipeline`：GitHub CI/CD 管线助手
- `agent-skills-audit`：多角色代码审计团
- `agentic-security-audit`：Agent 系统安全审计器
- `apple-docs`：Apple 开发文档查询器
- `ios-simulator`：iOS 模拟器自动化助手
- `instruments-profiling`：iOS 性能分析助手
- `swift-concurrency-expert`：Swift 并发问题专家
- `swiftui-performance-audit`：SwiftUI 性能体检器
- `swiftui-view-refactor`：SwiftUI 视图重构助手

### 学习 (`learning`)

- `anki-connect`：Anki 卡片自动化助手
- `english-learn-cards`：英语词汇闪卡生成器
- `echodecks`：闪卡学习会话助手
- `echodecks-ultimate`：闪卡播客学习套件
- `curriculum-generator`：系统课程规划器
- `adaptive-learning-agents`：错题驱动自适应学习助手
- `adaptivetest`：自适应测验生成器
- `book-reader`：电子书阅读总结助手
- `canvas-lms`：Canvas 课程作业助手
- `2nd-brain`：个人第二大脑知识库
- `anthropology`：人类学学习导师
- `audio-gen`：学习音频生成器

### 科研 (`research`)

- `academic-research`：OpenAlex 论文检索器
- `academic-research-hub`：论文资料收集中心
- `academic-deep-research`：严谨学术深度调研
- `arxiv-search-collector`：arXiv 论文集采集器
- `abstract-searcher`：BibTeX 摘要补全器
- `agentic-paper-digest`：AI 论文每日速递
- `agentarxiv`：科研成果发布助手
- `ak-rss-24h-brief`：中文资讯 24 小时速报
- `blogwatcher`：博客与 RSS 监控器
- `skywork-search`：实时联网资料搜索器
- `jpg-ai-review`：资料结构化评审器
- `openclaw-free-web-search`：私有免费网页搜索器

### 生活 (`life`)

- `aholake-expense-tracker`：本地 Markdown 记账本
- `birthday-reminder`：生日与纪念日提醒
- `freshrss-reader`：自托管 RSS 阅读助手
- `get-weather`：天气查询助手
- `audio-transcribe`：本地语音转文字
- `csvtoexcel`：CSV 转 Excel 中文报表
- `calorie-counter`：热量蛋白记录器
- `diet-tracker`：每日饮食营养追踪器
- `calorie-visualizer`：本地热量记录可视化
- `actual-budget`：Actual 个人预算助手
- `firefly-iii`：Firefly III 自托管记账
- `paperless-ngx`：Paperless 文档归档助手

### 效率工具 (`productivity`)

- `ai-daily-briefing`：每日 AI 工作简报
- `agent-daily-planner`：每日任务规划器
- `adhd-daily-planner`：低启动成本日计划助手
- `4to1-planner`：长期目标拆解器
- `daily-review-ritual`：日终复盘仪式助手
- `async-task`：长任务后台执行器
- `cron-scheduling`：Cron 定时任务管理器
- `casual-cron`：自然语言定时任务助手
- `gotify`：任务完成推送通知
- `gog`：Google 工作区自动化助手
- `n8n`：n8n 工作流管理器
- `n8n-workflow-automation`：n8n 流程 JSON 生成器

### 清小搭官方 skill (`rag`)

- `deep-research-agent-workflow`：Deep Research 调研工作流
- `production-rag-orchestration`：产品级 RAG 主链路编排
- `structured-webnote-extraction`：结构化智能摘录 WebNote

## 给 Agent 的安装口令

```text
请安装 <skill-slug> 这个 Agent Skill。
目标目录是你当前框架会扫描的 skills 目录；如果没有指定，就先安装到 $HOME/soda-skillhub/skills。
如果使用 zip，请解压 <category>/<skill-slug>/<skill-slug>.zip，解压后应直接得到 <skill-slug>/SKILL.md。
安装后请验证 <skill-slug>/SKILL.md 存在，并告诉我实际安装路径。
```