Skill Sync
A VS Code extension to download and keep updated Claude skills from Git repositories.
Features
- Multiple repository sources — Configure any number of Git repositories (GitLab, GitHub, etc.) as skill sources
- Skill selection — Browse discovered skills and select which ones to sync into your project
- Automatic sync — Selected skills are copied into
.claude/skills/; deselected ones are removed
- Pull latest — Update all repositories with one command to get the latest skill versions
Setup
- Install the extension
- Run Skill Sync: Add Repository from the Command Palette
- Enter the repository details (name, URL, branch, skills path)
- Run Skill Sync: Select Skills to pick which skills to include
Commands
| Command |
Description |
Skill Sync: Add Repository |
Add a new Git repository as a skill source |
Skill Sync: Remove Repository |
Remove a configured repository |
Skill Sync: Select Skills |
Browse and select/deselect skills to sync |
Skill Sync: Sync Now |
Force re-sync of currently selected skills |
Skill Sync: Update Repositories |
Pull latest from all configured repos |
Configuration
In your workspace settings (.vscode/settings.json):
{
"skillSync.repositories": [
{
"name": "internal-skills",
"url": "git@gitlab.internal.com:team/claude-skills.git",
"branch": "main",
"skillsPath": "skills"
}
],
"skillSync.cacheDir": ""
}
Repository fields
| Field |
Required |
Default |
Description |
name |
Yes |
— |
Friendly name for the repository |
url |
Yes |
— |
Git clone URL (HTTPS or SSH) |
branch |
No |
main |
Branch to checkout |
skillsPath |
No |
"" (root) |
Subdirectory containing skills |
Skill detection
A skill is any directory containing a SKILL.md file. The extension scans recursively within the configured skillsPath.
Optional YAML frontmatter in SKILL.md:
---
name: my-skill
description: Does something useful
---
# Skill content...
How it works
- Repositories are cloned/cached in
~/.skill-sync/repos/ (configurable via skillSync.cacheDir)
- Selected skills are tracked in
.vscode/skill-sync.json
- On sync, selected skill directories are copied to
.claude/skills/<skill-name>/
- A
.skill-sync-map.json in the skills directory tracks which directories were created by the extension
Requirements
- Git must be installed and available in your PATH
| |
