Skill Link is a local-first desktop app for keeping AI agent skills in one central library, then linking them into the tools and projects where you actually use them.

English | 中文文档

Acknowledgments

Skill Link is a hard fork of skills-manage by iamzhihuix, a fantastic cross-platform Skills manager. This project extends the original with additional features, different design choices, and ongoing development in its own direction.

Disclaimer

Skill Link is an independent, unofficial desktop application for managing local skill directories and importing public skill metadata. It is not affiliated with, endorsed by, or sponsored by Anthropic, OpenAI, GitHub, MiniMax, or any other supported platform, publisher, or trademark owner.

AI coding tools now share a simple pattern: a skill is a folder with a SKILL.md file and optional supporting files. The problem is that every tool puts those folders somewhere different.

Skill Link treats ~/.agents/skills/ as the canonical source of truth. From there, it can symlink or copy skills into Claude Code, Codex CLI, Cursor, OpenCode, Gemini CLI, Kiro, Windsurf, Lobster-family tools, custom platforms, and project-local skill folders.

• Build one central skill library under ~/.agents/skills/.
• Install or uninstall skills across supported platforms with platform icon toggles.
• Install central skills into project-local skill directories or any custom target path.
• Import skills from GitHub repositories, official directories, skill.sh, or local project scans.
• Track GitHub-backed skills, check for updates, and apply one-click updates with backups.
• Link existing local skills back to a GitHub source for future update checks.
• Browse every file inside a skill, not only SKILL.md.
• Organize reusable sets of skills as collections and batch-install them.
• Keep metadata, settings, collections, and scan results in a local SQLite database.

Recent work has moved Skill Link from a basic cross-platform installer into a fuller skill lifecycle tool:

• 0.2.0 release - custom Git markets, generic Git repository imports, clearer skill update UI, dynamic-link indicators, and a Central card layout fix for the AI Assistant platform group.
• Project installs - central skills can now be linked into a selected project using each platform's project skill directory convention.
• Custom path installs - a skill can be linked or copied into an arbitrary target directory when a tool is not built in yet.
• GitHub update flow - imported skills remember source repo, source path, branch/ref, and installed commit, so Skill Link can compare against the latest upstream commit.
• One-click updates - updateable skills are refreshed from their source with validation, local backups, and rollback behavior if activation fails.
• Link local skill to GitHub - older or manually created skills can be connected to a GitHub source without re-importing.
• Safer central deletion - central skill removal also cleans tracked installs while avoiding untracked real directories.
• Cleaner detail view - metadata is collapsible, GitHub source information is more prominent, and duplicate/read-only sources are easier to compare.

• Latest release: https://github.com/EndlessGr1ef/skill-link/releases/latest
• Current version: 0.2.0
• Current prebuilt packages: Apple Silicon macOS (.dmg and .app.zip)
• Other platforms: run from source for now

The current public macOS build is not notarized. If macOS shows a warning such as:

• "Skill Link" is damaged and can't be opened
• "Skill Link" cannot be opened because Apple could not verify it

the app is usually not corrupted; it is being blocked by Gatekeeper quarantine on an unsigned build.

After moving the app to /Applications, run:

xattr -dr com.apple.quarantine "/Applications/Skill Link.app"

Then launch the app again from Finder. If your app is stored somewhere else, replace the path with the actual .app path.

Custom platforms can be added through Settings.

Note: Claude Code can also surface Find Skill plugin directories under ~/.claude/plugins/marketplaces/* as read-only rows in the Claude view. Those entries are display-only and are not managed like native skills in ~/.claude/skills/.

• Local-first storage - metadata, collections, scan results, settings, update cache, and AI explanations stay in ~/.skill-link/db.sqlite or in the local skill directories you manage.
• No telemetry - the app does not include analytics, crash reporting, or usage tracking.
• Feature-driven network access - outbound requests happen when you use Find Skill sync/download, skill.sh search/install, GitHub import/update checks, or AI explanation generation.
• Local credentials - GitHub PAT and AI API keys are stored in the local SQLite settings table and are not encrypted at rest by the app.
• Update backups - GitHub skill updates create local backups under ~/.skill-link/backups.

Never post real secrets in issues, pull requests, screenshots, or logs.

• Node.js 20 or newer
• pnpm 10.12.3 or newer
• Rust toolchain stable
• Tauri v2 system dependencies: https://v2.tauri.app/start/prerequisites/

pnpm install

pnpm dev

The frontend-only Vite server runs on port 24200.

For the full desktop app:

pnpm tauri dev

pnpm tauri dev already starts Vite through src-tauri/tauri.conf.json, so do not start a second Vite server.

Frontend CI order:

pnpm typecheck
pnpm lint
pnpm test

Backend CI order:

cd src-tauri
cargo fmt --check
cargo clippy -- -D warnings
cargo test

Focused examples:

pnpm test -- src/test/skillStore.test.ts
cd src-tauri && cargo test db::

skill-link/
├── src/                        # React frontend
│   ├── components/             # UI components
│   ├── data/                   # Built-in marketplace and provider data
│   ├── i18n/                   # Locale files and i18n setup
│   ├── lib/                    # Frontend helpers
│   ├── pages/                  # Route views
│   ├── stores/                 # Zustand stores and Tauri IPC boundaries
│   ├── test/                   # Vitest + RTL tests
│   └── types/                  # Shared TypeScript types
├── src-tauri/                  # Rust backend
│   └── src/
│       ├── commands/           # Tauri IPC handlers by domain
│       ├── db.rs               # SQLite schema, migrations, queries
│       ├── lib.rs              # Tauri setup and command registration
│       └── main.rs             # Desktop entry point
├── images/                     # README screenshots
├── public/                     # Static assets
├── CHANGELOG.md                # English changelog
├── CHANGELOG.zh.md             # Chinese changelog
└── release-notes/              # GitHub release notes

Skill Link initializes SQLite automatically at:

~/.skill-link/db.sqlite

The central skill source remains:

~/.agents/skills/

• English: CHANGELOG.md
• Chinese: CHANGELOG.zh.md

See CONTRIBUTING.md for development setup, validation commands, and pull request expectations.

See SECURITY.md for vulnerability reporting and data-handling notes.

This project is licensed under the Apache License 2.0. See LICENSE.