nikships/skills-registry

skills-registry 是做什麼的？

你的個人 GitHub AI 代理技能註冊表。一個儲存庫。所有代理。所有裝置。按需載入 — 零啟動膨脹。

概述

nikships/skills-registry 提供了一個集中式管理 AI 代理技能的方式。只需一個 GitHub 儲存庫，你就能為所有 AI 代理（如 Claude Code、Cursor、Codex 等）定義、版本控制、分享和按需載入技能。告別每個專案或裝置單獨配置技能的麻煩，所有技能統一管理，即時同步。

核心特性

• 單一真相來源：所有技能定義儲存在一個 GitHub 儲存庫中，便於維護與協作。
• 多代理支援：相容主流 AI 代理平台，無需重複編寫技能。
• 按需載入：代理僅在需要時從註冊表拉取技能，減少不必要的資源佔用。
• 零啟動膨脹：技能不會在代理啟動時自動載入，只有被呼叫時才會動態獲取，保持代理輕量化。
• 基於 Markdown：每個技能以標準 SKILL.md 文件撰寫，語法簡單，易於版本管理和程式碼審查。

開始使用

1. Fork 或 Clone 此儲存庫到你自己的 GitHub 帳號。

2. 新增技能：在 skills/ 目錄下建立 Markdown 文件，每個文件代表一個技能，並遵循 SKILL.md 格式。

3. 設定代理：在 AI 代理的設定檔案中指定註冊表 URL，例如：

   {
     "skillsRegistry": "https://api.github.com/repos/你的使用者名稱/skills-registry/contents/skills"
   }
   

4. 在代理中使用：當代理需要某個技能時，它會自動從註冊表下載並執行對應的 SKILL.md。

技能定義範例

以下是一個簡單技能 skills/translate.md 的範例：

# translate

將文字翻譯成目標語言。

## 使用方式

翻譯 "Hello world" 成繁體中文

## 參數

- `text`（必要）：要翻譯的文字。
- `target`（必要）：目標語言代碼（例如 zh-TW、en、ja）。

## 範例

翻譯 "Good morning" 成日文

平台支援

• Claude Code
• Cursor
• Codex
• 以及其他支援客製化技能載入的 AI 代理。

貢獻指南

1. 建立新的分支。
2. 在 skills/ 目錄下新增或修改技能。
3. 提交 Pull Request 並附上詳細說明。
4. 等待審查與合併。

授權

本專案採用 MIT 授權條款。詳情請參閱 LICENSE 文件。