使用说明

🚀 wskill

Windsurf Skill Manager

一个用于搜索和管理 Windsurf 技能 的命令行工具
安装后通过 wskill 命令快速搜索相关技能供 Windsurf/Cascade 使用

功能特性

功能	描述	命令
📋 列出技能	查看所有可用的 Windsurf 技能	`wskill list`
📁 分类浏览	按类别（云服务、前端、AI等）分组查看	`wskill list -c`
🔍 关键词搜索	支持中英文关键词搜索技能	`wskill search <关键词>`
📖 详情查看	查看技能完整信息和使用说明	`wskill show <技能名>`
🔥 热门发现	查看 skills.sh 热门在线技能	`wskill trending`
⬇️ 一键安装	安装热门在线技能	`wskill install <技能>`
🌐 打开网站	打开 skills.sh 发现更多技能	`wskill web`

安装方法

pip install wskill

安装后可获得：

CLI工具: wskill 命令行工具
MCP服务器: wskill-mcp 用于 Windsurf 集成

🎯 选择适合你的使用方式

使用场景	推荐方式	说明
命令行快速搜索	CLI	直接在终端使用 `wskill search` 搜索技能
Windsurf 深度集成	MCP	在 Cascade 对话中直接调用技能搜索和安装
两者结合	CLI + MCP	终端和IDE双重体验

CLI 用户（命令行爱好者）

安装后直接使用：

wskill list           # 列出本地技能
wskill search react   # 搜索技能
wskill trending       # 查看热门技能
wskill install react  # 安装技能

MCP 用户（Windsurf 深度用户）

配置 MCP 后，在 Cascade 中直接对话：

👤 帮我搜索数据可视化相关的技能
👤 安装 frontend-design 技能
👤 显示热门技能排行榜

详见下方 MCP 服务器集成部分。

其他安装方式

从 GitHub 安装

git clone https://github.com/1837620622/wskill.git
cd wskill
pip install -e .

手动安装（macOS/Linux/Windows）

macOS / Linux:

cd /path/to/wskill
pip install -e .

Windows:

cd C:\path\to\wskill
pip install -e .

验证安装

wskill --version
# 输出: wskill 1.0.0

使用方法

列出所有技能

wskill list

📸 输出示例

Windsurf Skills (25 个技能)
==================================================

1. analytics-metrics v1.0.0
   构建数据可视化和分析仪表盘。适用于创建图表、KPI展示...
   关键词: analytics, dashboard, charts, metrics, KPI

2. kaggle-competition v2.0.0
   制作Kaggle机器学习比赛的完整解决方案...
   关键词: Kaggle, competition, 比赛, notebook, ipynb

3. ui-ux-pro-max v1.0.0
   专业的 UI/UX 设计智能技能...
   关键词: UI design, UX, frontend design, color scheme
...

按类别浏览

wskill list -c

📸 输出示例

Windsurf Skills 分类列表
==================================================

📁 云服务与部署 (6)
   • aws-account-management
   • aws-agentcore
   • aws-strands
   • cloudflare
   • railway
   • vercel

📁 数据与可视化 (2)
   • analytics-metrics
   • mermaid-diagrams

📁 AI与机器学习 (5)
   • kaggle-competition
   • langchain
   • fal-ai
   • copilot-docs
   • nano-banana-pro

📁 前端与UI/UX (4)
   • figma
   • mobile-responsiveness
   • ui-ux-pro-max
   • web-accessibility

📁 数据库 (1)
   • mongodb

📁 文档处理 (2)
   • docx
   • xlsx

📁 开发工具 (2)
   • bun
   • github-trending

搜索技能

# 搜索英文关键词
wskill search kaggle

# 搜索中文关键词
wskill search 仪表盘

# 搜索技术栈
wskill search dashboard

📸 输出示例

$ wskill search kaggle

搜索 'kaggle' 找到 1 个技能:
==================================================

1. kaggle-competition v2.0.0
   制作Kaggle机器学习比赛的完整解决方案。适用于创建比赛notebook、
   数据分析、特征工程、模型训练和提交文件生成...
   关键词: Kaggle, competition, 比赛, notebook, ipynb (+3)

查看技能详情

wskill show ui-ux-pro-max

