skills-ws 1.0.0

package/bin/skillsadd.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+import { mkdirSync, writeFileSync, existsSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { get } from "https";
+
+const GREEN = "\x1b[32m";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+
+const SKILLS_JSON = "https://skills-ws.vercel.app/skills.json";
+const RAW_BASE = "https://raw.githubusercontent.com/san-npm/skills-ws/main/skills-data";
+
+function fetch(url) {
+  return new Promise((resolve, reject) => {
+    get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return fetch(res.headers.location).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) return reject(new Error(`HTTP ${res.statusCode}`));
+      const chunks = [];
+      res.on("data", (c) => chunks.push(c));
+      res.on("end", () => resolve(Buffer.concat(chunks).toString()));
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+function detectTarget() {
+  const cwd = process.cwd();
+  if (existsSync(join(cwd, ".claude")) || existsSync(join(cwd, "AGENTS.md")))
+    return join(cwd, ".claude", "skills");
+  if (existsSync(join(cwd, ".cursor")))
+    return join(cwd, ".cursor", "skills");
+  if (existsSync(join(cwd, ".codex")))
+    return join(cwd, ".codex", "skills");
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (existsSync(join(home, "openclaw")))
+    return join(home, "openclaw", "skills");
+  return join(cwd, ".claude", "skills");
+}
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const opts = { skill: null, dir: null, list: false, help: false };
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--skill" && args[i + 1]) { opts.skill = args[++i]; }
+    else if (args[i] === "--dir" && args[i + 1]) { opts.dir = args[++i]; }
+    else if (args[i] === "--list" || args[i] === "list") { opts.list = true; }
+    else if (args[i] === "--help" || args[i] === "-h" || args[i] === "help") { opts.help = true; }
+    else if (!args[i].startsWith("-") && i === 0) {
+      // First positional arg — could be a pack name, ignore for now
+    }
+  }
+  return opts;
+}
+
+async function main() {
+  const opts = parseArgs();
+
+  if (opts.help) {
+    console.log(`
+${GREEN}${BOLD}skillsadd${RESET} — install agent skills from skills.ws
+
+${BOLD}Usage:${RESET}
+  npx skills-ws                        Install all skills
+  npx skills-ws --skill seo-geo        Install a single skill
+  npx skills-ws --list                 List available skills
+  npx skills-ws --dir ./my-skills      Custom install directory
+
+${BOLD}Options:${RESET}
+  --skill <name>   Install a specific skill
+  --dir <path>     Override install directory
+  --list           List all available skills
+  --help           Show this help
+
+${DIM}https://skills.ws${RESET}
+`);
+    return;
+  }
+
+  // Fetch skills list
+  let data;
+  try {
+    const raw = await fetch(SKILLS_JSON);
+    data = JSON.parse(raw);
+  } catch (e) {
+    console.error("Failed to fetch skills list from skills.ws");
+    process.exit(1);
+  }
+
+  if (opts.list) {
+    console.log(`\n${GREEN}${BOLD}${data.skills.length} skills available:${RESET}\n`);
+    const cats = {};
+    for (const s of data.skills) {
+      (cats[s.category] = cats[s.category] || []).push(s.name);
+    }
+    for (const [cat, skills] of Object.entries(cats).sort()) {
+      console.log(`  ${BOLD}${cat}${RESET}`);
+      for (const name of skills.sort()) {
+        console.log(`    ${DIM}-${RESET} ${name}`);
+      }
+      console.log();
+    }
+    return;
+  }
+
+  const targetDir = opts.dir ? resolve(opts.dir) : detectTarget();
+  const skillNames = opts.skill
+    ? [opts.skill]
+    : data.skills.map((s) => s.name);
+
+  console.log(`\n${GREEN}${BOLD}skills.ws${RESET} — installing ${skillNames.length} skill${skillNames.length > 1 ? "s" : ""}`);
+  console.log(`${DIM}Target: ${targetDir}${RESET}\n`);
+
+  let installed = 0;
+  let failed = 0;
+
+  for (const name of skillNames) {
+    const skillDir = join(targetDir, name);
+    const url = `${RAW_BASE}/${name}/SKILL.md`;
+
+    try {
+      const content = await fetch(url);
+      mkdirSync(skillDir, { recursive: true });
+      writeFileSync(join(skillDir, "SKILL.md"), content);
+      console.log(`  ${GREEN}+${RESET} ${name}`);
+      installed++;
+    } catch {
+      console.log(`  ${DIM}x ${name} (not found)${RESET}`);
+      failed++;
+    }
+  }
+
+  console.log(`\n${GREEN}${BOLD}Done.${RESET} Installed ${installed} skills to ${targetDir}`);
+  if (failed > 0) {
+    console.log(`${DIM}${failed} skills could not be fetched${RESET}`);
+  }
+  console.log();
+}
+
+main().catch((e) => {
+  console.error(e.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "skills-ws",
+  "version": "1.0.0",
+  "description": "Install agent skills from skills.ws — marketing, growth, analytics & conversion skills for AI coding assistants",
+  "bin": {
+    "skills-ws": "./bin/skillsadd.mjs"
+  },
+  "keywords": ["ai", "agent", "skills", "claude", "cursor", "codex", "openclaw", "marketing", "growth", "seo", "analytics"],
+  "author": "Commit Media",
+  "license": "MIT",
+  "homepage": "https://skills.ws",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/san-npm/skills-ws"
+  }
+}