# Skills (/guides/skills)





Skills [#skills]

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

Skills vs MCP [#skills-vs-mcp]

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

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

<Callout type="info">
  **建議同時使用兩者**：用 MCP 建立 API Key 和產品，用 Skills 產生整合程式碼。
</Callout>

安裝方式 [#安裝方式]

<Tabs items="['npx skills add', 'Claude Code Plugin', 'npm CLI', '手動安裝']">
  <Tab value="npx skills add">
    npx skills add（推薦） [#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 工具     |
  </Tab>

  <Tab value="Claude Code Plugin">
    Claude Code Plugin [#claude-code-plugin]

    在 Claude Code 中執行：

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

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

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

  <Tab value="npm CLI">
    npm CLI [#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 指令 [#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                 |
  </Tab>

  <Tab value="手動安裝">
    手動安裝 [#手動安裝]

    從 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/
    ```
  </Tab>
</Tabs>

可用的 Skills [#可用的-skills]

<Cards>
  <Card title="🚀 recur-quickstart" description="5 分鐘內完成首次 Recur 整合" href="/skills/recur-quickstart" />

  <Card title="💳 recur-checkout" description="實作結帳流程，支援 embedded、modal、redirect" href="/skills/recur-checkout" />

  <Card title="🔔 recur-webhooks" description="設定 webhook 接收付款通知" href="/skills/recur-webhooks" />

  <Card title="🔐 recur-entitlements" description="實作付費功能權限檢查和 Paywall" href="/skills/recur-entitlements" />
</Cards>

使用方式 [#使用方式]

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

快速開始 [#快速開始]

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

實作 Checkout [#實作-checkout]

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

設定 Webhooks [#設定-webhooks]

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

實作權限控制 [#實作權限控制]

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

直接呼叫 Skill [#直接呼叫-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-搭配使用]

<Steps>
  <Step>
    安裝 MCP 和 Skills [#安裝-mcp-和-skills]

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

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

  <Step>
    用 MCP 建立產品 [#用-mcp-建立產品]

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

  <Step>
    用 Skills 產生程式碼 [#用-skills-產生程式碼]

    ```
    幫我加上訂閱按鈕，訂閱剛才建立的 Pro 方案
    ```
  </Step>
</Steps>

常見問題 [#常見問題]

Q: Skills 和 MCP 有什麼不同？ [#q-skills-和-mcp-有什麼不同]

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

Q: 如何更新 Skills？ [#q-如何更新-skills]

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

Q: Skills 支援哪些 AI 工具？ [#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 快速開始](/guides/getting-started) - 手動整合 SDK
* [GitHub Repo](https://github.com/recur-tw/skills) - Skills 原始碼