recur-skills 0.0.1

package/.claude-plugin/plugin.json

@@ -0,0 +1,25 @@
+{
+  "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"
+  ]
+}

package/README.md

@@ -0,0 +1,133 @@
+# Recur Skills for Claude Code
+
+Claude Code skills to help developers integrate [Recur](https://recur.tw) - Taiwan's subscription payment platform.
+
+## Installation
+
+### Claude Code Plugin (Recommended)
+
+```bash
+/plugin add recur-tw/skills
+```
+
+### npm CLI
+
+```bash
+# Install all skills globally
+npx recur-skills install --all --global
+
+# Install specific skills
+npx recur-skills install recur-quickstart recur-webhooks
+
+# Install to current project
+npx recur-skills install --all --project
+```
+
+### Manual Installation
+
+Copy skills to your Claude Code skills directory:
+
+```bash
+# Global (all projects)
+cp -r skills/* ~/.claude/skills/
+
+# Project-specific
+cp -r skills/* .claude/skills/
+```
+
+## Available Skills
+
+### recur-quickstart
+
+Quick setup guide for Recur payment integration.
+
+**Triggers:** "integrate Recur", "setup Recur", "Recur 串接", "金流設定"
+
+- SDK installation
+- API key configuration
+- Basic provider setup
+- First checkout implementation
+
+### recur-checkout
+
+Implement Recur checkout flows.
+
+**Triggers:** "checkout", "結帳", "付款按鈕", "embedded checkout"
+
+- Embedded, modal, and redirect modes
+- useRecur and useSubscribe hooks
+- Product types (subscription, one-time, credits, donation)
+- Payment error handling
+- 3D verification
+
+### recur-webhooks
+
+Set up and handle Recur webhook events.
+
+**Triggers:** "webhook", "付款通知", "訂閱事件", "payment notification"
+
+- All webhook event types
+- Signature verification
+- Next.js and Express handlers
+- Testing webhooks locally
+- Idempotency handling
+
+### recur-entitlements
+
+Implement access control and permission checking.
+
+**Triggers:** "paywall", "權限檢查", "entitlements", "access control"
+
+- useCustomer hook
+- 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
+
+MIT

package/dist/cli.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { program } from "commander";
+import pc from "picocolors";
+import { existsSync as existsSync2, mkdirSync, cpSync, readdirSync as readdirSync2 } from "fs";
+import { join as join2, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+
+// src/index.ts
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var SKILLS_DIR = join(__dirname, "..", "skills");
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { data: {}, content };
+  }
+  const data = {};
+  const lines = match[1].split("\n");
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex > 0) {
+      const key = line.slice(0, colonIndex).trim();
+      const value = line.slice(colonIndex + 1).trim();
+      data[key] = value;
+    }
+  }
+  return { data, content: match[2] };
+}
+function getAllSkills() {
+  if (!existsSync(SKILLS_DIR)) {
+    return [];
+  }
+  const skillDirs = readdirSync(SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+  const skills = [];
+  for (const dir of skillDirs) {
+    const skillPath = join(SKILLS_DIR, dir, "SKILL.md");
+    if (!existsSync(skillPath)) continue;
+    const rawContent = readFileSync(skillPath, "utf-8");
+    const { data, content } = parseFrontmatter(rawContent);
+    skills.push({
+      slug: dir,
+      name: data.name || dir,
+      description: data.description || "",
+      content,
+      path: skillPath
+    });
+  }
+  return skills;
+}
+function getSkill(slug) {
+  const skillPath = join(SKILLS_DIR, slug, "SKILL.md");
+  if (!existsSync(skillPath)) return null;
+  const rawContent = readFileSync(skillPath, "utf-8");
+  const { data, content } = parseFrontmatter(rawContent);
+  return {
+    slug,
+    name: data.name || slug,
+    description: data.description || "",
+    content,
+    path: skillPath
+  };
+}
+function getSkillsDir() {
+  return SKILLS_DIR;
+}
+
+// src/cli.ts
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var SKILLS_SOURCE = join2(__dirname2, "..", "skills");
+program.name("recur-skills").description("Claude Code skills for Recur payment integration").version("0.0.1");
+program.command("list").description("List all available skills").action(() => {
+  const skills = getAllSkills();
+  if (skills.length === 0) {
+    console.log(pc.yellow("No skills found."));
+    return;
+  }
+  console.log(pc.bold("\n\u{1F4E6} Available Recur Skills\n"));
+  for (const skill of skills) {
+    console.log(pc.cyan(`  ${skill.name}`));
+    console.log(pc.dim(`     ${skill.description}
+`));
+  }
+  console.log(pc.dim(`Total: ${skills.length} skills
+`));
+});
+program.command("info <skill>").description("Show detailed information about a skill").action((skillName) => {
+  const skill = getSkill(skillName);
+  if (!skill) {
+    console.log(pc.red(`Skill "${skillName}" not found.`));
+    console.log(pc.dim("\nRun `recur-skills list` to see available skills."));
+    process.exit(1);
+  }
+  console.log(pc.bold(`
+\u{1F4E6} ${skill.name}
+`));
+  console.log(pc.dim("Description:"));
+  console.log(`  ${skill.description}
+`);
+  console.log(pc.dim("Path:"));
+  console.log(`  ${skill.path}
+`);
+});
+program.command("install [skills...]").description("Install skills to your Claude Code skills directory").option("-g, --global", "Install to global ~/.claude/skills/", false).option("-p, --project", "Install to project .claude/skills/", false).option("-a, --all", "Install all skills", false).action((skillNames, options) => {
+  let targetDir;
+  if (options.global) {
+    targetDir = join2(process.env.HOME || "~", ".claude", "skills");
+  } else if (options.project) {
+    targetDir = join2(process.cwd(), ".claude", "skills");
+  } else {
+    targetDir = join2(process.env.HOME || "~", ".claude", "skills");
+  }
+  let toInstall;
+  if (options.all) {
+    toInstall = readdirSync2(SKILLS_SOURCE, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+  } else if (skillNames.length === 0) {
+    console.log(pc.yellow("Please specify skills to install or use --all"));
+    console.log(pc.dim("\nExamples:"));
+    console.log(pc.dim("  recur-skills install recur-quickstart"));
+    console.log(pc.dim("  recur-skills install recur-checkout recur-webhooks"));
+    console.log(pc.dim("  recur-skills install --all"));
+    process.exit(1);
+  } else {
+    toInstall = skillNames;
+  }
+  if (!existsSync2(targetDir)) {
+    mkdirSync(targetDir, { recursive: true });
+  }
+  console.log(pc.bold(`
+\u{1F4E6} Installing skills to ${targetDir}
+`));
+  let installed = 0;
+  for (const skillName of toInstall) {
+    const sourcePath = join2(SKILLS_SOURCE, skillName);
+    const destPath = join2(targetDir, skillName);
+    if (!existsSync2(sourcePath)) {
+      console.log(pc.red(`  \u2717 ${skillName} - not found`));
+      continue;
+    }
+    try {
+      cpSync(sourcePath, destPath, { recursive: true });
+      console.log(pc.green(`  \u2713 ${skillName}`));
+      installed++;
+    } catch (error) {
+      console.log(pc.red(`  \u2717 ${skillName} - ${error}`));
+    }
+  }
+  console.log(pc.dim(`
+Installed ${installed}/${toInstall.length} skills
+`));
+  if (installed > 0) {
+    console.log(pc.cyan("Skills are now available in Claude Code!"));
+    console.log(pc.dim("Claude will automatically use them when relevant,"));
+    console.log(pc.dim("or you can invoke them directly with /skill-name\n"));
+  }
+});
+program.command("path").description("Show the path to the skills directory").action(() => {
+  console.log(getSkillsDir());
+});
+program.parse();

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+interface SkillMetadata {
+    name: string;
+    description: string;
+}
+interface Skill extends SkillMetadata {
+    slug: string;
+    content: string;
+    path: string;
+}
+/**
+ * Get all available skills
+ */
+declare function getAllSkills(): Skill[];
+/**
+ * Get a single skill by slug
+ */
+declare function getSkill(slug: string): Skill | null;
+/**
+ * Get skill names only (for listing)
+ */
+declare function getSkillNames(): string[];
+/**
+ * Get the path to skills directory
+ */
+declare function getSkillsDir(): string;
+
+export { type Skill, type SkillMetadata, getAllSkills, getSkill, getSkillNames, getSkillsDir };

package/dist/index.js

@@ -0,0 +1,72 @@
+// src/index.ts
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var SKILLS_DIR = join(__dirname, "..", "skills");
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) {
+    return { data: {}, content };
+  }
+  const data = {};
+  const lines = match[1].split("\n");
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex > 0) {
+      const key = line.slice(0, colonIndex).trim();
+      const value = line.slice(colonIndex + 1).trim();
+      data[key] = value;
+    }
+  }
+  return { data, content: match[2] };
+}
+function getAllSkills() {
+  if (!existsSync(SKILLS_DIR)) {
+    return [];
+  }
+  const skillDirs = readdirSync(SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+  const skills = [];
+  for (const dir of skillDirs) {
+    const skillPath = join(SKILLS_DIR, dir, "SKILL.md");
+    if (!existsSync(skillPath)) continue;
+    const rawContent = readFileSync(skillPath, "utf-8");
+    const { data, content } = parseFrontmatter(rawContent);
+    skills.push({
+      slug: dir,
+      name: data.name || dir,
+      description: data.description || "",
+      content,
+      path: skillPath
+    });
+  }
+  return skills;
+}
+function getSkill(slug) {
+  const skillPath = join(SKILLS_DIR, slug, "SKILL.md");
+  if (!existsSync(skillPath)) return null;
+  const rawContent = readFileSync(skillPath, "utf-8");
+  const { data, content } = parseFrontmatter(rawContent);
+  return {
+    slug,
+    name: data.name || slug,
+    description: data.description || "",
+    content,
+    path: skillPath
+  };
+}
+function getSkillNames() {
+  if (!existsSync(SKILLS_DIR)) {
+    return [];
+  }
+  return readdirSync(SKILLS_DIR, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).filter((dirent) => existsSync(join(SKILLS_DIR, dirent.name, "SKILL.md"))).map((dirent) => dirent.name);
+}
+function getSkillsDir() {
+  return SKILLS_DIR;
+}
+export {
+  getAllSkills,
+  getSkill,
+  getSkillNames,
+  getSkillsDir
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "recur-skills",
+  "version": "0.0.1",
+  "description": "Claude Code skills for Recur - Taiwan's subscription payment platform",
+  "keywords": [
+    "recur",
+    "claude-code",
+    "skills",
+    "subscription",
+    "payments",
+    "taiwan",
+    "agent-skills"
+  ],
+  "homepage": "https://recur.tw/skills",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/recur-tw/skills"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Recur",
+    "email": "hi@recur.tw",
+    "url": "https://recur.tw"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./skills/*": "./skills/*"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "recur-skills": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    ".claude-plugin"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  }
+}