spike-faye-lei-dsh-skills

面向 DeepSeek Harness（DSH）的技能（skill）与 agent 合集：1371 个技能 + 93 个 agent，按类别分目录整理，全部通过 DSH 技能加载器的格式校验。

A curated collection of 1371 skills and 93 agents for DeepSeek Harness, organized by category. Every document in this repository validates against the DSH skill loader.

---

目录结构 / Structure

skills/
├── agents/       89    # agent 工作流
├── automation/  812    # Composio / Rube SaaS 自动化
├── platforms/   109    # 平台与站点集成
├── research/    106    # 科研 / 论文 / 实验
├── dev-tools/    95    # 开发工具与工程流
├── other/        94    # 其他
├── design/       38    # 设计 / 绘图 / 视觉
├── data/         16    # 数据 / 数据库 / ML
└── content/      12    # 写作 / 内容 / 职场
agents/           93    # agent 定义（独立 .md）
tools/                  # 校验 / 修复 / 安装 / 目录生成

安装 / Install

DSH 只在一层深度内发现技能（<root>/<name>/SKILL.md），所以分目录的技能需要先铺平。三种方式任选：

1. 跨平台安装器（推荐，Windows / macOS / Linux 通用，无需 bash）

node tools/install.mjs                 # 铺平到 ~/.dsh/skills/
node tools/install.mjs --dry-run       # 先看会装什么
node tools/install.mjs --category research --category design
node tools/install.mjs --only arxiv --only paper-write
node tools/install.mjs --target /path/to/skills

同名技能会被检测出来并跳过（--force 可覆盖），不会静默互相覆盖。

2. bash（macOS / Linux / Git Bash）

./flatten.sh            # 铺平到 ~/.dsh/skills/
./flatten.sh /path/to/dir

3. 手动

find skills -mindepth 3 -maxdepth 3 -name SKILL.md -exec dirname {} \; | xargs -I{} cp -r {} ~/.dsh/skills/

安装后重启（或热挂载后刷新）DSH，技能即可在会话中通过名称触发。

技能格式 / Format

每个技能是一个目录 <name>/SKILL.md，DSH 的加载规则（源码：packages/skill/skill-filesystem/src/index.ts）为：

---
name: kebab-case-name        # 必填，必须匹配 ^[a-z0-9]+(?:-[a-z0-9]+)*$
description: 一句话说明何时使用   # 必填，非空字符串
---

• frontmatter 第一行必须恰好是 ---，并以另一行 --- 结束；中间必须是 YAML 映射。
• disable-model-invocation / user-invocable 可选，须为布尔值；旧写法 disableModelInvocation、modelInvocable、userInvocable 会被 DSH 拒绝。
• 不满足以上任一条，DSH 会静默忽略该技能（只在日志里给一条 warn）。

工具 / Tooling

命令	作用
node tools/validate.mjs	按 DSH 规则校验全部技能与 agent；列出错误、警告、重名冲突。--json out.json 输出机器可读报告。
node tools/repair.mjs	自动修复 frontmatter：补齐 / 纠正 name、合成或加引号转义 description，只动 frontmatter，不碰正文。默认 dry-run，--apply 写入。
node tools/install.mjs	跨平台铺平安装。
node tools/build-index.mjs	由 frontmatter 生成 INDEX.md 与 catalog.json 目录。

validate.mjs 会优先使用 DSH 自带的 yaml 包（与 DSH 解析行为完全一致），找不到时退回内置的子集解析器。退出码非 0 表示存在问题，可直接接进 CI。

本次更新 / What changed in this update

用 tools/validate.mjs 对 HEAD（01fb4fb）与本次更新后的工作区做同口径校验：

指标	更新前	更新后
加载器错误（会导致 DSH 静默忽略该技能）	241	0
格式警告	125	3（仅超长 description，DSH 无硬限制）
铺平后重名冲突	3	0
DSH 发现不了的技能（埋在三层及更深）	106	2（trivium 自带的 deps/，刻意保留）

具体改动：

• 修复 241 处会导致技能无法加载的错误：101 个非法技能名（含大写、下划线，如 name: Apify Automation，DSH 直接忽略）、96 份完全没有 frontmatter、24 份缺 name、20 处 YAML 语法错误（description 中含未加引号的 : ）。本次提交共修改 262 个、新增 7 个、删除 355 个受版本控制的文件。
• 对齐 name 与目录名并消除 3 组重名（lean-ctx、template-skill、notebooklm），铺平安装后不再互相覆盖。
• 布局修正：埋在三层深的技能调整到 DSH 能发现的一层深度；把误当作类别的技能包 skills/design/（SKILL.md + references/ + scripts/ + data/）归位到 skills/design/design/。
• 移除 skills-codex* 镜像层（3 个家族、102 个技能目录、159 个文件）。它是上游 ARIS 技能集面向 Codex CLI 的镜像与适配层（评委契约调用 spawn_agent / send_input，DSH 中不存在这些工具），102 个技能名 100% 与仓库已有技能重名，而且原本就埋在三层深度、DSH 根本发现不到。另外删除：great-cto/great_cto/（与 great-cto/ 逐字节重复，161 个文件）、dream-cache/（运行时 JSON 缓存，34 个文件）、agents/Untitled-1.agent.md（混入的 Python 片段）。 删除后 DSH 可发现的技能数没有减少：更新前 1370，更新后 1371（+1 是 skills/design/design/ 首次可见）。
• 新增 tools/ 工具链（校验 / 修复 / 安装 / 目录生成）与 INDEX.md、catalog.json。

许可 / License

本仓库整理结构（README、tools/、flatten.sh、目录组织）采用 CC BY-NC 4.0 许可，禁止任何第三方商用。

⚠️ 各技能（1371）与 agent（93）为社区收集，版权归原作者所有，保留其原始许可（见各 SKILL.md frontmatter 的 license 字段），本仓库不对其重新授权。

注：Anthropic 官方 docx/pdf/pptx/xlsx 四个技能为专有许可（Proprietary），未收录。