refactor: apply plugin best practices per official docs

.github/workflows/validate.yml

@@ -7,6 +7,31 @@ on:
     branches: [main]
 
 jobs:
+  validate-schema:
+    name: Validate Plugin Schema
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install Claude Code CLI
+        run: npm install -g @anthropic-ai/claude-code
+
+      - name: Validate marketplace
+        run: claude plugin validate .
+
+      - name: Validate individual plugins
+        run: |
+          for plugin in plugins/*/; do
+            echo "Validating $plugin..."
+            claude plugin validate "$plugin"
+          done
+
   validate-json:
     name: Validate JSON Syntax
     runs-on: ubuntu-latest

plugins/ecpay/.claude-plugin/plugin.json

@@ -10,6 +10,5 @@
   "homepage": "https://github.com/paid-tw/skills#ecpay",
   "repository": "https://github.com/paid-tw/skills",
   "license": "MIT",
-  "keywords": ["taiwan", "payment", "ecpay", "綠界", "金流", "invoice", "電子發票"],
-  "skills": "./skills/"
+  "keywords": ["taiwan", "payment", "ecpay", "綠界", "金流", "invoice", "電子發票"]
 }

plugins/newebpay/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "newebpay",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "藍新金流(NewebPay)完整串接工具 - 支付串接、交易查詢、退款",
   "author": {
     "name": "paid-tw",
@@ -11,6 +11,5 @@
   "repository": "https://github.com/paid-tw/skills",
   "license": "MIT",
   "keywords": ["taiwan", "payment", "newebpay", "藍新", "金流", "credit-card", "line-pay", "atm", "cvs"],
-  "skills": "./skills/",
-  "agents": "./agents/"
+  "hooks": "./hooks/hooks.json"
 }

plugins/newebpay/CHANGELOG.md

@@ -5,11 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-01-22
+
+### Added
+- Re-added Setup hook for environment variable checking (confirmed valid per official docs)
+- Agent "Context and examples" section per official structure
+
+### Changed
+- Renamed Agent "Expertise" section to "Capabilities" for consistency
+
 ## [2.1.0] - 2026-01-22
 
 ### Fixed
 - Changed `skills` and `agents` fields from array to path string format per official spec
-- Removed invalid `Setup` hook (not a standard event type)
+- Temporarily removed Setup hook (validator issue, now resolved)
 
 ## [2.0.0] - 2026-01-22
 

plugins/newebpay/agents/payment-integrator.md

@@ -12,7 +12,7 @@ capabilities:
 
 You are a payment integration specialist helping developers integrate Taiwan payment gateways into their applications.
 
-## Expertise
+## Capabilities
 
 ### NewebPay (藍新金流)
 - MPG (Multi Payment Gateway) checkout integration
@@ -30,6 +30,24 @@ You are a payment integration specialist helping developers integrate Taiwan pay
 - Unified payment platform integration
 - API configuration and setup
 
+## Context and examples
+
+**When to invoke this agent:**
+
+| Scenario | Example User Request |
+|----------|---------------------|
+| New payment integration | "幫我在 Laravel 專案串接藍新金流" |
+| Debugging payment issues | "CheckValue 驗證一直失敗" |
+| Adding payment methods | "加入 LINE Pay 付款選項" |
+| Handling refunds | "如何處理信用卡退款" |
+| Comparing gateways | "藍新和綠界哪個比較好" |
+
+**When NOT to use this agent:**
+
+- General coding questions unrelated to payments
+- Non-Taiwan payment gateways (Stripe, PayPal, etc.)
+- Cryptocurrency or blockchain payments
+
 ## Workflow
 
 When asked about payment integration:

plugins/newebpay/hooks/hooks.json

@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "Setup": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/check-env.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

plugins/payment-help/.claude-plugin/plugin.json

@@ -10,6 +10,5 @@
   "homepage": "https://github.com/paid-tw/skills#payment-help",
   "repository": "https://github.com/paid-tw/skills",
   "license": "MIT",
-  "keywords": ["taiwan", "payment", "comparison", "金流比較", "支付推薦"],
-  "skills": "./skills/"
+  "keywords": ["taiwan", "payment", "comparison", "金流比較", "支付推薦"]
 }

plugins/payuni/.claude-plugin/plugin.json

@@ -10,6 +10,5 @@
   "homepage": "https://github.com/paid-tw/skills#payuni",
   "repository": "https://github.com/paid-tw/skills",
   "license": "MIT",
-  "keywords": ["taiwan", "payment", "payuni", "統一金流", "金流"],
-  "skills": "./skills/"
+  "keywords": ["taiwan", "payment", "payuni", "統一金流", "金流"]
 }