功能特性

安装方法

方式一：从 GitHub 安装（推荐）

# 克隆仓库
git clone https://github.com/1837620622/wskill.git

# 进入目录并安装
cd wskill
pip install -e .

# 安装 MCP 服务器（可选，用于 Windsurf 集成）
pip install -e ".[mcp]"

方式二：手动安装

# 进入项目目录
cd /path/to/wskill

# 使用 pip 安装
pip install -e .

# 或使用 pip3
pip3 install -e .

# 进入项目目录
cd C:\path\to\wskill

# 使用 pip 安装
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
   

2. 创建 SKILL.md 文件：

   ---
   name: my-skill
   description: "技能描述。触发关键词：keyword1, keyword2, 中文关键词。"
   author: YourName
   version: 1.0.0
   ---
   
   # 技能标题
   
   ## 概述
   技能内容...
   
   ## 使用方法
   ...
   

3. 验证技能是否加载：

   wskill search my-skill
   

📋 依赖

🔌 MCP 服务器集成

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

配置 Windsurf MCP

方式一：自动配置（推荐）

# 安装 wskill
pip install -e .

# wskill-mcp 命令会自动注册到系统

方式二：手动配置

1. 找到 Windsurf MCP 配置文件：

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

2. 添加 wskill 服务器配置：

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

3. 重启 Windsurf 使配置生效

完整配置示例

{
  "mcpServers": {
    "wskill": {
      "command": "wskill-mcp",
      "args": [],
      "disabled": false
    },
    "其他服务器": {
      "...": "..."
    }
  }
}

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 开源许可证。