mkt-skills 1.0.0

package/README.md

@@ -0,0 +1,63 @@
+# mkt-skills
+
+Install Claude Code marketing skills from [marketingskills.directory](https://marketingskills.directory).
+
+## Quick Start
+
+```bash
+npx mkt-skills install seo-content
+```
+
+This downloads the skill and saves it to `~/.claude/skills/seo-content/SKILL.md`, ready for Claude Code to use.
+
+## Commands
+
+### Install a skill
+
+```bash
+npx mkt-skills install <slug>
+npx mkt-skills install seo-content --force   # overwrite existing
+```
+
+### List available skills
+
+```bash
+npx mkt-skills list
+npx mkt-skills list --category=seo
+```
+
+### Search skills
+
+```bash
+npx mkt-skills search "email automation"
+npx mkt-skills search content
+```
+
+### Skill details
+
+```bash
+npx mkt-skills info marketing-audit
+```
+
+### Uninstall a skill
+
+```bash
+npx mkt-skills uninstall seo-content
+```
+
+## Requirements
+
+- Node.js 18 or later
+- Claude Code (skills are installed to `~/.claude/skills/`)
+
+## Local Development
+
+Override the API URL for testing against a local WordPress instance:
+
+```bash
+MKT_API_URL=http://localhost:8080/wp-json/mkt/v1 npx mkt-skills list
+```
+
+## License
+
+MIT

package/bin/mkt-skills.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import { install, list, search, info, uninstall } from '../lib/commands.mjs';
+
+const [,, command, ...args] = process.argv;
+
+const commands = { install, list, search, info, uninstall };
+
+if (!command || command === '--help' || command === '-h') {
+  showHelp();
+  process.exit(0);
+}
+
+if (command === '--version' || command === '-v') {
+  console.log('mkt-skills 1.0.0');
+  process.exit(0);
+}
+
+if (!commands[command]) {
+  console.error(`Unknown command: ${command}\nRun "mkt-skills --help" for usage.`);
+  process.exit(1);
+}
+
+try {
+  await commands[command](args);
+} catch (err) {
+  if (err.name === 'AbortError') {
+    console.error('Request timed out. Check your internet connection.');
+  } else if (err.cause?.code === 'ENOTFOUND' || err.cause?.code === 'ECONNREFUSED') {
+    console.error('Could not connect to marketingskills.directory. Check your internet connection.');
+  } else {
+    console.error(`Error: ${err.message}`);
+  }
+  process.exit(1);
+}
+
+function showHelp() {
+  console.log(`
+Marketing Skills Directory CLI
+
+Usage:
+  npx mkt-skills <command> [args]
+
+Commands:
+  install <slug>     Install a skill to ~/.claude/skills/
+  list               List all available skills
+  search <keyword>   Search skills by keyword
+  info <slug>        Show details about a skill
+  uninstall <slug>   Remove an installed skill
+
+Options:
+  --help, -h         Show this help
+  --version, -v      Show version
+
+Examples:
+  npx mkt-skills install seo-content
+  npx mkt-skills search "email automation"
+  npx mkt-skills list --category=seo
+  npx mkt-skills info marketing-audit
+
+https://marketingskills.directory
+`);
+}

package/lib/api.mjs

@@ -0,0 +1,43 @@
+const BASE_URL = process.env.MKT_API_URL || 'https://marketingskills.directory/wp-json/mkt/v1';
+const TIMEOUT  = 30_000;
+
+async function request(path) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT);
+
+  try {
+    const res = await fetch(`${BASE_URL}${path}`, {
+      signal: controller.signal,
+      headers: { 'User-Agent': 'mkt-skills-cli/1.0.0' },
+    });
+    return res;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function fetchCatalog() {
+  const res = await request('/catalog');
+  if (!res.ok) throw new Error(`Failed to fetch catalog (HTTP ${res.status})`);
+  return res.json();
+}
+
+export async function fetchInstall(slug) {
+  const res = await request(`/install/${encodeURIComponent(slug)}`);
+
+  if (res.status === 403) {
+    const data = await res.json();
+    const err = new Error(data.message);
+    err.code = 'PREMIUM';
+    err.url = data.purchase_url;
+    throw err;
+  }
+
+  if (res.status === 404) {
+    const data = await res.json();
+    throw Object.assign(new Error(data.message), { code: 'NOT_FOUND' });
+  }
+
+  if (!res.ok) throw new Error(`Install failed (HTTP ${res.status})`);
+  return res.json();
+}

package/lib/commands.mjs

@@ -0,0 +1,224 @@
+import { mkdir, rm, access, writeFile } from 'fs/promises';
+import { createInterface } from 'readline';
+import { fetchCatalog, fetchInstall } from './api.mjs';
+import { skillDir, skillFile, installedSlugs } from './paths.mjs';
+import { bold, dim, green, red, yellow, cyan } from './ui.mjs';
+
+// ── install ─────────────────────────────────────────────────
+
+export async function install(args) {
+  const force = args.includes('--force') || args.includes('-f');
+  const slug  = args.find(a => !a.startsWith('-'));
+
+  if (!slug) {
+    console.error(`Usage: mkt-skills install <slug> [--force]\n`);
+    process.exit(1);
+  }
+
+  const dest = skillFile(slug);
+
+  if (!force) {
+    try {
+      await access(dest);
+      const ok = await confirm(`Skill "${slug}" is already installed. Overwrite?`);
+      if (!ok) {
+        console.log('Aborted.');
+        return;
+      }
+    } catch { /* not installed — proceed */ }
+  }
+
+  let data;
+  try {
+    data = await fetchInstall(slug);
+  } catch (err) {
+    if (err.code === 'PREMIUM') {
+      console.log(`\n${red('x')} ${bold(`"${slug}"`)} is a premium skill.`);
+      console.log(`  ${dim('->')} Purchase at: ${cyan(err.url)}\n`);
+      process.exit(1);
+    }
+    if (err.code === 'NOT_FOUND') {
+      console.log(`\n${red('x')} Skill "${slug}" not found.`);
+      console.log(`  ${dim('->')} Browse available skills: ${cyan('npx mkt-skills list')}\n`);
+      process.exit(1);
+    }
+    throw err;
+  }
+
+  await mkdir(skillDir(slug), { recursive: true });
+  await writeFile(dest, data.content, 'utf-8');
+
+  console.log(`\n${green('+')} Installed ${bold(`"${data.title}"`)} (${data.lines} lines)`);
+  console.log(`  ${dim('->')} ${dest}\n`);
+}
+
+// ── list ────────────────────────────────────────────────────
+
+export async function list(args) {
+  const catFlag = args.find(a => a.startsWith('--category='));
+  const catFilter = catFlag ? catFlag.split('=')[1].toLowerCase() : null;
+
+  const catalog   = await fetchCatalog();
+  const installed = new Set(await installedSlugs());
+
+  let items = catalog;
+  if (catFilter) {
+    items = items.filter(s => s.categories.some(c => c.toLowerCase().includes(catFilter)));
+  }
+
+  if (items.length === 0) {
+    console.log(catFilter
+      ? `No skills found in category "${catFilter}".`
+      : 'No skills available.');
+    return;
+  }
+
+  console.log(`\n${bold('Marketing Skills Directory')} (${items.length} skills)\n`);
+
+  const slugW  = Math.min(30, Math.max(4, ...items.map(s => s.slug.length)));
+  const titleW = Math.min(35, Math.max(5, ...items.map(s => s.title.length)));
+
+  const header = [
+    'SLUG'.padEnd(slugW),
+    'TITLE'.padEnd(titleW),
+    'LINES'.padStart(5),
+    'PRICE'.padEnd(7),
+    'CATEGORY',
+  ].join('  ');
+
+  console.log(dim(header));
+  console.log(dim('-'.repeat(header.length)));
+
+  for (const s of items) {
+    const inst = installed.has(s.slug) ? green(' [installed]') : '';
+    const price = s.price === 'paid' ? yellow('paid') : green('free');
+    const cats = s.categories.join(', ') || '-';
+    console.log([
+      s.slug.padEnd(slugW),
+      (s.title.length > titleW ? s.title.slice(0, titleW - 1) + '\u2026' : s.title).padEnd(titleW),
+      String(s.lines).padStart(5),
+      price.padEnd(7 + (price.length - (s.price === 'paid' ? 4 : 4))),
+      cats,
+    ].join('  ') + inst);
+  }
+
+  console.log(`\n${dim('Install:')} npx mkt-skills install <slug>\n`);
+}
+
+// ── search ──────────────────────────────────────────────────
+
+export async function search(args) {
+  const query = args.filter(a => !a.startsWith('-')).join(' ').toLowerCase();
+
+  if (!query) {
+    console.error('Usage: mkt-skills search <keyword>\n');
+    process.exit(1);
+  }
+
+  const catalog = await fetchCatalog();
+  const results = catalog.filter(s =>
+    s.slug.includes(query) ||
+    s.title.toLowerCase().includes(query) ||
+    s.description.toLowerCase().includes(query) ||
+    s.categories.some(c => c.toLowerCase().includes(query))
+  );
+
+  if (results.length === 0) {
+    console.log(`\nNo skills found matching "${query}".`);
+    console.log(`${dim('->')} Browse all: ${cyan('npx mkt-skills list')}\n`);
+    return;
+  }
+
+  console.log(`\n${bold(`Search: "${query}"`)} (${results.length} results)\n`);
+
+  for (const s of results) {
+    const price = s.price === 'paid' ? yellow(' [premium]') : '';
+    const cats  = s.categories.length ? dim(` (${s.categories.join(', ')})`) : '';
+    console.log(`  ${bold(s.slug)}${price}${cats}`);
+    console.log(`  ${s.description}`);
+    console.log('');
+  }
+
+  console.log(`${dim('Install:')} npx mkt-skills install <slug>\n`);
+}
+
+// ── info ────────────────────────────────────────────────────
+
+export async function info(args) {
+  const slug = args.find(a => !a.startsWith('-'));
+
+  if (!slug) {
+    console.error('Usage: mkt-skills info <slug>\n');
+    process.exit(1);
+  }
+
+  const catalog = await fetchCatalog();
+  const skill   = catalog.find(s => s.slug === slug);
+
+  if (!skill) {
+    console.log(`\n${red('x')} Skill "${slug}" not found.`);
+    // suggest close matches
+    const close = catalog.filter(s => s.slug.includes(slug) || slug.includes(s.slug)).slice(0, 3);
+    if (close.length) {
+      console.log(`\n  Did you mean?`);
+      close.forEach(s => console.log(`    ${cyan(s.slug)}  ${s.title}`));
+    }
+    console.log('');
+    process.exit(1);
+  }
+
+  const installed = (await installedSlugs()).includes(slug);
+  const priceLabel = skill.price === 'paid' ? yellow('Premium') : green('Free');
+  const secLabel = skill.security_level === 'safe' ? green('safe') : (skill.security_level || dim('unknown'));
+
+  console.log(`\n${bold(skill.title)}\n`);
+  console.log(`  Slug:        ${skill.slug}`);
+  console.log(`  Price:       ${priceLabel}`);
+  console.log(`  Lines:       ${skill.lines}`);
+  console.log(`  Categories:  ${skill.categories.join(', ') || '-'}`);
+  console.log(`  Security:    ${secLabel}`);
+  console.log(`  Downloads:   ${skill.downloads}`);
+  console.log(`  Installed:   ${installed ? green('yes') : 'no'}`);
+  console.log(`\n  ${dim('Description:')}`);
+  console.log(`  ${skill.description}`);
+  console.log(`\n  ${dim('Install:')}`);
+  console.log(`  npx mkt-skills install ${skill.slug}`);
+  console.log(`\n  ${dim('Web:')}`);
+  console.log(`  https://marketingskills.directory/skill/${skill.slug}/\n`);
+}
+
+// ── uninstall ───────────────────────────────────────────────
+
+export async function uninstall(args) {
+  const slug = args.find(a => !a.startsWith('-'));
+
+  if (!slug) {
+    console.error('Usage: mkt-skills uninstall <slug>\n');
+    process.exit(1);
+  }
+
+  const dir = skillDir(slug);
+
+  try {
+    await access(dir);
+  } catch {
+    console.log(`\n${red('x')} Skill "${slug}" is not installed.\n`);
+    process.exit(1);
+  }
+
+  await rm(dir, { recursive: true, force: true });
+  console.log(`\n${green('+')} Uninstalled "${slug}"`);
+  console.log(`  ${dim('->')} Removed ${dir}\n`);
+}
+
+// ── helpers ─────────────────────────────────────────────────
+
+function confirm(message) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question(`${message} (y/N) `, answer => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() === 'y');
+    });
+  });
+}

