makecoder-skillhub

作者 ydong global

管理 MakeCoder SkillHub 上的 skill。通过 `coder skills` 命令进行 skill 的安装、卸载、搜索、发布、下架和团队管理。当用户需要：安装或卸载skill，搜索skill，发布skill到SkillHub，下架已发布的skill，查看已发布的skill列表，查看团队，时触发此skill。关键词：skills、skillhub、coder skills、发布 skill、安装 skill。

来源：SKILL.md

# MakeCoder SkillHub

通过 `coder skills` CLI 管理 SkillHub（`https://makecoder.com/skillhub`）上的 skill。


## Skill 名称格式

- **公共 skill**：直接用 slug，例如 `vue`
- **团队私有 skill**：需加团队前缀，格式为 `<teamId>--<slug>`，例如 `12680de5--my-skill`
- teamId 为团队 ID 前 8 位，运行 `coder team list` 查看所属团队列表

## 本地 Skill 管理

```bash
coder skills add vue                              # 安装公共 skill
coder skills add 12680de5--my-skill               # 安装团队私有 skill
coder skills remove <name>                        # 卸载本地 skill
coder skills update [name]                        # 更新指定 skill，不指定则更新全部
```

安装时会将 skill 同步写入 `~/.agents/skills/` 目录。

## 搜索

```bash
coder skills search <关键词>
```

## 发布 Skill

```bash
# 发布当前目录（自动使用默认团队，未设置团队则发布到公共）
coder skills publish

# 发布指定目录或 zip 文件
coder skills publish ./my-skill-dir
coder skills publish my-skill.zip

# 临时指定团队（覆盖默认团队）
coder skills publish --team 12680de5 ./my-skill-dir

# 指定可见性
coder skills publish --visibility PRIVATE

# 附加元数据
coder skills publish --meta-data '{"source":"xxxx"}' ./my-skill-dir
```

**团队与可见性规则：**
- 未传 `--team` 时，自动使用 `coder team use` 设置的默认团队（取团队 ID 前 8 位）
- 未设置默认团队时，发布到公共（global）
- 团队 skill 可见性自动锁定为 `NAMESPACE_ONLY`；公共 skill 默认 `PUBLIC`

发布时优先使用 `git archive`（自动排除 `.gitignore` 中的文件），无 `.git` 时回退到 `zip`。

Skill 目录必须包含有效的 `SKILL.md`，frontmatter 需有 `name` 和 `description` 字段。

## 下架 Skill

```bash
coder skills unpublish my-skill                   # 下架（使用默认团队）
coder skills unpublish 12680de5--my-skill         # 下架指定团队的 skill
```

## 列出团队 Skill

```bash
coder skills list                        # 列出当前团队下的 skill（第 1 页）
coder skills list --page 1               # 第二页
coder skills list --team 12680de5        # 指定团队
```

## 查看我发布的 Skill

```bash
coder skills my-skills                   # 查看我发布的 skill
coder skills my-skills --page 1          # 第二页
```

显示团队/名称、星标数、下载数和状态。

## 发布新 Skill 的典型流程

1. 创建 skill 目录，添加 `SKILL.md`（含 `name` 和 `description` frontmatter）
2. 添加支持文件（脚本、模板、参考资料等）
3. 确认默认团队：`coder team use <teamId>`（可选，不设则发布到公共）
4. 在目录内执行 `coder skills publish`
5. 用 `coder skills list` 确认发布状态