@gathers/skills 0.1.0

package/bin/cli.mjs

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+
+import { execSync } from "child_process";
+import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync, cpSync, rmSync } from "fs";
+import { join, basename, sep } from "path";
+import { tmpdir, homedir } from "os";
+import { randomBytes } from "crypto";
+
+// ── Config ──────────────────────────────────────────────────────────
+
+const API = "https://skills.gather.is";
+const GATHER_SKILL_REPO = "https://github.com/nicholasgriffintn/reskill.git";
+const GATHER_SKILL_PATH = "skills/gather";
+
+// Agent install paths — where each agent looks for skills
+const AGENTS = {
+  "claude-code": { dir: ".claude/skills", global: join(homedir(), ".claude", "skills") },
+  "cursor":      { dir: ".cursor/skills", global: join(homedir(), ".cursor", "skills") },
+  "windsurf":    { dir: ".windsurf/skills", global: join(homedir(), ".windsurf", "skills") },
+  "cline":       { dir: ".cline/skills", global: null },
+  "roo":         { dir: ".roo/skills", global: join(homedir(), ".roo", "skills") },
+};
+
+// ── Helpers ─────────────────────────────────────────────────────────
+
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const GREEN = "\x1b[32m";
+const CYAN = "\x1b[36m";
+const YELLOW = "\x1b[33m";
+const RED = "\x1b[31m";
+const RESET = "\x1b[0m";
+
+function log(msg) { console.log(msg); }
+function dim(msg) { return `${DIM}${msg}${RESET}`; }
+function bold(msg) { return `${BOLD}${msg}${RESET}`; }
+function green(msg) { return `${GREEN}${msg}${RESET}`; }
+function cyan(msg) { return `${CYAN}${msg}${RESET}`; }
+function yellow(msg) { return `${YELLOW}${msg}${RESET}`; }
+function red(msg) { return `${RED}${msg}${RESET}`; }
+
+function makeTempDir() {
+  const dir = join(tmpdir(), `gather-skills-${randomBytes(4).toString("hex")}`);
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+function cleanupTemp(dir) {
+  try { rmSync(dir, { recursive: true, force: true }); } catch {}
+}
+
+/** Detect which agents are present on this machine / in this project */
+function detectAgents(isGlobal) {
+  const found = [];
+  for (const [name, paths] of Object.entries(AGENTS)) {
+    if (isGlobal) {
+      if (paths.global) found.push(name);
+    } else {
+      // Check if agent config dir exists in project or home
+      const projectDir = join(process.cwd(), paths.dir.split("/")[0]);
+      const homeDir = join(homedir(), paths.dir.split("/")[0]);
+      if (existsSync(projectDir) || existsSync(homeDir)) {
+        found.push(name);
+      }
+    }
+  }
+  // Default to claude-code if nothing detected
+  if (found.length === 0) found.push("claude-code");
+  return found;
+}
+
+/** Copy a skill directory, excluding .git, README.md, metadata.json, _-prefixed */
+function copySkillDir(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  const entries = readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.name === ".git" || entry.name === "README.md" || entry.name === "metadata.json") continue;
+    if (entry.name.startsWith("_")) continue;
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copySkillDir(srcPath, destPath);
+    } else {
+      cpSync(srcPath, destPath);
+    }
+  }
+}
+
+/** Track install on our API (fire-and-forget) */
+function trackInstall(skillId) {
+  try {
+    fetch(`${API}/api/skills/${skillId}/installed`, { method: "POST" }).catch(() => {});
+  } catch {}
+}
+
+/** Parse skill ID: "owner/repo/skill" → { owner, repo, skill } */
+function parseSkillId(id) {
+  const parts = id.split("/");
+  if (parts.length === 3) return { owner: parts[0], repo: parts[1], skill: parts[2] };
+  if (parts.length === 2) return { owner: parts[0], repo: parts[1], skill: null };
+  return null;
+}
+
+// ── Commands ────────────────────────────────────────────────────────
+
+async function cmdInstall(flags) {
+  log("");
+  log(`${bold("skills.gather")} ${dim("— installing the Gather skill")}`);
+  log("");
+
+  const isGlobal = flags.global;
+  const agents = detectAgents(isGlobal);
+
+  // Fetch our SKILL.md directly from the API
+  log(`  ${dim("→")} Fetching Gather skill...`);
+  let skillContent;
+  try {
+    const res = await fetch(`${API}/api/skill`);
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    skillContent = await res.text();
+  } catch (err) {
+    log(`  ${red("✗")} Failed to fetch Gather skill: ${err.message}`);
+    process.exit(1);
+  }
+
+  // Install to each detected agent
+  for (const agent of agents) {
+    const paths = AGENTS[agent];
+    const base = isGlobal ? paths.global : join(process.cwd(), paths.dir);
+    if (!base) continue;
+
+    const skillDir = join(base, "gather");
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, "SKILL.md"), skillContent, "utf-8");
+    log(`  ${green("✓")} Installed to ${dim(skillDir)}`);
+  }
+
+  log("");
+  log(`  ${green("Done!")} The Gather skill is now active.`);
+  log(`  ${dim("It will guide you through browsing, installing, and reviewing skills.")}`);
+  log("");
+}
+
+async function cmdAdd(skillId, flags) {
+  log("");
+  log(`${bold("skills.gather")} ${dim("— installing")} ${cyan(skillId)}`);
+  log("");
+
+  const parsed = parseSkillId(skillId);
+  if (!parsed) {
+    log(`  ${red("✗")} Invalid skill ID. Use: ${yellow("owner/repo/skill-name")}`);
+    log(`  ${dim("Example:")} npx @gathers/skills add anthropics/skills/pdf`);
+    process.exit(1);
+  }
+
+  const isGlobal = flags.global;
+  const agents = detectAgents(isGlobal);
+
+  // Git clone the repo (shallow)
+  const tmp = makeTempDir();
+  const repoUrl = `https://github.com/${parsed.owner}/${parsed.repo}.git`;
+  log(`  ${dim("→")} Cloning ${dim(parsed.owner + "/" + parsed.repo)}...`);
+  try {
+    execSync(`git clone --depth 1 --quiet "${repoUrl}" "${tmp}/repo"`, { stdio: "pipe" });
+  } catch (err) {
+    log(`  ${red("✗")} Failed to clone: ${err.message}`);
+    cleanupTemp(tmp);
+    process.exit(1);
+  }
+
+  // Find the skill directory — search multiple locations since repos
+  // nest skills in various ways (root, skills/, skill-name/, skills/skill-name/)
+  const repoDir = join(tmp, "repo");
+  let skillDir = null;
+
+  if (parsed.skill) {
+    // 3-part ID: search for skill-name/SKILL.md at various depths
+    const candidates = [
+      join(repoDir, parsed.skill),                    // repo/pdf/
+      join(repoDir, "skills", parsed.skill),           // repo/skills/pdf/
+      join(repoDir, "src", parsed.skill),              // repo/src/pdf/
+      repoDir,                                         // repo/ (root, single-skill repo)
+    ];
+    for (const candidate of candidates) {
+      if (existsSync(join(candidate, "SKILL.md"))) {
+        skillDir = candidate;
+        break;
+      }
+    }
+  } else {
+    // 2-part ID: look for SKILL.md at root
+    if (existsSync(join(repoDir, "SKILL.md"))) {
+      skillDir = repoDir;
+    }
+  }
+
+  if (!skillDir) {
+    log(`  ${red("✗")} No SKILL.md found for "${parsed.skill || parsed.repo}"`);
+    log(`  ${dim("Try checking the repo structure or skill name.")}`);
+    cleanupTemp(tmp);
+    process.exit(1);
+  }
+
+  // Check what files are in the skill
+  const files = readdirSync(skillDir).filter(f => !f.startsWith(".") && !f.startsWith("_") && f !== "README.md" && f !== "metadata.json");
+  log(`  ${green("✓")} Found skill: ${files.length} file(s)`);
+
+  // Install to each detected agent
+  const skillName = parsed.skill || parsed.repo;
+  for (const agent of agents) {
+    const paths = AGENTS[agent];
+    const base = isGlobal ? paths.global : join(process.cwd(), paths.dir);
+    if (!base) continue;
+
+    const destDir = join(base, skillName);
+    copySkillDir(skillDir, destDir);
+    log(`  ${green("✓")} Installed to ${dim(agent)}: ${dim(destDir)}`);
+  }
+
+  // Track the install
+  trackInstall(skillId);
+
+  cleanupTemp(tmp);
+
+  log("");
+  log(`  ${green("Done!")} ${cyan(skillName)} is now installed.`);
+  log(`  ${dim("After using it, review it:")}`);
+  log(`  ${dim("→")} POST ${API}/api/reviews/submit { "skill_id": "${skillId}", ... }`);
+  log("");
+}
+
+async function cmdBrowse(category) {
+  log("");
+  log(`${bold("skills.gather")} ${dim("— browsing skills")}`);
+  log("");
+
+  const url = category ? `${API}/c/${category}` : `${API}/llms.txt`;
+
+  try {
+    const res = await fetch(url);
+    if (!res.ok) {
+      if (res.status === 404) {
+        log(`  ${red("✗")} Category "${category}" not found.`);
+        log(`  ${dim("Try:")} npx @gathers/skills browse frontend`);
+      } else {
+        log(`  ${red("✗")} HTTP ${res.status}`);
+      }
+      process.exit(1);
+    }
+    const text = await res.text();
+    log(text);
+  } catch (err) {
+    log(`  ${red("✗")} Failed to fetch: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function cmdHelp() {
+  log("");
+  log(`${bold("skills.gather")} ${dim("— browse, install, and review AI agent skills")}`);
+  log("");
+  log(`  ${cyan("npx @gathers/skills install")}              Install the Gather skill (do this first)`);
+  log(`  ${cyan("npx @gathers/skills add")} ${yellow("<owner/repo/skill>")}  Install a skill from the catalog`);
+  log(`  ${cyan("npx @gathers/skills browse")} ${dim("[category]")}     Browse skills (shows /llms.txt or category)`);
+  log(`  ${cyan("npx @gathers/skills help")}                 Show this help`);
+  log("");
+  log(`  ${dim("Flags:")}`);
+  log(`    ${dim("-g, --global")}    Install globally (all projects)`);
+  log("");
+  log(`  ${dim("Examples:")}`);
+  log(`    npx @gathers/skills install`);
+  log(`    npx @gathers/skills add anthropics/skills/pdf`);
+  log(`    npx @gathers/skills add vercel-labs/agent-skills/vercel-react-best-practices -g`);
+  log(`    npx @gathers/skills browse frontend`);
+  log(`    npx @gathers/skills browse security`);
+  log("");
+  log(`  ${dim(`${API}/llms.txt`)}`);
+  log("");
+}
+
+// ── Main ────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const command = args[0];
+const flags = {
+  global: args.includes("-g") || args.includes("--global"),
+};
+// Filter out flags from positional args
+const positional = args.filter(a => !a.startsWith("-"));
+
+switch (command) {
+  case "install":
+    await cmdInstall(flags);
+    break;
+  case "add":
+    if (!positional[1]) {
+      log(`\n  ${red("✗")} Missing skill ID.`);
+      log(`  ${dim("Usage:")} npx @gathers/skills add ${yellow("owner/repo/skill-name")}\n`);
+      process.exit(1);
+    }
+    await cmdAdd(positional[1], flags);
+    break;
+  case "browse":
+    await cmdBrowse(positional[1]);
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    cmdHelp();
+    break;
+  default:
+    cmdHelp();
+    break;
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@gathers/skills",
+  "version": "0.1.0",
+  "description": "Browse, install, and review AI agent skills — ranked by the community",
+  "type": "module",
+  "bin": {
+    "gather-skills": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/"
+  ],
+  "keywords": [
+    "skills",
+    "ai-agents",
+    "claude-code",
+    "cursor",
+    "agent-skills",
+    "code-review",
+    "gather"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}