wskill (1837620622)

🚀 wskill

Windsurf Skill Manager

](https://www.python.org/downloads/)  ![Platform]()

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

功能特性 • 安装方法 • 使用方法 • 命令参考

功能特性

安装方法

pip install wskill

安装后可获得：

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

🎯 选择适合你的使用方式

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 设计智能技能..."
  ...

命令参考

本地技能管理

在线技能发现 (skills.sh)

通用选项

📂 技能目录结构

技能存储在 ~/.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 技能]

➕ 添加自定义技能

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

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

1. 创建 SKILL.md 文件：

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

   # 技能标题

   ## 概述
   技能内容...

   ## 使用方法
   ...

1. 验证技能是否加载：

   wskill search my-skill

📋 依赖

🔌 MCP 服务器集成

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

配置 Windsurf MCP

第一步：安装 wskill

pip install wskill

第二步：配置 MCP

1. 找到 Windsurf MCP 配置文件：

- macOS/Linux: ~/.codeium/windsurf/mcp_config.json - Windows: %APPDATA%\Codeium\windsurf\mcp_config.json

1. 在 mcpServers 中添加 wskill 配置：

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

第三步：重启 Windsurf

重启后 wskill MCP 即可使用。

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

MCP 工具列表

在 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 配置成功。

🔗 关联项目

🖥️ 平台支持

📖 参考: Windsurf Skills 官方文档

👨‍💻 作者信息

📄 许可证

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

Made with ❤️ by ChuanKang for Windsurf Users