Skill Sync

CLI om Claude skills te listen, installeren, updaten en PR-pushen tegen een GitHub source-of-truth repo

Door jdrhyne · jdrhyne/agent-skills

Getest · Werkt ★ 8.0/10

Skill Sync — CLI om Claude skills te listen, installeren, updaten en PR-pushen tegen een GitHub source-of-truth repo

Wat het doet

Verpakt een bash script (skill-sync) dat een GitHub repo behandelt als de canonieke bron voor agent skills: het kloont/pull-cachet de repo, list beschikbare skills met hun frontmatter descriptions, installeert één of alle in een lokale skills directory, en pusht lokale skill edits terug als een branch + PR via de gh CLI. Activeert wanneer u vraagt om skills te installeren, updaten, listen of pushen naar/van de gedeelde repo. Let op: de standaard install target is ~/clawd/skills (OpenClaw layout), niet ~/.claude/skills — stel CLAWD_SKILLS_DIR in om het naar de skills dir van Claude Code te laten wijzen.

Testrapport

De repo gekloond naar een tijdelijke HOME en de daadwerkelijke scripts/skill-sync binary uitgevoerd. `list` kloonde de cache, deed een ff-only pull, en printte alle 18 skills onder skills/ met descriptions geparseerd uit elke SKILL.md frontmatter; `install planner` kopieerde skills/planner/ naar $CLAWD_SKILLS_DIR (exit 0), en het installeren van een onjuiste naam printte "not found in repository" en exited 1 zoals gecodeerd. Voor OUTPUT vergeleek ik de installatie van de skill met een handmatige baseline (git clone + cp): de resulterende planner/SKILL.md was byte-identiek, dus de artifact edge is op procesniveau (repo cache + ff-only pull, chmod +x op scripts, update-vs-install detectie, --all met self-skip, en een volledige branch→PR push flow) plus de frontmatter-parsed `list` tabel die de baseline niet produceert. Kon `push` niet uitoefenen (vereist gh + schrijftoegang tot een repo die ik niet bezit). Geen security smells; script gebruikt alleen $HOME/env vars, geen curl|sh of secret handling, en SKILL.md waarschuwt tegen het committen van secrets. Belangrijkste frictie: standaard target is ~/clawd/skills, niet ~/.claude/skills, dus een Claude Code gebruiker moet CLAWD_SKILLS_DIR instellen.

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/jdrhyne/agent-skills.git /tmp/skill-sync-src
mkdir -p ~/.claude/skills
cp -R /tmp/skill-sync-src/clawdbot/skill-sync ~/.claude/skills/skill-sync
# The CLI lives at ~/.claude/skills/skill-sync/scripts/skill-sync (not on PATH by default).
# Run it directly or symlink onto PATH, e.g.:
#   ln -sf ~/.claude/skills/skill-sync/scripts/skill-sync /usr/local/bin/skill-sync
# Requirements: git (always), and the `gh` CLI + repo write access ONLY for `skill-sync push`.
# Default paths (override via env):
#   AGENT_SKILLS_REPO  repo clone cache   (default ~/.agent-skills-repo)
#   CLAWD_SKILLS_DIR   local install dir  (default ~/clawd/skills)  <-- set to ~/.claude/skills for Claude Code
# IMPORTANT: the script only lists/installs skills under the repo's skills/ dir,
# so it will NOT install skills from clawdbot/, codex/, or prompts/.

Commando's en voorbeeldprompts

  • /skill-syncCLI om Claude skills te listen, installeren, updaten en PR-pushen tegen een GitHub source-of-truth repo

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • Install the latest skills from the source repo
  • Push my local skill changes to GitHub
  • List which skills are out of sync