skill-sync — Claude Code skill: sync and install skills
skill-sync is a Claude Code skill that keeps local skills in sync with a shared GitHub repository by listing skills, installing updates, and submitting local changes through pull requests.
MIT ★ 239 updated 2026-08-30
npx skills add jdrhyne/agent-skills --skill skill-sync -a claude-codeWhat skill-sync does
skill-sync keeps local skills tied to a GitHub repository treated as the canonical source. Run skill-sync list to see what is available. Use skill-sync install <skill-name> for one skill, or skill-sync install --all to install or refresh every skill from the repository.
skill-sync update refreshes the local repository copy without installing skills. To send a local change, skill-sync push <skill-name> creates a branch and pull request using the gh CLI, so gh is needed for that action. The repository clone defaults to ~/.agent-skills-repo; local skills go to ~/clawd/skills, or to the directory set by $CLAWD_SKILLS_DIR. Keep keys and tokens out of SKILL.md and scripts.
What it helps with
- see which skills the shared repository provides
- install or refresh one skill locally
- refresh the repository copy without installing skills
- send a local skill change through a pull request
Example prompts for the agent
- Show me the skills available in the shared repository.
- Install or update
skill-namefrom the repository. - Send my local changes to
skill-namethrough a pull request.
How to install skill-sync
1Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill skill-sync -a claude-code2Manually: put the files in place
~/.claude/skills/skill-sync/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-sync/
1Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill skill-sync -a codex2Manually: put the files in place
.agents/skills/skill-sync/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill skill-sync -a cursor2Manually: put the files in place
.cursor/skills/skill-sync/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jdrhyne/agent-skills clawdbot/skill-sync/SKILL.md2Manually: put the files in place
.github/skills/skill-sync/SKILL.md1Skills CLI (Vercel)
npx skills add jdrhyne/agent-skills --skill skill-sync -a gemini-cli2Platform CLI
gemini skills install https://github.com/jdrhyne/agent-skills --path clawdbot/skill-syncManually: put the files in place
.devin/skills/skill-sync/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-sync
How do I install skill-sync in Claude Code?
Run npx skills add jdrhyne/agent-skills --skill skill-sync -a claude-code. The skill file is at ~/.claude/skills/skill-sync/SKILL.md.
What does skill-sync do?
It lists skills in a shared GitHub repository, installs or updates them locally, and can send local changes through a pull request.
What does skill-sync need to push a change?
skill-sync push <skill-name> creates a branch and pull request with the gh CLI, so gh is required for that action.
Source text
SKILL.md · MIT
--- name: skill-sync description: Sync skills between local installation and the GitHub source-of-truth repository. Use when asked to install, update, list, or push skills. --- # Skill Sync Manage skills from the shared GitHub repository with GitHub as canonical source of truth. > Never commit secrets. Keep keys/tokens out of SKILL.md and scripts. ## Quick Reference ```bash # List available skills in the repo skill-sync list # Install one skill skill-sync install <skill-name> # Install/update all skills from repo skill-sync install --all # Push a local skill update to repo via PR skill-sync push <skill-name> # Refresh local repo cache skill-sync update ``` ## Commands ### `skill-sync list` Shows all skills available in the remote repository. ### `skill-sync install <name>` Installs/updates a skill from repo into local skills directory. ### `skill-sync install --all` Installs/updates all skills from repo. ### `skill-sync push <name>` Pushes local skill changes via branch + PR (`gh` CLI). ### `skill-sync update` Pulls latest repo changes without installing. ## Configuration Default paths: - Repo clone: `~/.agent-skills-repo` - Local skills: `~/clawd/skills` (or `$CLAWD_SKILLS_DIR`) - Remote: `https://github.com/jdrhyne/agent-skills.git`
© jdrhyne · MIT · jdrhyne/agent-skills