Skill Sync

CLI för att lista, installera, uppdatera och PR-pusha Claude-färdigheter mot ett GitHub source-of-truth-repo

av jdrhyne · jdrhyne/agent-skills

Testad · Fungerar ★ 8.0/10

Skill Sync — CLI för att lista, installera, uppdatera och PR-pusha Claude-färdigheter mot ett GitHub source-of-truth-repo

Vad den gör

Kapslar in ett bash-skript (skill-sync) som behandlar ett GitHub-repo som den kanoniska källan för agentfärdigheter: det klonar/pull-cachas repot, listar tillgängliga färdigheter med deras frontmatter-beskrivningar, installerar en eller alla i en lokal färdighetskatalog, och pushar lokala färdighetsändringar tillbaka som en gren + PR via gh CLI. Utlöses när du ber att installera, uppdatera, lista eller pusha färdigheter till/från det delade repot. Observera att standardinstallationsmålet är ~/clawd/skills (OpenClaw-layout), inte ~/.claude/skills — ställ in CLAWD_SKILLS_DIR för att peka det mot Claude Codes färdighetskatalog.

Testrapport

Klonade repot till en temporär HOME och körde den faktiska scripts/skill-sync-binären. `list` klonade cachen, gjorde en ff-only pull, och skrev ut alla 18 färdigheter under skills/ med beskrivningar parsade från varje SKILL.md frontmatter; `install planner` kopierade skills/planner/ till $CLAWD_SKILLS_DIR (exit 0), och att installera ett ogiltigt namn skrev ut "not found in repository" och avslutade med 1 som kodat. För OUTPUT jämförde jag färdighetens installation mot en manuell baslinje (git clone + cp): den resulterande planner/SKILL.md var byte-identisk, så artefaktkanten är processnivå (repo-cache + ff-only pull, chmod +x på skript, uppdaterings-vs-installationsdetektering, --all med självhopp, och ett komplett branch→PR push-flöde) plus den frontmatter-parsade `list`-tabellen som baslinjen inte producerar. Kunde inte testa `push` (behöver gh + skrivåtkomst till ett repo jag inte äger). Inga säkerhetsbrister; skriptet använder endast $HOME/env-variabler, ingen curl|sh eller hemlighetshantering, och SKILL.md varnar mot att committa hemligheter. Huvudfriktion: standardmålet är ~/clawd/skills, inte ~/.claude/skills, så en Claude Code-användare måste ställa in CLAWD_SKILLS_DIR.

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

Kommandon och exempelprompter

  • /skill-syncCLI för att lista, installera, uppdatera och PR-pusha Claude-färdigheter mot ett GitHub source-of-truth-repo

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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