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-code

Installs 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: 等
mdmarkdown.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 的机会。问自己:

  1. 新增 skill 了吗?README 的 skill 清单 / 安装命令需要加一行
  2. 删了 skill 吗?README 对应行要删
  3. 某个 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
1getsentry avatariterate-prgetsentry/skillsIterate on a PR until actionable CI passes and high/medium review feedback is addressed. Use for PR CI failures, review feedback, or green-check loops; do not w4.7Kskills.sh installs
2klerith avatarspec-implklerith/fernando-skillsImplements an approved spec. Validates that the state means "Approved" (in any language), creates a git branch named after the spec, switches to it, and starts 4.5Kskills.sh installs
3grafana avatark6-docsgrafana/skillsWrite or review k6 documentation across the three k6 repositories - k6-DefinitelyTyped (TypeScript types), k6-docs (user documentation), and k6 (release notes /4.5Kskills.sh installs
4thedotmack avataroh-my-issuesthedotmack/claude-memCluster a GitHub issue backlog by root cause into a small set of plan-master issues, redirect children with a standardized comment, and bundle architectural-fix4.3Kskills.sh installs
5starchild-ai-agent avatarcomposiostarchild-ai-agent/official-skillsComposio gateway: act on 1000+ connected apps like Gmail, Slack, GitHub, Calendar. Use when the user wants to act in a connected SaaS app (e.g. send Gmail, crea4.3Kskills.sh installs
6grafana avatarskill-authoringgrafana/skillsAuthor, audit, and improve Grafana SKILL.md files against Anthropic's published Agent Skills guidance and the four-dimension rubric the grafana/skills CI gate u4.2Kskills.sh installs