majiayu000/claude-skill-registry · 上手攻略

• 仓库：majiayu000/claude-skill-registry
• 链接：https://github.com/majiayu000/claude-skill-registry
• 分类：academic-writing
• 作者：Tom
• 更新：2026-08-16

是什么

majiayu000/claude-skill-registry 是目前最全面的 Claude Code Skills 索引库，每日自动抓取 GitHub 和社区来源的 Claude Code skill，经去重、质量评分和安全扫描后提供可搜索的索引。

它包含两个核心组件： - 核心库（majiayu000/claude-skill-registry-core）：负责抓取流水线、索引生成和 Web UI - 数据存档（majiayu000/claude-skill-registry-data）：存放归档的 skill 内容

当前收录 skill 总数数千个（数字持续变动，详见 registry_summary.json），Star 552（周增 +7）。

解决什么问题

Claude Code 用户面临的问题：想找一个做 PDF 处理的 skill，但不知道 GitHub 上有哪些可用；找到之后不知道怎么安装、怎么管理。majiayu000/claude-skill-registry 通过三件事解决：

1. 发现：每日自动爬取 GitHub 上所有公开 Claude Code skills，建立索引
2. 搜索：提供 Web UI、sk CLI 和 JSON API 三种查询方式
3. 安装：通过 sk CLI 一键安装想去重的 skill

快速安装

sk CLI（推荐方式）

# macOS (Apple Silicon)
curl -L https://github.com/majiayu000/caude-skill-manager/releases/latest/download/sk_darwin_arm64.tar.gz | tar xz
sudo mv sk /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/majiayu000/caude-skill-manager/releases/latest/download/sk_darwin_amd64.tar.gz | tar xz
sudo mv sk /usr/local/bin/

# Linux (amd64)
curl -L https://github.com/majiayu000/caude-skill-manager/releases/latest/download/sk_linux_amd64.tar.gz | tar xz
sudo mv sk /usr/local/bin/

或通过 Go 安装：

go install github.com/majiayu000/caude-skill-manager@latest

Web UI（无需安装）

直接访问：https://majiayu000.github.io/claude-skill-registry-core/

支持按关键词搜索、分类浏览（Development、Testing、DevOps、Design 等），并显示 star 数量和质量评分。

核心用法

sk CLI 用法

搜索 skill（无参数时显示热门列表）：

sk search                    # 显示热门 skills 列表
sk search testing            # 按关键词搜索
sk search pdf                # 搜索 pdf 相关
sk search --popular          # 同上，显示热门

安装 skill：

# 从 GitHub 安装（owner/repo 格式）
sk install anthropics/skills/docx
sk install obra/superpowers

# 直接用 skill 名称安装（从 registry）
sk install docx

# 从完整 URL 安装
sk install https://github.com/user/repo

查看已安装列表：

sk list

查看 skill 详情：

sk info my-skill

卸载 skill：

sk uninstall my-skill

健康检查：

sk doctor                # 检查本地 skills 健康状态
sk doctor --registry     # 检查 registry 连通性

JSON API 用法（程序化集成）

直接调用 GitHub Pages 托管的 JSON 索引，适合自己搭建前端或脚本自动化：

# 轻量搜索索引（快速）
curl https://majiayu000.github.io/claude-skill-registry-core/search-index.json

# 搜索索引清单
curl https://majiayu000.github.io/claude-skill-registry-core/search-index-manifest.json

# 质量评分索引
curl https://majiayu000.github.io/claude-skill-registry-core/quality-index.json

# 安全扫描索引
curl https://majiayu000.github.io/claude-skill-registry-core/security-index.json

# 分类索引
curl https://majiayu000.github.io/claude-skill-registry-core/categories/index.json

# registry 热门度排名
curl https://majiayu000.github.io/claude-skill-registry-core/ranking-index.json

# 仓库概览（skill 总量/更新时间）
curl https://raw.githubusercontent.com/majiayu000/claude-skill-registry-core/main/registry_summary.json

⚠️ 重要：majiayu000/claude-skill-registry 是发布镜像库（publish artifact），核心源码和工作流在 claude-skill-registry-core；JSON API 契约见 docs/artifact-api-contract.md。

典型适用场景

坑与注意

1. 镜像库 vs 核心库：向 main 仓库（majiayu000/claude-skill-registry）提交普通 source PR 无效——源码变更应发往 claude-skill-registry-core，数据存档应发往 claude-skill-registry-data。main 只是发布镜像。
2. 大仓库 clone：如果需要 clone 主仓库，建议阅读 docs/FAST_CLONE.md 获取加速建议；数据存档 claude-skill-registry-data 可能较大。
3. sk CLI 的 registry 配置：默认 registry 指向 main 分支的 JSON，配置文件在 ~/.skrc，可修改 registry 字段切换数据源。
4. skill 安装路径：默认安装到 ~/.claude/skills/，不同工具链可能有自己的 skills 目录约定。
5. sk update 尚未实现：当前版本的 sk update 只打印手动重装指引，还不支持真正的增量更新命令。

与同类对比

majiayu000/claude-skill-registry 的核心优势是规模最大 + 每日更新 + sk CLI 闭环，比漫无目的地在 GitHub 搜索效率高得多。

一句话推荐结论

Claude Code 用户找 skill 的第一入口：Web UI 浏览、sk CLI 搜索安装、JSON API 程序化集成三位一体，是目前最完整的 Claude Code skill 生态索引。