Skip to content

shanliuling/skills-link

Repository files navigation

Skills-Link

Skills-Link Banner

One skills folder, every AI app.

Sync your local skills across 41+ AI coding agents with a single command.

Also supports rules sync: rules-link

npm version License: MIT GitHub stars

English | 中文


How it works

  Claude Code ──┐
  Cursor ───────┤
  Windsurf ─────┤
  Cline ────────┼──▶  ~/AISkills/  ◀──▶  GitHub
  Gemini CLI ───┤        ▲
  Trae ─────────┤        │
  Roo Code ─────┘   Master Directory
                    (single source of truth)

Every app's ~/.xxx/skills becomes a symlink pointing to one master directory. Add or edit a skill once — every app sees it instantly.


Install

npm i -g skills-link

Quick start

skills-link

That's it. First run walks you through everything — detect apps, import skills, create links.

Run it again anytime to sync changes and check health.


Commands

Command Description
skills-link Main command — sync skills to all apps
skills-link add <repo> Install skill from GitHub
skills-link list List local skills
skills-link sync Push changes to GitHub
skills-link app Manage enabled apps
rules-link Sync rules

Install skill from GitHub

# Install all skills from a repo (choose one)
skills-link add vercel-labs/agent-skills

# Install specific skill
skills-link add vercel-labs/agent-skills -s web-design-guidelines

Supported agents

41+ agents out of the box:

AdaL Amp Antigravity Augment
Claude Code Cline CodeBuddy Codex
Command Code Continue Cortex Code Crush
Cursor Droid Gemini CLI GitHub Copilot
Goose iFlow CLI Junie Kilo Code
Kimi Code CLI Kiro CLI Kode MCPJam
Mistral Vibe Mux Neovate OpenClaw
OpenCode OpenHands Pi Pochi
Qoder Qwen Code Replit Roo Code
Trae Trae CN Windsurf Zencoder

Plus a universal fallback for any agent not listed. Add new agents with one line of code.


Cross-device sync

# Machine A — push skills to GitHub
skills-link sync

# Machine B — clone and link
skills-link  # automatically pulls from remote

Config

~/AISkills/config.yaml:

masterDir: ~/AISkills

git:
  enabled: true
  remote: https://github.com/you/skills.git
  autoPush: true

apps:
  - name: Claude Code
    skillsPath: ~/.claude/skills
    enabled: true

Language

skills-link --lang zh     # CLI flag
# or set language: zh in config.yaml

Requirements

  • Node.js 18+
  • Windows / macOS / Linux

Windows uses Junction links — no admin rights needed. macOS / Linux uses native symlinks.


License

MIT


⭐ Star History

If skills-link helped you, give it a star — it helps others find it too!

Star History Chart

About

Sync your local skills across 41+ AI coding agents with a single command.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors