Skill Sync

CLI for å liste, installere, oppdatere og PR-pushe Claude-ferdigheter mot et GitHub source-of-truth repo

av jdrhyne · jdrhyne/agent-skills

Bestått ★ 8.0/10

Skill Sync — CLI for å liste, installere, oppdatere og PR-pushe Claude-ferdigheter mot et GitHub source-of-truth repo

Hva den gjør

Pakker inn et bash-skript (skill-sync) som behandler et GitHub-repo som den kanoniske kilden for agentferdigheter: det kloner/pull-cachelagrer repoet, lister tilgjengelige ferdigheter med deres frontmatter-beskrivelser, installerer en eller alle i en lokal ferdighetskatalog, og pusher lokale ferdighetsredigeringer tilbake som en gren + PR via gh CLI. Utløses når du ber om å installere, oppdatere, liste eller pushe ferdigheter til/fra det delte repoet. Merk at standard installasjonsmål er ~/clawd/skills (OpenClaw layout), ikke ~/.claude/skills — sett CLAWD_SKILLS_DIR til å peke den mot Claude Codes ferdighetskatalog.

Testrapport

Klonet repoet til en midlertidig HOME og kjørte den faktiske scripts/skill-sync binærfilen. `list` klonet cachen, ff-only pulled, og skrev ut alle 18 ferdighetene under skills/ med beskrivelser parsert fra hver SKILL.md frontmatter; `install planner` kopierte skills/planner/ til $CLAWD_SKILLS_DIR (exit 0), og installering av et ugyldig navn skrev ut "not found in repository" og avsluttet med 1 som kodet. For OUTPUT sammenlignet jeg ferdighetens installasjon mot en manuell baseline (git clone + cp): den resulterende planner/SKILL.md var byte-identisk, så artefaktkanten er prosessnivå (repo cache + ff-only pull, chmod +x på skript, update-vs-install deteksjon, --all med self-skip, og en full branch→PR push-flyt) pluss den frontmatter-parsede `list`-tabellen baseline ikke produserer. Kunne ikke utføre `push` (trenger gh + skrivetilgang til et repo jeg ikke eier). Ingen sikkerhetsbrister; skriptet bruker kun $HOME/env-variabler, ingen curl|sh eller hemmelig håndtering, og SKILL.md advarer mot å committe hemmeligheter. Hovedfriksjon: standardmålet er ~/clawd/skills, ikke ~/.claude/skills, så en Claude Code-bruker må sette CLAWD_SKILLS_DIR.

Testet på: 2026-07-31 · Claude Code 2.x (agent harness)

Installer

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/.

Kommandoer og eksempelprompter

  • /skill-syncCLI for å liste, installere, oppdatere og PR-pushe Claude-ferdigheter mot et GitHub source-of-truth repo

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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