Skip to content

qCanoe/skills-manager

Repository files navigation

Skills Manager

基于 Tauri + React 的轻量Windows桌面托盘应用,集中管理多个 AI Agent 工具的 SKILL.md 文件。

支持 Cursor、Codex、Claude Code、Windsurf、Amp 等工具的 skills 目录,统一扫描、浏览、编辑与跨来源复制。

主界面 复制功能

功能特性

  • 多来源聚合 — 同时扫描 ~/.cursor/skills~/.codex/skills~/.claude/skills~/.agents/skills、Windsurf、Amp 等目录
  • 搜索筛选 — 按名称、描述、来源、路径和正文检索;支持仅显示可编辑来源
  • 预览与编辑 — 查看完整 SKILL.md 原文、附件列表;直接新建或编辑 skill
  • 跨来源复制 — 复制单个 skill 或整个来源,支持 rename / overwrite / skip 冲突策略
  • 文件夹(Collections) — 本机虚拟文件夹,通过引用组织 skill,不复制磁盘文件
  • 自定义来源 — 手动添加目录或使用系统对话框选择;支持导入/导出 JSON 配置
  • 系统托盘 — 关闭窗口后驻留托盘,支持快速显示/隐藏、重新扫描、退出

快速开始

前置要求

安装与运行

npm install
npm run tauri dev

Important

npm run dev 仅启动浏览器预览,文件扫描、保存等功能需通过 npm run tauri dev 启动 Tauri 运行时。

构建

npm run tauri build

构建产物位于 src-tauri/target/release/,包含便携版 exe、NSIS 安装包和 MSI 安装包。

常用命令

命令 说明
npm run tauri dev 启动桌面开发环境
npm run tauri build 构建并打包桌面应用
npm run dev 仅启动 Vite 浏览器预览
npm run build 构建前端资源
npm run lint 运行 ESLint
npm run test 运行测试

Skill 目录结构

my-skill/
├─ SKILL.md
└─ notes.md        # 可选附件

支持带命名空间的层级:

.system/tools/my-skill/
├─ SKILL.md
└─ examples.md

SKILL.md 推荐使用 frontmatter 声明元数据:

---
name: my-skill
description: 描述该 skill 的用途
---

# My Skill

## Instructions
描述 agent 如何使用此 skill。

技术栈

  • 前端:React 19 · TypeScript 5.9 · Vite 8
  • 桌面:Tauri 2
  • 后端:Rust 2021

开发说明

项目结构

根目录保留 Vite 约定的 index.html、npm 的 package.json,以及 TypeScript 的解决方案入口 tsconfig.json(通过 references 指向 config/ 内的子配置)。具体工具配置均在 config/ 目录。

目录 职责
config/ Vite / Vitest / ESLint / TypeScript 工程配置(除根级 tsconfig.json 解决方案入口)
src/ 前端界面、来源管理、搜索筛选、预览与编辑
src/lib/ Skill 元数据解析、来源持久化、UI 状态
src-tauri/src/ 文件扫描、写入、目录复制、托盘与窗口管理
public/ 静态资源(构建时原样复制)
assets/readme/ README 截图等文档用资源
.cursor/rules/ Cursor 规则(原 .cursorrules 内容迁移至此)

版本号同步

发布时需同步以下三处版本:package.jsonsrc-tauri/tauri.conf.jsonsrc-tauri/Cargo.toml

CI

推送或 PR 时 GitHub Actions 会运行前端 lint / test / build 和 Rust clippy / test。详见 .github/workflows/ci.yml

Roadmap

  • 原生目录选择器
  • 本机文件夹(Collections)
  • 导入 / 导出配置
  • Skill 模板库
  • 热门 skill 推荐
  • Find Skill 内嵌搜索与安装

About

Skills Manager 是一个基于 Tauri 构建的Windows轻量托盘应用,用于集中管理本地 AI agent skills。

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors