recur-skills 0.0.1 → 0.0.3

package/.claude-plugin/marketplace.json

@@ -0,0 +1,32 @@
+{
+  "name": "recur-skills",
+  "owner": {
+    "name": "Recur",
+    "email": "hi@recur.tw"
+  },
+  "metadata": {
+    "description": "Claude Code skills for integrating Recur - Taiwan's subscription payment platform",
+    "version": "0.0.3"
+  },
+  "plugins": [
+    {
+      "name": "recur-skills",
+      "description": "Skills for Recur SDK integration including quickstart, checkout, webhooks, and entitlements",
+      "source": "./",
+      "skills": [
+        "./skills/recur-help",
+        "./skills/recur-quickstart",
+        "./skills/recur-checkout",
+        "./skills/recur-webhooks",
+        "./skills/recur-entitlements"
+      ],
+      "commands": [
+        "./skills/recur-help/SKILL.md",
+        "./skills/recur-quickstart/SKILL.md",
+        "./skills/recur-checkout/SKILL.md",
+        "./skills/recur-webhooks/SKILL.md",
+        "./skills/recur-entitlements/SKILL.md"
+      ]
+    }
+  ]
+}

package/README.md

@@ -4,38 +4,28 @@ Claude Code skills to help developers integrate [Recur](https://recur.tw) - Taiw
 
 ## Installation
 
-### Claude Code Plugin (Recommended)
-
 ```bash
-/plugin add recur-tw/skills
+/plugin marketplace add recur-tw/skills
+/plugin install recur-skills@recur-skills
 ```
 
-### npm CLI
-
-```bash
-# Install all skills globally
-npx recur-skills install --all --global
+## Getting Started
 
-# Install specific skills
-npx recur-skills install recur-quickstart recur-webhooks
+Not sure where to begin? Ask Claude:
 
-# Install to current project
-npx recur-skills install --all --project
+```
+Recur 有什麼功能？
 ```
 
-### Manual Installation
+Or type `/recur-help` to see all available skills.
 
-Copy skills to your Claude Code skills directory:
+## Available Skills
 
-```bash
-# Global (all projects)
-cp -r skills/* ~/.claude/skills/
+### recur-help
 
-# Project-specific
-cp -r skills/* .claude/skills/
-```
+List all available Recur skills and how to use them.
 
-## Available Skills
+**Triggers:** "Recur 有什麼功能", "help with Recur", "what can Recur do"
 
 ### recur-quickstart
 
@@ -45,7 +35,7 @@ Quick setup guide for Recur payment integration.
 
 - SDK installation
 - API key configuration
-- Basic provider setup
+- Provider setup
 - First checkout implementation
 
 ### recur-checkout
@@ -58,7 +48,6 @@ Implement Recur checkout flows.
 - useRecur and useSubscribe hooks
 - Product types (subscription, one-time, credits, donation)
 - Payment error handling
-- 3D verification
 
 ### recur-webhooks
 
@@ -69,7 +58,6 @@ Set up and handle Recur webhook events.
 - All webhook event types
 - Signature verification
 - Next.js and Express handlers
-- Testing webhooks locally
 - Idempotency handling
 
 ### recur-entitlements
@@ -82,51 +70,16 @@ Implement access control and permission checking.
 - Cached vs live checks
 - Paywall components
 - Server-side verification
-- Handling subscription statuses
 
 ## Usage
 
 Once installed, Claude will automatically use these skills when you're working on Recur integration tasks.
 
-You can also invoke them directly:
-
-```
-/recur-quickstart
-/recur-checkout
-/recur-webhooks
-/recur-entitlements
-```
-
-## Utility Scripts
-
-### Check Environment
-
-```bash
-./skills/recur-quickstart/scripts/check-env.sh
-```
-
-### Test Webhook Locally
-
-```bash
-./skills/recur-webhooks/scripts/test-webhook.sh http://localhost:3000/api/webhooks/recur checkout.completed
-```
-
-### Verify Webhook Signature
-
-```bash
-npx tsx ./skills/recur-webhooks/scripts/verify-signature.ts '<payload>' '<signature>' '<secret>'
-```
-
 ## Links
 
 - [Recur Website](https://recur.tw)
 - [Documentation](https://recur.tw/docs)
 - [SDK on npm](https://www.npmjs.com/package/recur-tw)
-- [API Reference](https://recur.tw/docs/api)
-
-## Contributing
-
-Found an issue or want to improve a skill? Please open an issue or PR at [github.com/recur-tw/skills](https://github.com/recur-tw/skills).
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recur-skills",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Claude Code skills for Recur - Taiwan's subscription payment platform",
   "keywords": [
     "recur",
@@ -40,6 +40,14 @@
     "skills",
     ".claude-plugin"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build",
+    "version": "node scripts/sync-version.js && git add .claude-plugin/marketplace.json"
+  },
   "dependencies": {
     "commander": "^12.1.0",
     "picocolors": "^1.1.1"
@@ -54,11 +62,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/skills/recur-help/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: recur-help
+description: List all available Recur skills and how to use them. Use when user asks "what can Recur do", "Recur skills", "Recur 有什麼功能", "help with Recur", "如何使用 Recur skills".
+---
+
+# Recur Skills 使用指南
+
+當用戶詢問 Recur skills 的功能時，向他們介紹以下可用的 skills：
+
+## 可用的 Skills
+
+### 1. recur-quickstart
+**用途**：快速開始 Recur 整合
+**觸發方式**：
+- 說：「幫我整合 Recur」「setup Recur」「Recur 串接」「金流設定」
+- 或輸入：`/recur-quickstart`
+
+### 2. recur-checkout
+**用途**：實作結帳流程（embedded、modal、redirect）
+**觸發方式**：
+- 說：「加上結帳按鈕」「checkout」「付款按鈕」「embedded checkout」
+- 或輸入：`/recur-checkout`
+
+### 3. recur-webhooks
+**用途**：設定 webhook 接收付款通知
+**觸發方式**：
+- 說：「設定 webhook」「付款通知」「訂閱事件」
+- 或輸入：`/recur-webhooks`
+
+### 4. recur-entitlements
+**用途**：實作付費功能權限檢查和 Paywall
+**觸發方式**：
+- 說：「檢查付費權限」「paywall」「權限檢查」「entitlements」
+- 或輸入：`/recur-entitlements`
+
+## 回覆格式
+
+用繁體中文回覆，格式如下：
+
+```
+## Recur Skills 使用指南
+
+我可以幫你完成以下 Recur 整合任務：
+
+| Skill | 用途 | 怎麼觸發 |
+|-------|------|---------|
+| **quickstart** | 快速開始整合 | 說「幫我整合 Recur」 |
+| **checkout** | 結帳流程 | 說「加上結帳按鈕」 |
+| **webhooks** | 付款通知 | 說「設定 webhook」 |
+| **entitlements** | 權限檢查 | 說「檢查付費權限」 |
+
+💡 **建議從 quickstart 開始**，它會引導你完成 SDK 安裝和基本設定。
+
+有什麼想做的嗎？
+```

package/.claude-plugin/plugin.json

@@ -1,25 +0,0 @@
-{
-  "name": "recur-skills",
-  "description": "Claude Code skills for integrating Recur - Taiwan's subscription payment platform. Includes checkout, webhooks, and entitlements.",
-  "version": "0.0.1",
-  "author": {
-    "name": "Recur",
-    "email": "hi@recur.tw",
-    "url": "https://recur.tw"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/recur-tw/skills"
-  },
-  "homepage": "https://recur.tw/skills",
-  "license": "MIT",
-  "keywords": [
-    "recur",
-    "payments",
-    "subscription",
-    "taiwan",
-    "checkout",
-    "webhooks",
-    "entitlements"
-  ]
-}