self-skills-cli

self-skills-cli 是一个面向 CodeX 和 Claude 的 Skills 备份管理工具。

它不会把当前源码仓库当成 Skills 仓库，而是在用户目录下创建并管理一个专门的 Skills 备份 Git 仓库，然后负责：

• 将远端备份仓库中的 Skills 同步到本机 CodeX 或 Claude
• 将本机 CodeX 或 Claude Skills 同步回远端备份仓库
• 为备份仓库自动生成 README.md 索引，基于每个 SKILL.md 的文件头信息拼接目录说明

安装

npm install -g self-skills-cli

pnpm add -g self-skills-cli

yarn global add self-skills-cli

初始化

第一次使用前必须先设置 Skills Git 仓库。

• 仓库地址不能为空
• 分支可以留空，默认 main
• 如果输入 http/https 地址，会自动转换成 SSH 地址

示例：

self-skills init [email protected]:your-name/skills-backup.git main

self-skills init https://github.com/your-name/skills-backup

第二种会被自动规范成：

[email protected]:your-name/skills-backup.git

使用

默认启动后会进入交互式引导菜单，不需要手动输入复杂命令：

self-skills

启动时会自动检查 npm 上是否有更新版本；如果发现新版本，会在顶部提示升级命令。

主菜单会提供这些操作：

1. 初始化 / 配置备份仓库
2. 查看当前状态
3. 查看技能列表
4. 将远端仓库同步到 CodeX
5. 将远端仓库同步到 Claude
6. 将 CodeX 同步到远端仓库
7. 将 Claude 同步到远端仓库
8. 查看备份仓库 Git 状态
9. 拉取备份仓库 Git 更新
10. 发布备份仓库到远端
11. 查看帮助
12. 退出

同步方式

无论是“远端仓库 -> CodeX / Claude”，还是“CodeX / Claude -> 远端仓库”，都支持三种方式：

1. 只同步双方都存在的 Skills
2. 同步全部 Skills
3. 按编号选择指定 Skill

说明：

• 远端 -> 本机平台：会先检查并拉取远端备份仓库，再执行同步
• 本机平台 -> 远端：会先尝试拉取远端已有分支，再导入本机技能并自动推送
• cloud 是 claude 的命令别名

直接命令

如果你需要脚本化，也可以直接执行命令：

查看帮助：

self-skills help

查看当前配置：

self-skills repo
self-skills status

查看技能列表：

self-skills list repo
self-skills list codex
self-skills list claude
self-skills list all

远端仓库同步到本机平台：

self-skills remote-sync codex existing
self-skills remote-sync codex all
self-skills remote-sync claude selected some-skill

本机平台同步到远端仓库：

self-skills platform-sync codex existing
self-skills platform-sync codex all
self-skills platform-sync cloud selected some-skill

备份仓库 Git 操作：

self-skills git status
self-skills git pull origin main
self-skills publish origin main

配置

这个项目默认不自动读取 .env 文件。 如果你想覆盖默认路径，可以通过环境变量指定：

| 变量名 | 用途 | 默认值 | | --- | --- | --- | | SELF_SKILLS_HOME | 备份管理目录根路径 | ~/.self-skills-cli | | CODEX_SKILLS_DIR | 本机 CodeX 技能目录 | ~/.codex/skills | | CLAUDE_SKILLS_DIR | 本机 Claude 技能目录 | ~/.claude/skills |

默认目录结构：

~/.self-skills-cli/
  config.json
  repos/
    skills-backup/
      .git/
      README.md
      .self-skills-backup.json
      skills/

其中备份仓库根目录的 README.md 会自动生成，作为 Skills 索引目录，点击即可跳到对应的 SKILL.md。 .self-skills-backup.json 会写入仓库地址、分支和 skills/ 目录信息；如果本地配置文件丢失，程序会优先从这个文件恢复配置并重建本地 Skills 目录。

备份仓库 README

每次有 Skill 被导入到备份仓库时，程序都会自动重写备份仓库根目录下的 README.md。

这个索引 README 会：

• 扫描 skills/ 下的所有 Skill
• 读取每个 SKILL.md 文件头部的元信息
• 自动拼接为目录列表
• 生成指向对应 SKILL.md 的相对链接

如果某个 Skill 的头部包含：

---
name: my-skill
description: demo description
user-invocable: true
---

那么备份仓库 README 中会出现对应条目和链接。