skills-ws 1.5.0 → 1.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Commit Media SARL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # skills.ws
 
-Agent skills for AI coding assistants. 77 skills across 8 categories — built for OpenClaw, Claude Code, Cursor, Codex, and any agent that supports the SKILL.md format.
+Agent skills for AI coding assistants. 81 skills across 8 categories — built for OpenClaw, Claude Code, Cursor, Codex, and any agent that supports the SKILL.md format.
 
 **Website:** [skills.ws](https://skills.ws) | **npm:** [skills-ws](https://www.npmjs.com/package/skills-ws) | **Docs:** [llms-full.txt](https://skills.ws/llms-full.txt)
 
@@ -19,7 +19,7 @@ Skills are `SKILL.md` files that give AI coding assistants specialized knowledge
 
 ---
 
-## Skills (77 across 8 categories)
+## Skills (81 across 8 categories)
 
 ### Marketing (15)
 SEO/GEO, content strategy, copywriting, paid ads, email sequences, PR/media, influencer marketing, brand strategy, webinars, blog engine, and more.
@@ -156,9 +156,9 @@ skills-ws/
 │   └── NpmDownloads.tsx    # Live npm download counter
 ├── lib/
 │   └── skills.ts           # Skill data access + TypeScript interfaces
-├── skills/                 # Raw SKILL.md files (77 directories)
+├── skills/                 # Raw SKILL.md files (81 directories)
 ├── public/
-│   ├── skills.json         # Skills database (77 skills, all metadata + content)
+│   ├── skills.json         # Skills database (81 skills, all metadata + content)
 │   ├── llms.txt            # LLM-readable skill index
 │   ├── llms-full.txt       # Full content dump for LLMs
 │   ├── robots.txt          # Crawl directives
@@ -170,7 +170,7 @@ skills-ws/
 
 Static export generates ~85 pages:
 - Homepage + docs + CLI + FAQ + 404
-- 77 individual skill detail pages
+- 81 individual skill detail pages
 - XML sitemap
 
 No server needed — deploy to any static host (Vercel, Netlify, GitHub Pages, S3).

package/bin/cli.mjs

@@ -2,9 +2,8 @@
 
 import { readdir, readFile, copyFile, mkdir, stat } from "node:fs/promises";
 import { join, dirname } from "node:path";
-import { createInterface } from "node:readline";
-import { fileURLToPath } from "node:url";
 import readline from "node:readline";
+import { fileURLToPath } from "node:url";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SKILLS_DIR = join(__dirname, "..", "skills");
@@ -266,142 +265,121 @@ async function detectTarget() {
   return defaultTarget;
 }
 
-// ── Main ─────────────────────────────────────────────────────
-
-async function main() {
-  const args = process.argv.slice(2);
-  const skills = await getSkills();
-
-  await playBanner();
+// ── Interactive Picker ───────────────────────────────────────
 
-  if (args[0] === "list" || args[0] === "ls") {
-    for (const s of skills) {
-      process.stdout.write(`  ${GREEN}${s.name.padEnd(24)}${R}${DIM}${s.desc.slice(0, 55)}${R}\n`);
-    }
-    process.stdout.write(`\n  ${DIM}${skills.length} skills | npx skills-ws install <name>${R}\n\n`);
-    return;
+async function interactivePick(skills) {
+  for (let i = 0; i < skills.length; i++) {
+    process.stdout.write(
+      `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
+    );
   }
-
-  if (args[0] === "install" || args[0] === "add") {
-    const names = args.slice(1);
-
-    if (names.length === 0) {
-      for (let i = 0; i < skills.length; i++) {
-        process.stdout.write(
-          `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
-        );
-      }
-      process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
-
-      const rl = createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
-      rl.close();
-
-      if (answer.trim().toLowerCase() === "all") {
-        names.push(...skills.map((s) => s.name));
-      } else {
-        for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
-          const num = parseInt(part);
-          if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
-          else names.push(part);
-        }
-      }
+  process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
+  rl.close();
+
+  const names = [];
+  if (answer.trim().toLowerCase() === "all") {
+    names.push(...skills.map((s) => s.name));
+  } else {
+    for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
+      const num = parseInt(part);
+      if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
+      else names.push(part);
     }
+  }
+  return names;
+}
 
-    if (names.length === 0) {
-      process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
-      return;
-    }
+async function installSkills(names, skills, customDir) {
+  if (names.length === 0) {
+    process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
+    return;
+  }
 
-    const target = await detectTarget();
-    process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
+  const target = customDir || await detectTarget();
+  process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
 
-    let installed = 0;
-    for (const name of names) {
-      const skill = skills.find((s) => s.name === name);
-      if (!skill) {
-        process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
-        continue;
-      }
-      await copyDir(skill.dir, join(target, name));
-      installed++;
+  let installed = 0;
+  for (const name of names) {
+    const skill = skills.find((s) => s.name === name);
+    if (!skill) {
+      process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
+      continue;
     }
+    await copyDir(skill.dir, join(target, name));
+    installed++;
+  }
 
-    await playInstallProgress(installed);
-    process.stdout.write("\n");
+  await playInstallProgress(installed);
+  process.stdout.write("\n");
 
-    for (const name of names) {
-      if (skills.find((s) => s.name === name)) {
-        process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
-      }
+  for (const name of names) {
+    if (skills.find((s) => s.name === name)) {
+      process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
     }
-    process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
-    return;
   }
+  process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
+}
 
-  // No args = interactive install (same as `install`)
-  if (!args[0] || args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
-    if (args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
-      process.stdout.write(`  ${B}Usage:${R}\n\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws${R}                    Interactive picker\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws list${R}              List all skills\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws install <name>${R}     Install specific skill(s)\n`);
-      process.stdout.write(`    ${CYAN}npx skills-ws install all${R}        Install everything\n`);
-      process.stdout.write(`\n  ${DIM}${skills.length} skills | skills.ws${R}\n\n`);
-      return;
-    }
-
-    // Interactive picker
-    for (let i = 0; i < skills.length; i++) {
-      process.stdout.write(
-        `  ${GRAY}${String(i + 1).padStart(2)}${R} ${GREEN}${skills[i].name.padEnd(24)}${R}${DIM}${skills[i].desc.slice(0, 50)}${R}\n`
-      );
-    }
-    process.stdout.write(`\n  ${YELLOW}Enter numbers or names (comma-separated), or 'all':${R}\n`);
+// ── Main ─────────────────────────────────────────────────────
 
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await new Promise((resolve) => rl.question(`  ${CYAN}> ${R}`, resolve));
-    rl.close();
+async function main() {
+  const rawArgs = process.argv.slice(2);
+  const skills = await getSkills();
 
-    const names = [];
-    if (answer.trim().toLowerCase() === "all") {
-      names.push(...skills.map((s) => s.name));
+  // Parse --dir flag from anywhere in args
+  let customDir = null;
+  const args = [];
+  for (let i = 0; i < rawArgs.length; i++) {
+    if (rawArgs[i] === "--dir" && i + 1 < rawArgs.length) {
+      customDir = rawArgs[i + 1];
+      i++; // skip next
     } else {
-      for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
-        const num = parseInt(part);
-        if (!isNaN(num) && num >= 1 && num <= skills.length) names.push(skills[num - 1].name);
-        else names.push(part);
-      }
+      args.push(rawArgs[i]);
     }
+  }
 
-    if (names.length === 0) {
-      process.stdout.write(`  ${DIM}Nothing selected.${R}\n`);
-      return;
+  await playBanner();
+
+  if (args[0] === "list" || args[0] === "ls") {
+    for (const s of skills) {
+      process.stdout.write(`  ${GREEN}${s.name.padEnd(24)}${R}${DIM}${s.desc.slice(0, 55)}${R}\n`);
     }
+    process.stdout.write(`\n  ${DIM}${skills.length} skills | npx skills-ws install <name>${R}\n\n`);
+    return;
+  }
 
-    const target = await detectTarget();
-    process.stdout.write(`\n  ${DIM}${target}${R}\n\n`);
+  if (args[0] === "install" || args[0] === "add") {
+    let names = args.slice(1);
 
-    let installed = 0;
-    for (const name of names) {
-      const skill = skills.find((s) => s.name === name);
-      if (!skill) {
-        process.stdout.write(`  ${YELLOW}skip${R} ${name} ${DIM}(not found)${R}\n`);
-        continue;
-      }
-      await copyDir(skill.dir, join(target, name));
-      installed++;
+    // Handle "all" keyword
+    if (names.includes("all")) {
+      names = skills.map((s) => s.name);
+    } else if (names.length === 0) {
+      names = await interactivePick(skills);
     }
 
-    await playInstallProgress(installed);
-    process.stdout.write("\n");
+    await installSkills(names, skills, customDir);
+    return;
+  }
 
-    for (const name of names) {
-      if (skills.find((s) => s.name === name)) {
-        process.stdout.write(`  ${GREEN}+${R} ${name}\n`);
-      }
-    }
-    process.stdout.write(`\n  ${DIM}skills.ws${R}\n\n`);
+  if (args[0] === "help" || args[0] === "-h" || args[0] === "--help") {
+    process.stdout.write(`  ${B}Usage:${R}\n\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws${R}                    Interactive picker\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws list${R}              List all skills\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install <name>${R}     Install specific skill(s)\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install all${R}        Install everything\n`);
+    process.stdout.write(`    ${CYAN}npx skills-ws install --dir .${R}    Install to custom directory\n`);
+    process.stdout.write(`\n  ${DIM}${skills.length} skills | skills.ws${R}\n\n`);
+    return;
+  }
+
+  // No args = interactive install
+  if (!args[0]) {
+    const names = await interactivePick(skills);
+    await installSkills(names, skills, customDir);
     return;
   }
 }

package/package.json

@@ -1,33 +1,9 @@
 {
   "name": "skills-ws",
-  "version": "1.5.0",
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
-  "dependencies": {
-    "@vercel/analytics": "^1.6.1",
-    "next": "14.2.35",
-    "react": "^18",
-    "react-dom": "^18",
-    "react-markdown": "^10.1.0",
-    "remark-gfm": "^4.0.1",
-    "three": "^0.183.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20",
-    "@types/react": "^18",
-    "@types/react-dom": "^18",
-    "@types/three": "^0.183.1",
-    "postcss": "^8",
-    "tailwindcss": "^3.4.1",
-    "typescript": "^5"
-  },
-  "description": "77 expert agent skills for AI coding assistants — marketing, growth, web3, dev, design & operations. Built for OpenClaw, Claude Code, Cursor, and Codex.",
+  "version": "1.5.1",
+  "description": "81 agent skills for AI coding assistants \u2014 marketing, growth, web3, dev, design & operations. Built for OpenClaw, Claude Code, Cursor, and Codex.",
   "bin": {
-    "skills-ws": "bin/cli.mjs"
+    "skills-ws": "./bin/cli.mjs"
   },
   "keywords": [
     "ai",
@@ -57,11 +33,24 @@
     "design-system",
     "auth"
   ],
+  "author": "Commit Media <bob@openletz.com> (https://openletz.com)",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/san-npm/skills-ws"
   },
   "homepage": "https://skills.ws",
-  "author": "skills.ws"
-}
+  "bugs": {
+    "url": "https://github.com/san-npm/skills-ws/issues"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/CHANGELOG.md

@@ -1,39 +0,0 @@
-# Changelog
-
-## [Unreleased] — 2026-02-28
-
-### Added — Premium Skills Tier
-
-**10 premium skills added:**
-- `aws-production-deploy` — ECS, RDS, CloudFront, Route53, SSL, monitoring, CDK/Terraform
-- `stripe-billing` — Subscriptions, usage-based billing, webhooks, customer portal, metering
-- `security-hardening` — OWASP Top 10, CSP, rate limiting, auth, pentesting checklist
-- `ai-agent-building` — CrewAI, LangGraph, tool use, memory systems, multi-agent orchestration
-- `nextjs-performance` — Core Web Vitals, ISR/SSG, edge functions, bundle analysis
-- `postgres-mastery` — Indexes, query optimization, partitioning, pgvector, migrations
-- `docker-production` — Multi-stage builds, compose, secrets, health checks, security
-- `api-design` — REST best practices, versioning, pagination, OpenAPI, rate limiting
-- `monitoring-observability` — Prometheus, Grafana, Datadog, SLOs, OpenTelemetry
-- `ci-cd-pipeline` — GitHub Actions, testing pyramid, deployment gates, feature flags
-
-**UI changes:**
-- Premium skills show 🔒 lock icon and amber "Premium" badge on skill cards
-- Premium skill detail pages show 30-line preview with gradient fade, then paywall CTA
-- CTA button: "Get all premium skills — $49/year" linking to `NEXT_PUBLIC_PREMIUM_URL` env var
-- New "★ Premium" filter button in skill category bar
-- Premium skill count shown in footer stats (amber colored)
-- Free skills remain fully accessible — no changes
-
-**Files changed:**
-- `lib/skills.ts` — Added `premium?: boolean` to Skill interface
-- `skills.json` + `public/skills.json` — 10 new skills with `"premium": true`
-- `components/SkillsGrid.tsx` — Premium badge, lock icon, premium filter button
-- `components/PremiumGate.tsx` — New component: preview + paywall CTA
-- `app/skills/[name]/page.tsx` — Premium badge on detail page, PremiumGate for premium content
-- `app/page.tsx` — Premium skills count in stats section
-
-**Notes:**
-- Total skills: 80 (70 free + 10 premium)
-- Static export — paywall is client-side only (intentionally bypassable for v1)
-- CLI package unchanged — premium skills are web-only
-- Build passes: 86 static pages generated