Skill Sync

CLI do listowania, instalowania, aktualizowania i PR-push umiejętności Claude wobec repozytorium GitHub jako źródła prawdy

Autor: jdrhyne · jdrhyne/agent-skills

Testowano · Działa ★ 8.0/10

Skill Sync — CLI do listowania, instalowania, aktualizowania i PR-push umiejętności Claude wobec repozytorium GitHub jako źródła prawdy

Co robi ten skill

Zawiera bash script (skill-sync), który traktuje repozytorium GitHub jako kanoniczne źródło umiejętności agenta: klonuje/pull-caches repozytorium, listuje dostępne umiejętności z ich opisami frontmatter, instaluje jedną lub wszystkie do lokalnego katalogu skills i wypycha lokalne edycje umiejętności z powrotem jako branch + PR za pośrednictwem gh CLI. Uruchamia się, gdy poprosisz o zainstalowanie, zaktualizowanie, listowanie lub wypchnięcie umiejętności do/z współdzielonego repozytorium. Zauważ, że domyślny cel instalacji to ~/clawd/skills (układ OpenClaw), a nie ~/.claude/skills — ustaw CLAWD_SKILLS_DIR, aby wskazywał na katalog skills Claude Code.

Raport z testu

Sklonowano repozytorium do temp HOME i uruchomiono rzeczywisty scripts/skill-sync binary. `list` sklonował cache, ff-only pulled i wydrukował wszystkie 18 umiejętności pod skills/ z opisami parsowanymi z każdego frontmatter SKILL.md; `install planner` skopiował skills/planner/ do $CLAWD_SKILLS_DIR (exit 0), a instalacja fałszywej nazwy wydrukowała "not found in repository" i zakończyła się z kodem 1 zgodnie z kodem. Dla OUTPUT porównałem instalację umiejętności z manualnym baseline (git clone + cp): wynikowy planner/SKILL.md był identyczny bajtowo, więc przewaga artefaktu jest na poziomie procesu (repo cache + ff-only pull, chmod +x na scripts, detekcja update-vs-install, --all z self-skip i pełny przepływ branch→PR push) plus tabela `list` parsowana z frontmatter, której baseline nie produkuje. Nie mogłem przetestować `push` (wymaga gh + dostępu do zapisu do repozytorium, którego nie posiadam). Brak security smells; script używa tylko $HOME/env vars, brak curl|sh lub obsługi secret, a SKILL.md ostrzega przed commitowaniem secrets. Główne utrudnienie: domyślny cel to ~/clawd/skills, a nie ~/.claude/skills, więc użytkownik Claude Code musi ustawić CLAWD_SKILLS_DIR.

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

Instalacja

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

Komendy i przykładowe prompty

/skill-syncCLI do listowania, instalowania, aktualizowania i PR-push umiejętności Claude wobec repozytorium GitHub jako źródła prawdy

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →