SkillsHub

📖 项目简介

SkillsHub 是一个专为 AI Agent 开发者设计的技能管理工具。它可以自动扫描和管理多个 AI Agent（Claude Code、Codex、Gemini 等）的技能文件，提供直观的界面来浏览、编辑和组织这些技能。

核心功能

• 🔍 智能扫描 - 自动扫描系统中的技能目录（~/.claude/skills/, ~/.kimi/skills/, ~/.gemini/skills/）
• 📊 状态检测 - 智能识别技能状态（Active、Modified、Error）
• ✏️ 在线编辑 - 内置编辑器，支持 Markdown 语法高亮
• 🌲 文件浏览 - 树形结构浏览技能文件
• 🔄 技能导入 - 支持从 URL、GitHub 等多种来源导入技能
• 🌍 国际化 - 支持中文和英文界面切换
• 🎨 现代 UI - 基于 Tailwind CSS 的简洁美观界面

🚀 技术栈

前端

• React 18 - 用户界面框架
• TypeScript - 类型安全的 JavaScript
• Tailwind CSS - 实用优先的 CSS 框架
• shadcn/ui - 高质量的 React 组件库
• react-i18next - 国际化支持
• Vite - 快速的构建工具

后端

• Rust - 高性能系统编程语言
• Tauri 2.x - 轻量级桌面应用框架
• SQLite - 嵌入式数据库
• rusqlite - Rust 的 SQLite 绑定

📦 安装和运行

前置要求

• Node.js 18+
• Rust 1.70+
• npm 或 pnpm

开发环境

1. 克隆仓库

git clone https://github.com/Caho1/SkillsHub.git
cd SkillsHub

2. 安装依赖

npm install

3. 运行开发服务器

npm run tauri dev

生产构建

npm run tauri build

构建完成后，可执行文件将位于 src-tauri/target/release/ 目录。

📁 项目结构

SkillsHub/
├── src/                      # 前端源代码
│   ├── components/           # React 组件
│   │   ├── ui/              # UI 基础组件
│   │   ├── Navbar.tsx       # 导航栏
│   │   ├── Sidebar.tsx      # 侧边栏
│   │   ├── StatsPanel.tsx   # 统计面板
│   │   ├── SkillCard.tsx    # 技能卡片
│   │   └── ...
│   ├── hooks/               # React Hooks
│   ├── lib/                 # 工具库
│   │   ├── i18n.ts         # 国际化配置
│   │   └── tauri.ts        # Tauri API 封装
│   ├── pages/              # 页面组件
│   ├── types/              # TypeScript 类型定义
│   └── App.tsx             # 主应用组件
│
├── src-tauri/              # Tauri 后端代码
│   ├── src/
│   │   ├── commands/       # Tauri Commands
│   │   ├── db/            # 数据库模块
│   │   ├── models/        # 数据模型
│   │   ├── services/      # 业务逻辑
│   │   └── main.rs        # 主入口
│   └── Cargo.toml         # Rust 依赖配置
│
└── package.json           # Node.js 依赖配置

🎯 功能详解

状态检测

SkillsHub 会自动检测技能文件的状态：

• Active（活跃） - 文件正常，没有被修改
• Modified（已修改） - 文件在上次扫描后被修改
• Error（错误） - 文件存在问题：
  • SKILL.md 文件不存在
  • 文件为空
  • 缺少 YAML frontmatter

YAML Frontmatter 验证

技能文件必须包含有效的 YAML frontmatter：

---
name: skill-name
description: Skill description
---

# Skill Content
...

多 Agent 支持

支持管理多个 AI Agent 的技能：

• Claude - Claude Code 技能
• Codex - Codex/Kimi 技能
• Gemini - Gemini 技能
• Custom - 自定义技能

🛠️ 开发指南

添加新的 Tauri Command

1. 在 src-tauri/src/commands/ 中创建新的命令文件
2. 在 src-tauri/src/main.rs 中注册命令
3. 在 src/lib/tauri.ts 中添加前端调用接口

添加新的数据库表

1. 修改 src-tauri/src/db/mod.rs 中的 init_schema() 方法
2. 添加相应的查询和插入方法
3. 更新数据模型

🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• Tauri - 优秀的桌面应用框架
• shadcn/ui - 精美的 React 组件库
• Lucide Icons - 简洁的图标库

📮 联系方式

如有问题或建议，请通过以下方式联系：

• GitHub Issues: https://github.com/Caho1/SkillsHub/issues
• GitHub: @Caho1

---