skillreg
本地 AI Agent Skill 管理工具
skillreg 用来管理本地 AI Agent Skills。你可以把任意项目里写好的
SKILL.md 注册到统一 workspace，再同步到 Claude、Codex、CodeBuddy 或
~/.agents/skills 等 agent skill 目录。
能力
- CLI：创建/切换 workspace，注册/转换 skill，管理 NPM 来源、targets/projects，执行 sync，查看 diff，启动 dashboard。
- Skill：内置
skillreg-skill，让 agent 在任意项目里识别本地SKILL.md并注册到当前 workspace。 - Dashboard：提供图形入口，可从本地、ZIP、Git 或 NPM 包导入 skill，管理 NPM 来源、同步目标、项目组、仓库状态、依赖图与 Git 记录。
安装与使用
使用 uv 安装：
uv tool install skillreg
也可以通过 npm 安装：
npm install --global skillreg
npm 启动器会运行完全相同版本的 Python 包。系统有 uv 时直接使用；否则首次
运行时会通过 Python 3.9+ 创建隔离环境，并从 PyPI 下载依赖。
安装后：
skillreg workspace create ~/my-skills
skillreg register /path/to/my-skill
skillreg target add ~/.codex/skills
skillreg sync execute --target ~/.codex/skills
skillreg dashboard open
查看完整命令和参数：
skillreg -h
skillreg <group> -h
需要导入 NPM Skill 包时，使用 skillreg source npm -h 查看来源预览、导入
和更新命令。skillreg 只下载并校验 registry 制品，不执行 npm install 或
生命周期脚本。
远程安装可从 Dashboard 的「SSH 同步」进入，按“添加连接 → 选择 Agent 或项目
安装目录 → 预览 → 确认同步”操作，并查看执行记录。CLI 使用 skillreg connection -h
和 skillreg sync -h；前置条件和示例见 SSH 同步指南。
开发
git clone https://github.com/fcraft/skillreg.git
cd skillreg
uv sync --extra dev
scripts/install-git-hooks.sh
uv run pytest -q
uv run --with ruff ruff check src/ tests/ scripts/
本地发版使用：
scripts/release.sh --dry-run
scripts/release.sh
脚本会根据上一个发布 tag 之后的 Conventional Commits 预览下一版本；正式执行 时统一同步版本、完成测试并创建 release commit/tag，再由 GitHub Actions 发布到 GitHub Release、PyPI 和 npm。
Contributors
Trend
License
1 maintainer
Metadata
1 maintainer
Release files for skillreg 1.11.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| skillreg-1.11.1.tar.gz | 421.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| skillreg-1.11.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 697.3 kB
Release files / skillreg-1.11.1.tar.gz
| Download URL | skillreg-1.11.1.tar.gz |
|---|---|
| Size | 421.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cffa808d3a16afa333af4ec10fa0ca8524aa0e70fa9bea7a0ace7059d47a19aa
|
|
BLAKE2b-256 checksum How to use checksums |
c52d21830926ef55c97b55833e6deaf92a8d46771ab63cd8cfdf4b51806d10dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency logRelease files / skillreg-1.11.1-py3-none-any.whl
| Download URL | skillreg-1.11.1-py3-none-any.whl |
|---|---|
| Size | 276.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
257e2d45575627ce1917c00deba1037406da9a564eb3f052d298855244ff2032
|
|
BLAKE2b-256 checksum How to use checksums |
f5bc90f3e3c6f06e064208e5d3e2de9563480df534af1a45a209a3e1628724ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency log