package/lib/paths.mjs

@@ -0,0 +1,22 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { readdir } from 'fs/promises';
+
+const SKILLS_ROOT = join(homedir(), '.claude', 'skills');
+
+export function skillDir(slug) {
+  return join(SKILLS_ROOT, slug);
+}
+
+export function skillFile(slug) {
+  return join(skillDir(slug), 'SKILL.md');
+}
+
+export async function installedSlugs() {
+  try {
+    const entries = await readdir(SKILLS_ROOT, { withFileTypes: true });
+    return entries.filter(e => e.isDirectory()).map(e => e.name);
+  } catch {
+    return [];
+  }
+}

package/lib/ui.mjs

@@ -0,0 +1,14 @@
+// ANSI color helpers — zero dependencies.
+
+const enabled = process.stdout.isTTY && !process.env.NO_COLOR;
+
+const wrap = (code, reset) => enabled
+  ? s => `\x1b[${code}m${s}\x1b[${reset}m`
+  : s => s;
+
+export const bold   = wrap('1', '22');
+export const dim    = wrap('2', '22');
+export const green  = wrap('32', '39');
+export const red    = wrap('31', '39');
+export const yellow = wrap('33', '39');
+export const cyan   = wrap('36', '39');

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "mkt-skills",
+  "version": "1.0.0",
+  "description": "Install Claude Code marketing skills from marketingskills.directory",
+  "type": "module",
+  "bin": {
+    "mkt-skills": "./bin/mkt-skills.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skills",
+    "marketing",
+    "seo",
+    "ai",
+    "cli"
+  ],
+  "author": "Thrivemattic",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sandeepkelvadi/mkt-skills-dir"
+  },
+  "homepage": "https://marketingskills.directory"
+}