Claude Skills Registry – 它是什么

一个公开且可搜索的 Claude-Code“技能”目录（Claude 可以调用的可重用代码片段、工具和代理）。该项目由三个链接的仓库组成：

• claude-skill-registry-core – 权威流水线，负责爬取技能来源、验证它们、构建索引和静态网站。
• claude-skill-registry-data – 原始技能目录的存档 (skills/**)。
• claude-skill-registry – 一个生成的镜像，将核心逻辑、数据和预先构建的 JSON 成品打包，供下游使用。

该注册表本身不提供任何技能；它仅对其进行索引和描述，并链接回原始仓库和授权条款。

---

为什么它很重要

Claude-Code 代理需要一种方式来发现社区贡献的功能（例如 PDF 解析、测试自动化、DevOps 助手）。此注册表提供：

• 快速的客户端搜索 – 可在浏览器或 CLI 中加载的 gzipped JSON 索引。
• 元数据与质量信号 – 星数、安全扫描结果、类别标签和安装路径。
• 多种使用方法 – 网页 UI、基于 Go 的 CLI (sk) 以及原始 JSON API。

---

如何使用

方法	获得内容	快速开始
网页 UI	交互式搜索页面 (GitHub Pages)。	打开 https://majiayu000.github.io/claude-skill-registry/
CLI (sk)	基于终端的单一技能搜索与安装。	```bash
go install github.com/majiayu000/claude-skill-manager@latest

重命名为 sk 并确保它在 $PATH 中

sk search testing # 寻找技能 sk install anthropics/skills/skills/docx # 安装一个

| **JSON API** | 完整索引、类别分片、质量/安全排名等的直接下载。 | ```bash
curl https://majiayu000.github.io/claude-skill-registry/search-index-lite.json
# 或获取清单和个别分片文件
``` |

当您决定安装技能时，请**遵循条目中显示的来源链接**并尊重其原始授权。注册表仅指向该技能；它不会重新授权该内容。

---
## 架构概览

数据收集 (core) → 索引生成 (core) → 使用 (Web UI, sk CLI, JSON API)

* **第 1 层 – 数据收集** – GitHub 爬虫发现技能仓库、下载文件并运行安全扫描器。
* **第 2 层 – 索引生成** – 脚本产生多个 JSON 成品：
  * `search-index.json` (完整可搜索索引)
  * `search-index-lite.json` (用于快速客户端使用的精简版)
  * 类别清单、质量、安全和排名索引。
* **第 3 层 – 使用** – 生成的文件通过 GitHub Pages、`sk` Go 二进制文件或原始 HTTP 端点提供服务。

**核心仓库**包含所有流水线代码 (`scripts/`, `sources/`, `taxonomy/`)。**数据仓库**存储实际的 `skills/**` 树。**主（镜像）仓库**是一个每日生成的成品，将两者打包供下游用户使用。

---
## 入门指南（针对开发者）

1. **克隆核心仓库**（流水线的真实来源）：
   ```bash
   git clone --filter=blob:none --sparse https://github.com/majiayu000/claude-skill-registry-core.git
   cd claude-skill-registry-core
   git sparse-checkout set --cone docs scripts sources schema

2. 设置 Python 环境 (使用 uv)：

   uv venv && source .venv/bin/activate
   uv pip install -r requirements.txt
   

3. 在本地构建搜索索引 (选用，用于测试变更)：

   python scripts/build_search_index.py --registry registry.json --output docs
   

4. 在本地运行网页 UI：

   cd docs && python -m http.server 8000
   # 访问 http://localhost:8000
   

5. 提交新技能 – 开启带有“Add Skill”模板的 issue，或向核心仓库中的 sources/community.json 提交 JSON 条目的 PR。

---

路线图亮点

• ✅ 每日自动更新、安全扫描和网页 UI 已上线。
• ✅ 提供轻量级 gzipped 搜索索引。
• 计划中：基于向量的语义搜索、技能推荐引擎、版本追踪、质量评分和 API 速率限制。

---

授权

注册表代码与流水线采用 MIT License 发布 (参见 LICENSE)。

个别技能保留其原始授权；注册表不会重新授权第三方内容。

---

相关生态系统

该注册表是 Claude-Code 和其他 LLM 代理的更广泛“代理基础设施堆栈”的一部分：

层级	项目	角色
扩展	claude-skill-registry	发现并浏览社区技能
扩展	spellbook	跨运行时技能套件
信任	argus	供应链安全扫描器
信任	vibeguard	代理的运行时防线
记忆	remem	持久化本地内存
编排	harness	基于 Rust 的代理编排
路由	litellm‑rs	高性能 LLM 网关
维持	keepline	会话监控与恢复

---

总结

Claude Skills Registry 是一个维护良好、可搜索的社区贡献 Claude-Code 插件索引。它提供网页 UI、Go CLI (sk) 和原始 JSON API，全部由自动化流水线构建，该流水线负责爬取技能仓库、验证它们并发布每日更新。该项目完全属于 AI/LLM 工具范畴，并以 MIT 授权开源。