发现热门在线技能

# 查看 skills.sh 热门技能排行
wskill trending

# 安装热门技能（需要 Node.js）
wskill install react

# 打开 skills.sh 网站
wskill web

📸 热门技能输出示例

🔥 热门 Agent Skills (来自 skills.sh)
=======================================================

1. vercel-react-best-practices ⬇ 23.5K by Vercel
   40+ 条 React/Next.js 优化规则
   仓库: vercel-labs/agent-skills

2. web-design-guidelines ⬇ 17.9K by Vercel
   100+ 条 UI/UX 审查规则
   仓库: vercel-labs/agent-skills

3. remotion-best-practices ⬇ 1.1K by Remotion
   Remotion 视频制作最佳实践
   仓库: remotion-dev/remotion
...

📸 输出示例

============================================================
  ui-ux-pro-max
============================================================

版本: 1.0.0
作者: UI/UX Pro Max
路径: /Users/xxx/.codeium/windsurf/skills/ui-ux-pro-max

描述:
  专业的 UI/UX 设计智能技能。适用于前端界面设计、配色方案选择、
  字体搭配、图表选型、Landing Page 和 Dashboard 设计...

关键词:
  UI design, UX, frontend design, color scheme, typography,
  dashboard, landing page, glassmorphism, dark mode, responsive

内容预览:
  ---
  name: ui-ux-pro-max
  description: "专业的 UI/UX 设计智能技能..."
  ...

命令参考

本地技能管理

命令	别名	描述	示例
`list`	`ls`, `l`	列出所有技能	`wskill list`
`list -c`	`list --category`	按类别分组显示	`wskill list -c`
`search`	`s`, `find`	搜索技能	`wskill search kaggle`
`show`	`info`, `i`	显示技能详情	`wskill show ui-ux-pro-max`
`path`	-	显示技能目录路径	`wskill path`

在线技能发现 (skills.sh)

命令	别名	描述	示例
`trending`	`hot`, `t`	查看热门在线技能	`wskill trending`
`install`	`add`, `get`	安装在线技能	`wskill install react`
`web`	`open`	打开 skills.sh 网站	`wskill web`

通用选项

命令	别名	描述	示例
`--help`	`-h`	显示帮助信息	`wskill --help`
`--version`	`-v`	显示版本号	`wskill --version`

📂 技能目录结构

技能存储在 ~/.codeium/windsurf/skills/ 目录下：

~/.codeium/windsurf/skills/
├── analytics-metrics/
│   └── SKILL.md
├── kaggle-competition/
│   └── SKILL.md
├── ui-ux-pro-max/
│   ├── SKILL.md
│   ├── data/
│   │   ├── colors.csv
│   │   ├── typography.csv
│   │   └── ...
│   └── scripts/
│       ├── core.py
│       └── search.py
└── ...

🔗 在 Windsurf 中使用

搜索到合适的技能后，在 Windsurf 对话中提及技能关键词，Cascade 会自动调用相应技能：

👤 用户: 帮我创建一个Kaggle比赛的Notebook
🤖 Cascade: [自动调用 kaggle-competition 技能]

👤 用户: 设计一个现代化的Dashboard界面
🤖 Cascade: [自动调用 ui-ux-pro-max 技能]

👤 用户: 帮我画一个流程图
🤖 Cascade: [自动调用 mermaid-diagrams 技能]

➕ 添加自定义技能

在技能目录创建新文件夹：

mkdir ~/.codeium/windsurf/skills/my-skill

创建 SKILL.md 文件：

---
name: my-skill
description: "技能描述。触发关键词：keyword1, keyword2, 中文关键词。"
author: YourName
version: 1.0.0
---

# 技能标题

## 概述
技能内容...

## 使用方法
...

验证技能是否加载：
```
wskill search my-skill
```

📋 依赖

包名	版本	用途
Python	≥ 3.10	运行环境（MCP需要）
PyYAML	≥ 6.0	解析 SKILL.md frontmatter
mcp	≥ 1.0.0	MCP服务器框架

🔌 MCP 服务器集成

wskill 提供 MCP（Model Context Protocol）服务器，可直接在 Windsurf 中调用技能搜索功能。

