skills-manager

English | 中文

Stop manually switching skills and MCPs per project. Let skills-manager organize them into categories and switch with one command.

A Claude Code skill that manages your skills, MCPs, and plugins by categories. Define once, switch anywhere.

⚠️ For Claude Code users only. This skill relies on Claude Code's directory structure (~/.claude/skills/, skillOverrides, enabledPlugins, etc.) and will not work with other AI coding tools.

Tested on Claude Code CLI. Should work with Desktop/Web/IDE versions since they share the same directory structure, but not yet verified.

Why skills-manager?

The problem: You have multiple skills, MCPs, and plugins. Different projects need different tools. Managing them manually is tedious and error-prone. Worse, MCPs in ~/.claude.json are "global leaks" — they're active in ALL projects, no way to control per-project.

The solution: Organize tools into categories (modes). Switch to a category, and only those tools are active for your current project.

/skills-manager switch research    # Only research tools active
/skills-manager switch coding      # Only coding tools active
/skills-manager switch All         # Everything on

Why install at user level?

Skills and plugins are installed at user level (~/.claude/skills/, ~/.claude/plugins/), not per project. This avoids duplicating tools across projects — one installation, shared everywhere.

How switching works

When you switch categories, skills-manager writes project-level config files:

• .mcp.json — MCP configs for this category
• settings.local.json — skill and plugin on/off states
• skills-manager-state.json — records current category, enabled tools, timestamp

Each project stays independent — no interference between projects.

What makes it different?

Installation

Method 1: Clone from GitHub

git clone https://github.com/Xue-Sir/skills-manager.git ~/.claude/skills/skills-manager

Method 2: Manual Download

1. Download the repository as ZIP
2. Extract to ~/.claude/skills/skills-manager/

Requirements

• Python 3.6+ (uses only standard library, no extra packages)
• Claude Code installed
• Windows 10/11, Linux, macOS — all supported

The scan.py script uses only Python standard library modules (json, os, sys, shutil, pathlib, subprocess). No pip install needed.

Quick Start

1. First Use

After installation, start Claude Code and run:

/skills-manager scan

This scans your existing tools, registers them, and migrates any global MCPs (with automatic backup).

2. Try It

/skills-manager list              # See all categories
/skills-manager switch All        # Enable everything
/skills-manager switch None       # Disable everything

3. Create Your Own Category

/skills-manager add-category research
/skills-manager 把 skill-a 加入 research
/skills-manager 把 mcp-x 加入 research
/skills-manager switch research

Or in English:

/skills-manager add-category research
/skills-manager add skill-a to research
/skills-manager add mcp-x to research
/skills-manager switch research

Key Features

• Category-based management — Group tools by project type, workflow, or any criteria
• One-command switch — Change your entire tool set instantly
• Auto scan & sync — Detects new tools automatically
• MCP migration — Moves global MCPs to per-project control (with backup)
• Skill-MCP binding — Associate skills with their required MCPs/plugins
• Natural language — Use Chinese or English, whatever feels natural
• Safe by design — Always backs up before modifying, never overwrites

Commands

Natural Language

You can use natural language (Chinese or English):

Important Notes

MCP Migration

When you run scan, any MCPs in your global ~/.claude.json are moved to skills-manager. This prevents "global leaks" where an MCP is available to ALL projects regardless of category.

A backup is always created before modifying ~/.claude.json.

Files Read

Configuration

Config files are in config/ directory. They're managed by AI based on your environment, but you can edit them manually too.

License

MIT License - see LICENSE file.

skills-manager

别再手动切换每个项目的 skills 和 MCPs 了。让 skills-manager 把它们组织成分类，一键切换。

一个 Claude Code 的 skill，用于管理 skills、MCPs 和 plugins 的分类。定义一次，随处切换。

⚠️ 仅适用于 Claude Code 用户。 此 skill 依赖 Claude Code 的目录结构（~/.claude/skills/、skillOverrides、enabledPlugins 等），不支持其他 AI 编程工具。

已在 Claude Code CLI 上测试。理论上适用于桌面端/Web/IDE版本（共享相同目录结构），但尚未验证。

为什么用 skills-manager？

问题： 你有多个 skills、MCPs、plugins。不同项目需要不同工具。手动管理很麻烦。更糟的是，~/.claude.json 中的 MCP 存在「全局泄漏」——对所有项目生效，无法按项目控制。

解决： 把工具组织成分类（模式）。切换到一个分类，只有那些工具在当前项目中激活。

/skills-manager switch research    # 只有研究工具
/skills-manager switch coding      # 只有编程工具
/skills-manager switch All         # 全部开启

为什么装在用户级？

Skills 和 plugins 安装在用户级（~/.claude/skills/、~/.claude/plugins/），而不是项目级。这样避免了在每个项目中重复安装同一份工具——一次安装，所有项目共享。

切换分类的实现方式

切换分类时，skills-manager 在项目中写入三个配置文件：

• .mcp.json — 当前分类需要的 MCP 配置
• settings.local.json — skill 和 plugin 的 on/off 状态
• skills-manager-state.json — 记录当前分类名称、启用的功能列表、时间戳

每个项目互不干扰。

有什么不同？

安装

方法一：从 GitHub 克隆

git clone https://github.com/Xue-Sir/skills-manager.git ~/.claude/skills/skills-manager

方法二：手动下载

1. 下载仓库 ZIP 文件
2. 解压到 ~/.claude/skills/skills-manager/

环境要求

• Python 3.6+（仅使用标准库，无需额外安装包）
• Claude Code 已安装
• Windows 10/11、Linux、macOS — 全部支持

scan.py 脚本仅使用 Python 标准库模块（json、os、sys、shutil、pathlib、subprocess）。无需 pip install。

快速开始

1. 首次使用

安装后，启动 Claude Code 并运行：

/skills-manager scan

这会扫描你现有的工具，注册它们，并迁移全局 MCPs（自动备份）。

2. 试试看

/skills-manager list              # 查看所有分类
/skills-manager switch All        # 开启所有工具
/skills-manager switch None       # 关闭所有工具

3. 创建自己的分类

/skills-manager add-category research
/skills-manager 把 skill-a 加入 research
/skills-manager 把 mcp-x 加入 research
/skills-manager switch research

核心功能

• 分类管理 — 按项目类型、工作流或任何标准分组工具
• 一键切换 — 立即切换整套工具
• 自动扫描同步 — 自动检测新工具
• MCP 迁移 — 将全局 MCPs 移到项目级控制（自动备份）
• Skill-MCP 绑定 — 自动关联 skill和对应的 MCP/plugin
• 自然语言 — 中英文都行，怎么顺口怎么说
• 安全设计 — 修改前总是备份，从不覆盖

命令

自然语言

你可以用自然语言（中文或英文）：

重要说明

MCP 迁移

运行 scan 时，全局 ~/.claude.json 中的 MCPs 会被移到 skills-manager。这防止了"全局泄漏"——MCP 对所有项目可用，不管分类是什么。

修改 ~/.claude.json 前总是会创建备份。

读取的文件

配置

配置文件在 config/ 目录下。由 AI 根据你的环境管理，你也可以手动编辑。

许可证

MIT 许可证 - 见 LICENSE 文件。