AgentSkills Tools

AgentSkills 项目管理工具集合。

工具选择

本项目提供两种工具来管理 Claude Code Skills，根据你的使用场景选择：

使用场景	推荐工具	说明
桌面日常使用	Tkinter GUI	图形界面更直观易用
SSH 远程连接	addskill CLI	纯命令行，无需图形环境
脚本自动化	addskill CLI	支持命令行参数和管道
CI/CD 集成	addskill CLI	易于在自动化流程中使用
个人偏好	两者都试试	功能完全相同

---

方式一：addskill CLI 工具

纯命令行工具，支持 pip 安装，适合脚本自动化和 SSH 远程使用。

快速开始

# 安装
cd addskill-cli/
pip install -e .

# 使用
addskill pdf docx              # 安装 skills
addskill --uninstall pdf       # 卸载 skills
addskill --list                # 列出所有
addskill                       # 交互模式

功能特性

• 🚀 纯命令行 - 无需图形环境
• ⚡ 混合模式 - 命令行参数 + 交互式菜单
• 📦 标准安装 - pip 包管理
• 🔄 开发模式 - 修改代码立即生效
• 🎯 简洁输出 - 清晰的结果反馈

详细文档

查看 addskill-cli/README.md 获取完整使用说明。

---

方式二：install_project_skills.py（Tkinter GUI）

一个用于管理和安装 Claude Code Skills 的 GUI 工具，支持在项目中安装、更新和卸载 skills。

功能特性

• 🔍 实时搜索 - 快速过滤和定位 skills
• ☑️ 可视化选择 - Checkbox 界面，支持批量操作
• ✓ 状态标记 - 清晰显示已安装的 skills
• ➕ 智能安装 - 自动创建符号链接
• ➖ 便捷卸载 - 取消勾选即可删除
• 📊 统计信息 - 实时显示安装数量和状态

使用方法

基本用法

python install_project_skills.py <项目目录>

示例

# 安装到当前项目
python install_project_skills.py .

# 安装到指定项目
python install_project_skills.py ./my-project

# 使用绝对路径
python install_project_skills.py /Users/username/projects/my-app

界面说明

GUI 布局

┌─────────────────────────────────────────┐
│ 🔍 搜索: [_______________]              │
│ 💡 取消勾选已安装的 Skills 可以删除...  │
├─────────────────────────────────────────┤
│ ☑ skill-creator ✓ 已安装               │
│ ☐ slack-gif-creator                    │
│ ☐ pdf                                  │
│ ☑ docx ✓ 已安装                        │
│ ...                                    │
├─────────────────────────────────────────┤
│ [全选] [全不选] │ [取消] [确定]        │
│ 已选 2 / 共 20 个 (✓ 2 已安装) (+ 0 新增)│
└─────────────────────────────────────────┘

功能按钮

• 全选 - 选中当前所有可见的 skills
• 全不选 - 取消选中所有 skills
• 确定 - 应用更改（安装新选中的，删除被取消的）
• 取消 - 放弃更改，关闭窗口

状态栏

显示实时统计信息：

• 已选 X / 共 Y 个 - 当前选中数量和总数量
• ✓ X 已安装 - 保持已安装状态的数量
• + X 新增 - 新勾选的待安装数量

工作原理

符号链接机制

Skills 通过符号链接安装到项目的 .claude/skills/ 目录：

项目/
└── .claude/
    └── skills/
        ├── pdf -> ~/AgentSkills/document-skills/pdf
        ├── docx -> ~/AgentSkills/document-skills/docx
        └── skill-creator -> ~/AgentSkills/skill-creator

自动更新

由于使用符号链接，当 Skills Hub 中的 skill 更新时，项目中会自动看到最新版本，无需手动更新。

卸载流程

取消勾选已安装的 skill 后，符号链接会被删除，但源 skill 不会被删除。

系统要求

• 操作系统: macOS
• Python: 3.6+
• 依赖: tkinter（Python 标准库，通常预装）

配置

首次配置

1. 复制配置模板：

   cp .env.example .env

2. 编辑 .env 文件：

   # 设置你的 Skills Hub 路径
   SKILLS_HUB=/path/to/your/AgentSkills

   支持的路径格式：

   • 绝对路径：SKILLS_HUB=/Users/username/AgentSkills
   • 相对路径：SKILLS_HUB=../AgentSkills（相对于脚本目录）
   • 波浪号：SKILLS_HUB=~/AgentSkills（自动展开为用户主目录）

配置优先级

1. 环境变量 SKILLS_HUB（最高优先级）
2. .env 文件中的 SKILLS_HUB
3. 如果两者都不存在，会提示配置错误

示例配置

# .env 文件示例
SKILLS_HUB=~/Documents/AgentSkills

或在命令行设置环境变量：

export SKILLS_HUB=~/AgentSkills
python install_project_skills.py .

常见问题

Q: 如何检查已安装的 skills？

ls -la .claude/skills/

Q: 符号链接损坏了怎么办？

工具会自动检测并处理损坏的符号链接。你也可以手动删除：

rm .claude/skills/skill-name

Q: 如何批量安装多个项目的相同 skills？

在每个项目目录中运行工具，选择相同的 skills 即可。

Q: 可以在不同位置使用不同的 Skills Hub 吗？

可以。通过以下方式之一：

1. 在不同的目录使用不同的 .env 文件
2. 使用环境变量 export SKILLS_HUB=/path/to/hub
3. 复制工具脚本并在对应的 .env 中配置不同的路径

开发

项目结构

tools/
├── install_project_skills.py  # 主工具脚本
├── README.md                   # 本文档
├── CLAUDE.md                   # Claude Code 指南
└── test-pro/                   # 测试项目目录

贡献

欢迎提交问题和改进建议！

许可证

与 AgentSkills 项目相同。