Skill Sync

CLI til at liste, installere, opdatere og PR-pushe Claude-færdigheder mod et GitHub source-of-truth repo

Af jdrhyne · jdrhyne/agent-skills

Testet · Virker ★ 8.0/10

Skill Sync — CLI til at liste, installere, opdatere og PR-pushe Claude-færdigheder mod et GitHub source-of-truth repo

Hvad det gør

Indkapsler et bash script (skill-sync), der behandler et GitHub repo som den kanoniske kilde til agentfærdigheder: det kloner/pull-cacher repoet, lister tilgængelige færdigheder med deres frontmatter-beskrivelser, installerer en eller alle i en lokal skills-mappe og pusher lokale færdighedsredigeringer tilbage som en branch + PR via gh CLI. Udløses, når du beder om at installere, opdatere, liste eller pushe færdigheder til/fra det delte repo. Bemærk, at standardinstallationsmålet er ~/clawd/skills (OpenClaw layout), ikke ~/.claude/skills — sæt CLAWD_SKILLS_DIR til at pege på Claude Codes skills-mappe.

Testrapport

Klonede repoet til et midlertidigt HOME og kørte den faktiske scripts/skill-sync binære fil. `list` klonede cachen, ff-only pulled, og udskrev alle 18 færdigheder under skills/ med beskrivelser parset fra hver SKILL.md frontmatter; `install planner` kopierede skills/planner/ til $CLAWD_SKILLS_DIR (exit 0), og installation af et ugyldigt navn udskrev "not found in repository" og afsluttede med 1 som kodet. For OUTPUT sammenlignede jeg færdighedens installation med en manuel baseline (git clone + cp): den resulterende planner/SKILL.md var byte-identisk, så artefaktkanten er procesniveau (repo cache + ff-only pull, chmod +x på scripts, update-vs-install detektion, --all med self-skip, og en fuld branch→PR push flow) plus den frontmatter-parset `list` tabel, som baseline ikke producerer. Kunne ikke udøve `push` (kræver gh + skriveadgang til et repo, jeg ikke ejer). Ingen sikkerhedsbrister; scriptet bruger kun $HOME/env vars, ingen curl|sh eller hemmelighedshåndtering, og SKILL.md advarer mod at committe hemmeligheder. Hovedfriktion: standardmålet er ~/clawd/skills, ikke ~/.claude/skills, så en Claude Code-bruger skal sætte CLAWD_SKILLS_DIR.

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

Installation

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 til at liste, installere, opdatere og PR-pushe Claude-færdigheder mod et GitHub source-of-truth repo

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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