skills-link

# Skills-Link **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` [](https://badge.fury.io/js/skills-link) [](https://opensource.org/licenses/MIT) [](https://github.com/shanliuling/skills-link) English | [中文](https://github.com/shanliuling/skills-link/blob/main/README.zh.md)

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

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:

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!