配置 Windsurf MCP

第一步：安装 wskill

pip install wskill

第二步：配置 MCP

找到 Windsurf MCP 配置文件：
- macOS/Linux: ~/.codeium/windsurf/mcp_config.json
- Windows: %APPDATA%\Codeium\windsurf\mcp_config.json
在 mcpServers 中添加 wskill 配置：

{
  "mcpServers": {
    "wskill": {
      "command": "wskill-mcp",
      "args": [],
      "disabled": false
    }
  }
}

第三步：重启 Windsurf

重启后 wskill MCP 即可使用。

💡 提示: 如果已有其他MCP服务器，只需在 mcpServers 中添加 wskill 配置即可，不要覆盖原有配置。

MCP 工具列表

工具	描述	参数
`list_local_skills`	列出本地已安装的技能	`category`: 可选，按类别筛选
`search_local_skills`	搜索本地技能	`query`: 搜索关键词
`get_skill_detail`	获取技能详细信息	`name`: 技能名称
`get_skill_categories`	获取技能分类	无
`get_trending_online_skills`	获取 skills.sh 热门排行	无
`search_online_skills_tool`	搜索在线技能	`query`: 搜索关键词
`install_online_skill`	安装在线技能	`skill_name`: 技能名称
`get_skills_path`	获取技能目录路径	无

在 Windsurf 中使用

配置完成后，可以直接在 Cascade 对话中请求：

👤 用户: 帮我搜索 React 相关的技能
🤖 Cascade: [调用 search_local_skills("react") 和 search_online_skills_tool("react")]
   返回本地和在线匹配的技能列表

👤 用户: 安装 frontend-design 技能
🤖 Cascade: [调用 install_online_skill("frontend-design")]
   技能将安装到 ~/.codeium/windsurf/skills/ 目录

👤 用户: 显示热门技能排行榜
🤖 Cascade: [调用 get_trending_online_skills()]
   显示 skills.sh 热门技能排行

👤 用户: 查看 kaggle-competition 技能详情
🤖 Cascade: [调用 get_skill_detail("kaggle-competition")]
   返回技能的完整信息和使用说明

验证 MCP 配置

重启 Windsurf 后，在 Cascade 中输入：

请调用 wskill MCP 的 get_skills_path 工具

如果返回技能目录路径信息，说明 MCP 配置成功。

🔗 关联项目

项目	描述
Super-Agent-Skills	🎯 Windsurf 技能合集仓库，包含丰富的预置技能
skills.sh	🔥 Vercel 官方 Agent Skills 排行榜

🖥️ 平台支持

平台	技能目录路径	状态
macOS	`~/.codeium/windsurf/skills/`	✅ 官方确认
Linux	`~/.codeium/windsurf/skills/`	✅ 官方确认
Windows	`%APPDATA%\Codeium\windsurf\skills\`	✅ 支持

📖 参考: Windsurf Skills 官方文档

👨‍💻 作者信息

信息	内容
作者	ChuanKang
GitHub	@1837620622
项目地址	https://github.com/1837620622/wskill
许可证	MIT License

📄 许可证

本项目采用 MIT License 开源许可证。

Made with ❤️ by ChuanKang for Windsurf Users

wskill | Super-Agent-Skills

使用说明

🚀 wskill

功能特性

安装方法

🎯 选择适合你的使用方式

CLI 用户（命令行爱好者）

MCP 用户（Windsurf 深度用户）

其他安装方式

验证安装

使用方法

列出所有技能

按类别浏览

搜索技能

查看技能详情

发现热门在线技能

命令参考

本地技能管理

在线技能发现 (skills.sh)

通用选项

📂 技能目录结构

🔗 在 Windsurf 中使用

➕ 添加自定义技能

📋 依赖

🔌 MCP 服务器集成

配置 Windsurf MCP

MCP 工具列表

在 Windsurf 中使用

验证 MCP 配置

🔗 关联项目

🖥️ 平台支持

👨‍💻 作者信息

📄 许可证

相关 MCP

iOS/macOS 构建 MCP 服务器与命令行工具

小红书内容访问服务

生物医学数据检索命令行与MCP服务

Windows命令行服务器

进程执行工具

MCP服务器管理工具