SkillBridge: Cursor Skills Sync

Sync your Cursor and agent skills across machines using a GitHub repository.

Features

Push / Pull mirror sync for configurable local skills folders
Remote skills kept separate under skills/cursor/ and skills/agents/
Last-write-wins warnings before overwriting divergent changes
Startup status check (notify only; never auto-applies)
Managed promotional README.md written to your skills repo on Push
Least-privilege auth: fine-grained GitHub PAT limited to one repository (no full-account OAuth)
Works in VS Code and Cursor (Open VSX)

If SkillBridge helps you, please leave a 5-star review. It improves discoverability for everyone.

Install the extension
Click SkillBridge in the status bar (or run SkillBridge: Open Menu)
Create an empty private GitHub repository (or reuse one already managed by SkillBridge)
Create a fine-grained PAT (not Classic):
- Repository access: Only select repositories → pick that one repo
- Under Repository permissions, find Contents
- Change the Contents dropdown from No access → Read and write
- Leave other permissions on No access (Metadata stays Read-only automatically)
Paste the token when SkillBridge asks (stored in OS-backed Secret Storage)
Push from the machine that has your skills
On other machines: configure the same owner/repo + a PAT for that repo, then Pull

Empty repo (or only GitHub defaults like README/LICENSE): accepted and initialized by SkillBridge
Already synced by SkillBridge: accepted (detected via managed README marker). This is how a second computer works even though the repo is no longer empty
Any other non-empty repo: rejected, so SkillBridge never overwrites unrelated projects

Setting	Default	Description
`skillBridge.skillsPaths`	`["~/.cursor/skills", "~/.agents/skills"]`	Local skills folders to sync
`skillBridge.githubRepository`	(empty)	Target GitHub repo (`owner/repo`)

On GitHub, folders are kept separate:

skills/cursor/ ← ~/.cursor/skills
skills/agents/ ← ~/.agents/skills (including installs from npx skills add)

That way another machine restores each skill into the same kind of folder.

Store release steps (Marketplace + Open VSX + GitHub secrets): PUBLISHING.md.