@tickpick/skills 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @tickpick/skills
+
+Install Claude Code skills shared by the TickPick PM team.
+
+## Usage
+
+```bash
+# List available skills
+npx @tickpick/skills list
+
+# Install a skill (project-local)
+npx @tickpick/skills add write-prd
+
+# Install globally (available in all projects)
+npx @tickpick/skills add write-prd --global
+
+# Update all installed skills
+npx @tickpick/skills update
+
+# Remove a skill
+npx @tickpick/skills remove write-prd
+```
+
+## Using installed skills
+
+Once installed, skills are available in Claude Code via the `/` command:
+
+```
+/write-prd Payment confirmation redesign
+```
+
+## Configuration
+
+By default, skills are fetched from the TickPick PM Companion registry. Override with:
+
+```bash
+# Environment variable
+SKILLS_REGISTRY_URL=https://your-app.vercel.app/api/skills/registry npx @tickpick/skills list
+
+# CLI flag
+npx @tickpick/skills list --registry=https://your-app.vercel.app/api/skills/registry
+```

package/cli.mjs

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync, mkdirSync, rmSync, existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+
+const DEFAULT_REGISTRY =
+  process.env.SKILLS_REGISTRY_URL || "https://pm-companion.vercel.app/api/skills/registry";
+
+const MANIFEST_FILE = ".skills-manifest.json";
+
+// ─── Helpers ─────────────────────────────────────────────────
+
+async function fetchRegistry(registryUrl) {
+  const res = await fetch(registryUrl);
+  if (!res.ok) throw new Error(`Failed to fetch registry: ${res.status}`);
+  const data = await res.json();
+  return data.skills;
+}
+
+async function fetchSkillMd(registryUrl, slug) {
+  const res = await fetch(`${registryUrl}/${slug}`);
+  if (!res.ok) {
+    if (res.status === 404) return null;
+    throw new Error(`Failed to fetch skill "${slug}": ${res.status}`);
+  }
+  return res.text();
+}
+
+function getSkillsDir(global) {
+  return global
+    ? join(homedir(), ".claude", "skills")
+    : join(process.cwd(), ".claude", "skills");
+}
+
+function getManifestPath(global) {
+  return global
+    ? join(homedir(), ".claude", MANIFEST_FILE)
+    : join(process.cwd(), ".claude", MANIFEST_FILE);
+}
+
+function readManifest(global) {
+  const path = getManifestPath(global);
+  if (!existsSync(path)) return { registry: DEFAULT_REGISTRY, installed: {} };
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    return { registry: DEFAULT_REGISTRY, installed: {} };
+  }
+}
+
+function writeManifest(global, manifest) {
+  const path = getManifestPath(global);
+  mkdirSync(join(path, ".."), { recursive: true });
+  writeFileSync(path, JSON.stringify(manifest, null, 2) + "\n");
+}
+
+function installSkill(slug, content, global) {
+  const dir = join(getSkillsDir(global), slug);
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, "SKILL.md"), content);
+}
+
+// ─── Commands ────────────────────────────────────────────────
+
+async function cmdList(registryUrl) {
+  const skills = await fetchRegistry(registryUrl);
+  if (skills.length === 0) {
+    console.log("No skills available.");
+    return;
+  }
+
+  console.log("\nAvailable skills:\n");
+  const maxSlug = Math.max(...skills.map((s) => s.slug.length));
+  for (const s of skills) {
+    console.log(`  ${s.slug.padEnd(maxSlug + 2)}${s.description}`);
+  }
+  console.log(`\n${skills.length} skill${skills.length !== 1 ? "s" : ""} available.`);
+  console.log("Install with: npx @tickpick/skills add <name>\n");
+}
+
+async function cmdAdd(slug, registryUrl, global) {
+  const content = await fetchSkillMd(registryUrl, slug);
+  if (!content) {
+    console.error(`Error: skill "${slug}" not found.`);
+    process.exit(1);
+  }
+
+  installSkill(slug, content, global);
+
+  // Update manifest
+  const manifest = readManifest(global);
+  manifest.registry = registryUrl;
+  if (!manifest.installed) manifest.installed = {};
+  manifest.installed[slug] = { updatedAt: new Date().toISOString() };
+  writeManifest(global, manifest);
+
+  const target = resolve(getSkillsDir(global), slug, "SKILL.md");
+  console.log(`✓ Installed ${slug} → ${target}`);
+}
+
+async function cmdUpdate(registryUrl, global) {
+  const manifest = readManifest(global);
+  const installed = Object.keys(manifest.installed || {});
+
+  if (installed.length === 0) {
+    console.log("No skills installed. Use `npx @tickpick/skills add <name>` first.");
+    return;
+  }
+
+  const url = registryUrl || manifest.registry || DEFAULT_REGISTRY;
+  const skills = await fetchRegistry(url);
+  const skillMap = Object.fromEntries(skills.map((s) => [s.slug, s]));
+
+  let updated = 0;
+  for (const slug of installed) {
+    const remote = skillMap[slug];
+    if (!remote) {
+      console.log(`  ${slug}  ⚠ no longer in registry`);
+      continue;
+    }
+
+    const localDate = manifest.installed[slug]?.updatedAt;
+    if (localDate && new Date(remote.updatedAt) <= new Date(localDate)) {
+      console.log(`  ${slug}  · unchanged`);
+      continue;
+    }
+
+    const content = await fetchSkillMd(url, slug);
+    if (content) {
+      installSkill(slug, content, global);
+      manifest.installed[slug] = { updatedAt: remote.updatedAt };
+      console.log(`  ${slug}  ✓ updated`);
+      updated++;
+    }
+  }
+
+  writeManifest(global, manifest);
+  console.log(`\n${updated} skill${updated !== 1 ? "s" : ""} updated.`);
+}
+
+async function cmdRemove(slug, global) {
+  const dir = join(getSkillsDir(global), slug);
+  if (!existsSync(dir)) {
+    console.error(`Error: skill "${slug}" is not installed.`);
+    process.exit(1);
+  }
+
+  rmSync(dir, { recursive: true });
+
+  const manifest = readManifest(global);
+  if (manifest.installed) {
+    delete manifest.installed[slug];
+    writeManifest(global, manifest);
+  }
+
+  console.log(`✓ Removed ${slug}`);
+}
+
+// ─── CLI entry point ─────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const command = args[0];
+const isGlobal = args.includes("--global") || args.includes("-g");
+const registryFlag = args.find((a) => a.startsWith("--registry="));
+const registryUrl = registryFlag
+  ? registryFlag.split("=").slice(1).join("=")
+  : DEFAULT_REGISTRY;
+
+// Filter out flags to get positional args
+const positional = args.filter(
+  (a) => !a.startsWith("--") && !a.startsWith("-g"),
+);
+
+switch (command) {
+  case "list":
+  case "ls":
+    await cmdList(registryUrl);
+    break;
+
+  case "add":
+  case "install":
+    if (!positional[1]) {
+      console.error("Usage: npx @tickpick/skills add <skill-name>");
+      process.exit(1);
+    }
+    await cmdAdd(positional[1], registryUrl, isGlobal);
+    break;
+
+  case "update":
+  case "upgrade":
+    await cmdUpdate(registryUrl, isGlobal);
+    break;
+
+  case "remove":
+  case "rm":
+    if (!positional[1]) {
+      console.error("Usage: npx @tickpick/skills remove <skill-name>");
+      process.exit(1);
+    }
+    await cmdRemove(positional[1], isGlobal);
+    break;
+
+  default:
+    console.log(`
+@tickpick/skills — Claude Code skills for the TickPick PM team
+
+Commands:
+  list                  Show available skills
+  add <name>            Install a skill to .claude/skills/
+  add <name> --global   Install to ~/.claude/skills/ (all projects)
+  update                Re-fetch all installed skills
+  remove <name>         Remove an installed skill
+
+Options:
+  --global, -g          Use global (~/.claude/) instead of project-local
+  --registry=<url>      Override the registry URL
+
+Examples:
+  npx @tickpick/skills list
+  npx @tickpick/skills add write-prd
+  npx @tickpick/skills add sprint-retro --global
+  npx @tickpick/skills update
+`);
+    break;
+}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@tickpick/skills",
+  "version": "0.1.0",
+  "description": "Install Claude Code skills shared by the TickPick PM team",
+  "type": "module",
+  "bin": {
+    "skills": "./cli.mjs"
+  },
+  "files": [
+    "cli.mjs"
+  ],
+  "keywords": [
+    "claude-code",
+    "skills",
+    "tickpick"
+  ],
+  "license": "UNLICENSED",
+  "private": false
+}