---
title: Skills
description: 使用 AI Skills 讓 AI 助手自動完成 Recur 金流整合
---

# Skills

**Skills** 是一種讓 AI 助手（如 Claude Code）學習特定領域知識的方式。安裝 Recur Skills 後，AI 會自動知道如何幫你完成金流整合，不再需要反覆查文件。

## Skills vs MCP

Skills 和 [MCP](/guides/mcp) 是兩種不同的 AI 整合方式：

| 特性 | Skills | MCP |
|------|--------|-----|
| **用途** | 教 AI 如何寫程式碼 | 讓 AI 操作外部 API |
| **運作方式** | 提供指令和範例 | 授權存取你的帳號 |
| **需要授權** | 不需要 | 需要 OAuth 授權 |
| **最適合** | 寫整合程式碼 | 管理產品、查看營收 |

**建議同時使用兩者**：用 MCP 建立 API Key 和產品，用 Skills 產生整合程式碼。

## 安裝方式

### npx skills add（推薦）

自動偵測已安裝的 AI 工具（Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI 等）並安裝。

```bash
# 安裝全部 Skills
npx skills add recur-tw/skills

# 安裝指定 Skill
npx skills add recur-tw/skills -s recur-checkout

# 安裝多個 Skills
npx skills add recur-tw/skills -s recur-checkout -s recur-webhooks

# 列出可用的 Skills
npx skills add recur-tw/skills --list

# 全域安裝（所有專案可用）
npx skills add recur-tw/skills --global
```

#### 常用選項

| 選項 | 說明 |
|------|------|
| `-s, --skill <name>` | 指定要安裝的 Skill |
| `-l, --list` | 列出可用的 Skills（不安裝） |
| `-g, --global` | 全域安裝 |
| `-a, --agent <name>` | 指定安裝到特定 AI 工具 |
| `--all` | 安裝全部到所有 AI 工具 |

### Claude Code Plugin

在 Claude Code 中執行：

```bash
# 加入 marketplace
/plugin marketplace add recur-tw/skills

# 安裝 skills
/plugin install recur-skills@recur-skills
```

重新啟動 Claude Code 後，輸入 `/` 即可看到 Recur Skills。

### npm CLI

使用 npm CLI 安裝 Skills：

```bash
# 安裝所有 Skills（全域）
npx recur-skills install --all --global

# 安裝所有 Skills（專案）
npx recur-skills install --all --project

# 安裝特定 Skills
npx recur-skills install recur-quickstart recur-webhooks
```

#### CLI 指令

| 指令 | 說明 |
|------|------|
| `recur-skills list` | 列出所有可用的 Skills |
| `recur-skills info <skill>` | 顯示特定 Skill 的詳細資訊 |
| `recur-skills install [skills...]` | 安裝 Skills |
| `recur-skills path` | 顯示 Skills 目錄路徑 |

#### 安裝選項

| 選項 | 說明 |
|------|------|
| `--global` 或 `-g` | 安裝到全域目錄 `~/.claude/skills/` |
| `--project` 或 `-p` | 安裝到專案目錄 `.claude/skills/` |
| `--all` 或 `-a` | 安裝所有 Skills |

### 手動安裝

從 GitHub 複製 Skills 檔案到你的 Claude Code skills 目錄：

```bash
# 全域安裝（所有專案）
git clone https://github.com/recur-tw/skills.git
cp -r skills/skills/* ~/.claude/skills/

# 專案安裝
cp -r skills/skills/* .claude/skills/
```

## 可用的 Skills

  
  
  
  

## 使用方式

安裝 Skills 後，直接告訴 Claude 你想做什麼：

### 快速開始

```
幫我整合 Recur 付款到我的 Next.js 專案
```

### 實作 Checkout

```
在 /pricing 頁面加上訂閱按鈕，用 embedded checkout
```

### 設定 Webhooks

```
幫我設定 webhook endpoint 接收付款通知
```

### 實作權限控制

```
我要擋住沒付費的用戶，只有訂閱者才能看到 /dashboard
```

### 直接呼叫 Skill

你也可以直接使用 skill 指令：

```
/recur-quickstart
/recur-checkout
/recur-webhooks
/recur-entitlements
```

## 自動觸發

Skills 會根據對話內容自動觸發。例如：

| 關鍵字 | 觸發的 Skill |
|--------|-------------|
| 「整合 Recur」「setup Recur」「金流設定」 | recur-quickstart |
| 「checkout」「結帳」「付款按鈕」 | recur-checkout |
| 「webhook」「付款通知」「訂閱事件」 | recur-webhooks |
| 「paywall」「權限檢查」「entitlements」 | recur-entitlements |

## 與 MCP 搭配使用

### 安裝 MCP 和 Skills

```bash
# 安裝 MCP
claude mcp add --transport http recur https://mcp.recur.tw/

# 安裝 Skills
npx skills add recur-tw/skills
```

### 用 MCP 建立產品

```
在 Recur 建立一個月費 NT$299 的 Pro 方案
```

### 用 Skills 產生程式碼

```
幫我加上訂閱按鈕，訂閱剛才建立的 Pro 方案
```

## 常見問題

### Q: Skills 和 MCP 有什麼不同？

Skills 教 AI 如何寫程式碼（不需要授權），MCP 讓 AI 操作你的 Recur 帳號（需要 OAuth 授權）。建議同時使用兩者。

### Q: 如何更新 Skills？

如果使用 Plugin 安裝，會自動更新。使用 npm CLI 則重新執行 install 指令即可。

### Q: Skills 支援哪些 AI 工具？

支援 Claude Code、Cursor、Codex、GitHub Copilot、Gemini CLI、Antigravity 等主流 AI 工具。使用 `npx skills add` 會自動偵測已安裝的工具。

## 相關資源

- [Skills 行銷頁面](/skills) - 查看所有 Skills 的詳細介紹
- [MCP AI 整合](/guides/mcp) - 用 MCP 管理 Recur 帳號
- [SDK 快速開始](/getting-started/sdk) - 手動整合 SDK
- [GitHub Repo](https://github.com/recur-tw/skills) - Skills 原始碼