
Ljg Push
This is a personal workflow automation for syncing Claude skills to a GitHub repo with two branches: master keeps org-mode format, md branch converts to markdown. It's hardcoded to push ljg-* skills from ~/.claude/skills/ to a specific repo, with a mandatory README consistency check that blocks pushes if local skills don't match what's documented. The conversion is partial by design,it handles file extensions and keywords automatically but leaves bold syntax and frontmatter for manual cleanup. If you maintain your own skill collection across machines and want a one-command sync that enforces documentation discipline, this is a solid template to fork and adapt.
- skills.sh installs
- 4.7K
- GitHub stars
- 7.7K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add lijigang/ljg-skills --skill ljg-push --agent claude-codeInstalls into .claude/skills of the current project.
Files
ljg-push: 推送 ljg-* skills
把本地 ~/.agents/skills/ljg-* 里改过的 skills,一键同步到 github repo,覆盖 master 和 md 两个分支。
仓库路径(硬编码)
SKILLS_REPO="$HOME/code/ljg-skills" # 本地工作 repo
SKILLS_LOCAL="$HOME/.agents/skills" # 本地 skill 源
REPO_URL="git@github.com:lijigang/ljg-skills.git"
如果 $SKILLS_REPO 不存在,脚本会自动 clone。如果它存在但不是 ljg-skills 的 git repo,脚本会报错退出(不破坏现有目录)。
两条分支的差异
| 分支 | 输出格式 | 文件扩展 | 加粗 | 文件头 |
|---|---|---|---|---|
master(默认) | org-mode | .org | *bold* | #+title: 等 |
md | markdown | .md | **bold** | YAML frontmatter |
~/.agents/skills/ 里的 skill 是 master 风格(源版本)。md 分支的差异由脚本自动转换 + 必要时手工补。
脚本推完 md 后会自动切回 master。本地 $HOME/code/ljg-skills 应该始终停在源分支,方便下次查看和安装。
工作流
按 Workflows/Push.md 步骤执行 → 调用 Tools/Push.sh。
README 一致性(硬 gate)
每次 push 前,脚本强制做一件事:把 README 跟 local skills 对一遍。
- 列出
~/.agents/skills/ljg-*全部 skill 名 - grep
$SKILLS_REPO/README.md里出现的ljg-xxx - 找出 local 有但 README 没有的——几乎肯定意味着 README 漏更新
- 命中 → push 中止,报告差异
每次 push 都是检视 README 的机会。问自己:
- 新增 skill 了吗?README 的 skill 清单 / 安装命令需要加一行
- 删了 skill 吗?README 对应行要删
- 某个 skill 的描述大改了吗?README 的简介可能要同步
Sponsors
Details
- Repository
- github.com/lijigang/ljg-skills
- Category
- Git & Pull Requests
- First seen
- May 16, 2026
More from lijigang/ljg-skills
All 25- Ljg Book4K
- Ljg Library1.8K
- Ljg Map1.2K
- Fix Ljg Org To Md1.1K
- Ljg X Download474
- Ljg Card7.1K
- Ljg Paper7K
- Ljg Roundtable6.9K
- Ljg Writes6.7K
- Ljg Learn6.6K
- Ljg Invest6.4K
- Ljg Plain6.4K
- Ljg Rank6.4K
- Ljg Relationship6.3K
- Ljg Word6.3K
- Ljg Think6K
- Ljg Travel6K
- Ljg Read5.8K
- Ljg Paper Flow5.3K
- Ljg Skill Map5.2K
- Ljg Present5.2K
- Ljg Paper River5.1K
- Ljg Word Flow5.1K
- Ljg Qa4.9K