https://github.com/yurakawa/mskills
mskills is a CLI tool to manage "Agent Skills" for various AI agents.
https://github.com/yurakawa/mskills
agent-skill agent-skills ai-agents cli
Last synced: 5 months ago
JSON representation
mskills is a CLI tool to manage "Agent Skills" for various AI agents.
- Host: GitHub
- URL: https://github.com/yurakawa/mskills
- Owner: yurakawa
- License: mit
- Created: 2026-01-10T19:18:39.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-31T13:59:33.000Z (5 months ago)
- Last Synced: 2026-02-01T01:25:59.972Z (5 months ago)
- Topics: agent-skill, agent-skills, ai-agents, cli
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/mskills
- Size: 200 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# mskills
**mskills** is a CLI tool to manage "Agent Skills" for various AI agents (Claude, Codex, Gemini, Copilot) in a centralized way.
## Installation
### From npm (Recommended)
```bash
npm install -g mskills
```
### From Source
```bash
git clone https://github.com/yurakawa/mskills.git
cd mskills
npm install
npm run build
npm link
```
## Usage
### 1. Add a Skill
Register a skill directory to mskills.
```bash
mskills add
```
**Example:**
```bash
mskills add hello-world ./demo-skill
```
### 2. Enable Agents
Select which agents you want to apply the skills to.
```bash
mskills agents add
```
> [!TIP]
> See [Supported Agents](#supported-agents) for the list of available agent names (e.g., `claude`, `cursor`, `github-copilot-cli`).
**Example:**
```bash
# Enable for Claude and GitHub Copilot
mskills agents add claude github-copilot-cli
```
### 3. Apply Skills
Sync your configured skills to the enabled agents' configuration directories.
```bash
mskills apply
```
This will create symbolic links (default) or copies of your skills in the agent's skills directory (e.g., `~/.claude/skills/hello-world`).
### Commands
| Command | Description |
| :--- | :--- |
| `mskills add ` | Register a skill. |
| `mskills remove ` | Remove registered skills. |
| `mskills list` | List registered skills. |
| `mskills agents add ` | Enable target agents. |
| `mskills agents remove ` | Disable target agents. |
| `mskills agents list` | List enabled agents. |
| `mskills apply` | Apply skills to enabled agents. |
| `mskills apply --force` | Force overwrite existing skills. |
## Configuration
**mskills** stores its configuration and data in the following directory:
- **Config File**: `~/.mskills/config.json`
- **Internal Skills Cache**: `~/.mskills/skills` (used for internal management)
## Supported Agents
| Agent | CLI Name | Skills Directory |
| :--- | :--- | :--- |
| **Claude** | `claude` | `~/.claude/skills` |
| **Cursor** | `cursor` | `~/.cursor/skills` |
| **Codex** | `codex` | `~/.codex/skills` |
| **Gemini** | `gemini` | `~/.gemini/skills` |
| **GitHub Copilot CLI** | `github-copilot-cli` | `~/.copilot/skills` |
## Demo
A demo skill is included in `demo-skill/`.
```bash
# 1. Add the demo skill
mskills add demo ./demo-skill
# 2. Enable an agent (e.g., Claude)
mskills agents add claude
# 3. Apply
mskills apply
# 4. Check result
ls -l ~/.claude/skills/demo
```