Skills Management

Skills Management CLI (skm)

[简体中文](./README.zh-CN.md) | English

`skm` is a powerful CLI tool designed to manage and synchronize "skills" (prompt libraries, instruction sets, or capability modules) across various AI coding agents and projects. It serves as a central hub to add skills from GitHub or local directories and selectively link them into your local AI project configurations.

It supports multiple AI environments including **OpenCode**, **Cursor**, **Gemini**, **Antigravity**, **Claude**, and **GitHub** projects.

---

🚀 Features

• Global Skill Repository: Centralized management of your AI skills.
• GitHub Integration: Add skills directly from GitHub repositories or specific subdirectories (sparse checkout).
• Local Skill Support: Add skills from local directories for development and debugging.
• Version Control: Check for updates and synchronize changes from remote repositories.
• Project Detection: Automatically detects the AI project type in your current directory.
• Symbolic Linking: Efficiently links skills to projects without duplication, keeping them in sync.
• Project Isolation: Manage different sets of skills for different projects.


💡 Why skm?

• Centralized Efficiency: Skills are cloned only once (~/.skills-management/repo) and shared across infinite projects via symbolic links. This saves significant disk space and ensures all your projects use the same curated version of a skill.
• Precision (Sparse Checkout): Only download what you need. If a GitHub repository contains hundreds of skills but you only want one, skm uses Git's sparse-checkout to download only that specific subdirectory. No more cloning massive repositories for a single prompt file.
• Automatic Environment Awareness: You don't need to know where Cursor, Claude, or OpenCode stores their skills. skm automatically detects your project environment and handles the directory structures for you.
• **Clean