dsh-skill-adapter

把 Claude Code / Codex 生态的 SKILL.md 技能导入或运行时挂载进 DeepSeek Harness（DSH）。

DeepSeek Harness 原生就认 /SKILL.md（YAML frontmatter + Markdown），frontmatter 键名也与 Anthropic 规范对齐（name / description / whenToUse / disable-model-invocation / user-invocable）。缺的只是导入、归一化与分发工具链——本仓库补上这一环，让你把 addyosmani/agent-skills、ckorhonen/claude-skills 等数万星技能库一键搬进 DSH。

能力

包	形态	作用
@dsh-skill-adapter/core	库	SKILL.md 解析（零依赖手写 YAML 子集）、frontmatter 归一化、本地/GitHub 源扫描
@dsh-skill-adapter/cli	CLI	dsh-skill-import：批量抓取 → 校验 → 归一化 → 写盘 → 兼容性报告
@dsh-skill-adapter/plugin	DSH 插件	注册一个 SkillProvider，运行时把 GitHub / 本地目录的技能动态挂载进 DSH

归一化规则（对齐 DSH skill-filesystem 的行为）：

• 必需 frontmatter name + description（缺一即跳过并报告）
• name 非法时自动转 kebab-case
• when-to-use / when_to_use → whenToUse
• disable-model-invocation、user-invocable 透传为调用控制
• 其余字段（如 Claude 的 allowed-tools、metadata）保留进 metadata

快速开始

git clone  && cd dsh-skill-adapter
# 零运行时依赖，无需 npm install，Node ≥ 18.17 直接跑

方式一：CLI 导入器（一次性导入到 DSH skills 目录）

# 从 GitHub 技能库导入（默认输出到 ~/.dsh/skills，即 DSH 的 user-dsh root）
node packages/cli/src/cli.js \
  --source github:addyosmani/agent-skills \
  --verbose

# 多个源 + 指定输出目录 + 预览
node packages/cli/src/cli.js \
  --source github:ckorhonen/claude-skills \
  --source local:./my-skills \
  --out ~/.dsh/skills \
  --dry-run --verbose

# 输出 JSON 报告
node packages/cli/src/cli.js --source local:./examples/skills --json

source 语法：github:owner/repo[@ref][:path1,path2] 或 local:/path（可重复 --source）。

装好后，技能即出现在 /.dsh/skills 或 ，DSH 会自动发现。