@jefflee2002/agentskills 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# agentskills
+
+> CLI tool to install AI agent skills from the [AgentSkills marketplace](https://agentskills.cv)
+
+Install skills directly from agentskills.cv to all your AI agents with a single command.
+
+## Features
+
+- 🚀 **One command, every agent** - Automatically detects and installs to Claude Code, Cursor, Codex, OpenClaw, and more
+- 🔍 **Search marketplace** - Find skills directly from the CLI
+- 🔄 **Convert skills** - Convert existing skills to OpenClaw format
+- 📦 **Manage installations** - List installed skills across all agents
+
+## Quick Start
+
+```bash
+# Install a skill
+npx agentskills install notebooklm
+
+# Search for skills
+npx agentskills search "git commit"
+
+# List installed skills
+npx agentskills list
+
+# Show detected agents
+npx agentskills agents
+```
+
+## Installation
+
+No installation required! Use `npx` to run the CLI directly:
+
+```bash
+npx agentskills <command>
+```
+
+Or install globally:
+
+```bash
+npm install -g agentskills
+```
+
+## Usage
+
+### Install a skill
+
+```bash
+# Install to project (local)
+npx agentskills install <skill-name>
+
+# Install globally
+npx agentskills install <skill-name> --global
+```
+
+### Search skills
+
+```bash
+npx agentskills search "your query"
+```
+
+### Convert skills
+
+Convert existing skill files or GitHub repos to OpenClaw format:
+
+```bash
+# Convert local file
+npx agentskills convert ./my-skill.md
+
+# Convert GitHub repo
+npx agentskills convert https://github.com/user/repo
+
+# Convert and install
+npx agentskills convert ./my-skill.md --install
+```
+
+### List installed skills
+
+```bash
+# List project skills
+npx agentskills list
+
+# List global skills
+npx agentskills list --global
+```
+
+### Show detected agents
+
+```bash
+npx agentskills agents
+```
+
+## Supported Agents
+
+- **Claude Code** - `.claude/skills/` (project) or `~/.claude/skills/` (global)
+- **Cursor** - `.cursor/skills/` (project) or `~/.cursor/skills/` (global)
+- **Codex CLI** - `.codex/skills/` (project) or `~/.codex/skills/` (global)
+- **OpenClaw** - `skills/` (project) or `~/.openclaw/skills/` (global)
+- **OpenCode** - `.opencode/skills/` (project) or `~/.opencode/skills/` (global)
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `install <name>` | Install a skill to detected agents |
+| `search <query>` | Search skills on the marketplace |
+| `convert <source>` | Convert file or URL to OpenClaw format |
+| `list` | List installed skills |
+| `agents` | Show detected AI agents |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--global, -g` | Install to global skills directory (~/) |
+| `--install` | With convert: install after converting |
+| `--help, -h` | Show help message |
+| `--version, -v` | Show version |
+
+## Examples
+
+```bash
+# Install a skill globally
+npx agentskills install commit-analyzer --global
+
+# Search for git-related skills
+npx agentskills search "git"
+
+# Convert a GitHub skill to OpenClaw and install
+npx agentskills convert https://github.com/user/skill-repo --install
+
+# List all globally installed skills
+npx agentskills list --global
+```
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AGENTSKILLS_API` | API base URL | `https://agentskills.cv/api` |
+
+## License
+
+MIT
+
+## Links
+
+- [Website](https://agentskills.cv)
+- [GitHub](https://github.com/jeffleeismyhero/agentskills)
+- [Documentation](https://agentskills.cv/cli)

package/dist/cli.js

@@ -0,0 +1,432 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { parseArgs } from "util";
+import { readFileSync, existsSync as existsSync3 } from "fs";
+
+// src/agents.ts
+import { existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+var AGENTS = [
+  { name: "Claude Code", projectPath: ".claude/skills", globalPath: join(homedir(), ".claude", "skills") },
+  { name: "Cursor", projectPath: ".cursor/skills", globalPath: join(homedir(), ".cursor", "skills") },
+  { name: "Codex CLI", projectPath: ".codex/skills", globalPath: join(homedir(), ".codex", "skills") },
+  { name: "OpenClaw", projectPath: "skills", globalPath: join(homedir(), ".openclaw", "skills") },
+  { name: "OpenCode", projectPath: ".opencode/skills", globalPath: join(homedir(), ".opencode", "skills") }
+];
+function detectAgents(cwd) {
+  return AGENTS.map((agent) => {
+    const projectDir = join(cwd, agent.projectPath, "..");
+    const globalDir = join(agent.globalPath, "..");
+    const detected = existsSync(projectDir) || existsSync(globalDir);
+    return { ...agent, detected };
+  });
+}
+
+// src/api.ts
+var API_BASE = process.env.AGENTSKILLS_API || "https://agentskills.cv/api";
+async function searchSkills(query, limit = 10) {
+  const params = new URLSearchParams({ q: query, limit: limit.toString() });
+  const res = await fetch(`${API_BASE}/skills?${params}`);
+  if (!res.ok) throw new Error(`API error: ${res.status}`);
+  return res.json();
+}
+async function getSkillByName(name) {
+  const params = new URLSearchParams({ q: name, limit: "20" });
+  const res = await fetch(`${API_BASE}/skills?${params}`);
+  if (!res.ok) throw new Error(`API error: ${res.status}`);
+  const json = await res.json();
+  const lower = name.toLowerCase();
+  return json.data.find((s) => s.name.toLowerCase() === lower) || json.data[0] || null;
+}
+function parseZipFiles(buffer) {
+  const view = new DataView(buffer);
+  const files = [];
+  let offset = 0;
+  const decoder = new TextDecoder();
+  while (offset < buffer.byteLength - 4) {
+    const sig = view.getUint32(offset, true);
+    if (sig !== 67324752) break;
+    const compressedSize = view.getUint32(offset + 18, true);
+    const filenameLen = view.getUint16(offset + 26, true);
+    const extraLen = view.getUint16(offset + 28, true);
+    const filenameBytes = new Uint8Array(buffer, offset + 30, filenameLen);
+    const path = decoder.decode(filenameBytes);
+    const contentStart = offset + 30 + filenameLen + extraLen;
+    const contentBytes = new Uint8Array(buffer, contentStart, compressedSize);
+    const content = decoder.decode(contentBytes);
+    files.push({ path, content });
+    offset = contentStart + compressedSize;
+  }
+  return files;
+}
+async function fetchOpenClawExport(skillId) {
+  const res = await fetch(`${API_BASE}/skills/${skillId}/export/openclaw`);
+  if (!res.ok) throw new Error(`Export failed: ${res.status}`);
+  const contentType = res.headers.get("content-type") || "";
+  if (contentType.includes("application/zip")) {
+    const buffer = await res.arrayBuffer();
+    const files = parseZipFiles(buffer);
+    const skillMdFile = files.find((f) => f.path === "SKILL.md");
+    const resources = files.filter((f) => f.path !== "SKILL.md");
+    return {
+      skillMd: skillMdFile?.content || "",
+      resources
+    };
+  }
+  const skillMd = await res.text();
+  return { skillMd, resources: [] };
+}
+async function convertPaste(content, filename) {
+  const res = await fetch(`${API_BASE}/converter/paste`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ content, filename })
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: "Conversion failed" }));
+    throw new Error(err.error || `Conversion failed: ${res.status}`);
+  }
+  const json = await res.json();
+  return json.data;
+}
+async function convertGithub(url) {
+  const res = await fetch(`${API_BASE}/converter/github`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ url })
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({ error: "GitHub import failed" }));
+    throw new Error(err.error || `GitHub import failed: ${res.status}`);
+  }
+  const json = await res.json();
+  return json.data;
+}
+
+// src/installer.ts
+import { existsSync as existsSync2, mkdirSync, writeFileSync, readdirSync } from "fs";
+import { join as join2, dirname } from "path";
+function sanitizeDirName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function isSafePath(resourcePath) {
+  const normalized = resourcePath.replace(/\\/g, "/");
+  return !normalized.startsWith("/") && !normalized.includes("..");
+}
+function installSkill(skillName, skillMd, agents, cwd, global, resources) {
+  const dirName = sanitizeDirName(skillName);
+  const results = [];
+  const detectedAgents = agents.filter((a) => a.detected);
+  if (detectedAgents.length === 0) {
+    detectedAgents.push(agents.find((a) => a.name === "Claude Code"));
+  }
+  for (const agent of detectedAgents) {
+    const basePath = global ? agent.globalPath : join2(cwd, agent.projectPath);
+    const skillDir = join2(basePath, dirName);
+    try {
+      mkdirSync(skillDir, { recursive: true });
+      writeFileSync(join2(skillDir, "SKILL.md"), skillMd, "utf-8");
+      let filesWritten = 1;
+      if (resources && resources.length > 0) {
+        for (const resource of resources) {
+          if (!isSafePath(resource.path)) continue;
+          const filePath = join2(skillDir, resource.path);
+          mkdirSync(dirname(filePath), { recursive: true });
+          writeFileSync(filePath, resource.content, "utf-8");
+          filesWritten++;
+        }
+      }
+      results.push({ agent: agent.name, path: skillDir, success: true, filesWritten });
+    } catch (err) {
+      results.push({
+        agent: agent.name,
+        path: skillDir,
+        success: false,
+        filesWritten: 0,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return results;
+}
+function listInstalledSkills(agents, cwd, global) {
+  const results = [];
+  for (const agent of agents.filter((a) => a.detected)) {
+    const basePath = global ? agent.globalPath : join2(cwd, agent.projectPath);
+    const skills = [];
+    if (existsSync2(basePath)) {
+      try {
+        const entries = readdirSync(basePath, { withFileTypes: true });
+        for (const entry of entries) {
+          if (entry.isDirectory() && existsSync2(join2(basePath, entry.name, "SKILL.md"))) {
+            skills.push(entry.name);
+          }
+        }
+      } catch {
+      }
+    }
+    if (skills.length > 0) {
+      results.push({ agent: agent.name, skills });
+    }
+  }
+  return results;
+}
+
+// src/cli.ts
+var bold = (s) => `\x1B[1m${s}\x1B[0m`;
+var dim = (s) => `\x1B[2m${s}\x1B[0m`;
+var green = (s) => `\x1B[32m${s}\x1B[0m`;
+var red = (s) => `\x1B[31m${s}\x1B[0m`;
+var yellow = (s) => `\x1B[33m${s}\x1B[0m`;
+var cyan = (s) => `\x1B[36m${s}\x1B[0m`;
+function printHelp() {
+  console.log(`
+${bold("agentskills")} - Install AI agent skills from agentskills.cv
+
+${bold("USAGE")}
+  npx agentskills ${cyan("<command>")} [options]
+
+${bold("COMMANDS")}
+  ${cyan("install")} <name>    Install a skill to detected agents
+  ${cyan("search")}  <query>   Search skills on the marketplace
+  ${cyan("convert")} <source>  Convert file or URL to OpenClaw format
+  ${cyan("list")}              List installed skills
+  ${cyan("agents")}            Show detected AI agents
+
+${bold("OPTIONS")}
+  ${dim("--global, -g")}      Install to global skills directory (~/)
+  ${dim("--install")}          With convert: install after converting
+  ${dim("--help, -h")}        Show this help message
+  ${dim("--version, -v")}     Show version
+
+${bold("EXAMPLES")}
+  npx agentskills install commit-analyzer
+  npx agentskills install commit-analyzer --global
+  npx agentskills search "git commit"
+  npx agentskills convert ./my-skill.md
+  npx agentskills convert https://github.com/user/repo
+  npx agentskills convert ./my-skill.md --install
+  npx agentskills list
+  npx agentskills agents
+`);
+}
+async function cmdInstall(skillName, global) {
+  const cwd = process.cwd();
+  console.log(dim("  Detecting installed agents..."));
+  const agents = detectAgents(cwd);
+  const detected = agents.filter((a) => a.detected);
+  if (detected.length === 0) {
+    console.log(yellow("  No agents detected. Will install to Claude Code directory."));
+  } else {
+    console.log(`  Found: ${detected.map((a) => cyan(a.name)).join(", ")}`);
+  }
+  console.log(dim(`  Searching for "${skillName}"...`));
+  const skill = await getSkillByName(skillName);
+  if (!skill) {
+    console.log(red(`  Error: Skill "${skillName}" not found on agentskills.cv`));
+    process.exit(1);
+  }
+  console.log(`  Found: ${bold(skill.name)} by ${dim(skill.author)} ${dim(`(${skill.category})`)}`);
+  console.log(dim("  Converting to OpenClaw format..."));
+  const { skillMd, resources } = await fetchOpenClawExport(skill.id);
+  if (resources.length > 0) {
+    console.log(`  Found ${cyan(resources.length.toString())} resource file(s)`);
+  }
+  const scope = global ? "global" : "project";
+  console.log(dim(`  Installing (${scope})...`));
+  const results = installSkill(skill.name, skillMd, agents, cwd, global, resources);
+  console.log("");
+  for (const r of results) {
+    if (r.success) {
+      const fileInfo = r.filesWritten > 1 ? dim(` (${r.filesWritten} files)`) : "";
+      console.log(`  ${green("\u2713")} ${r.agent}: ${dim(r.path)}${fileInfo}`);
+    } else {
+      console.log(`  ${red("\u2717")} ${r.agent}: ${r.error}`);
+    }
+  }
+  const successCount = results.filter((r) => r.success).length;
+  if (successCount > 0) {
+    console.log(`
+  ${green("Done!")} Installed ${bold(skill.name)} to ${successCount} agent(s).`);
+  } else {
+    console.log(`
+  ${red("Failed to install skill.")}`);
+    process.exit(1);
+  }
+}
+async function cmdSearch(query) {
+  console.log(dim(`  Searching for "${query}"...
+`));
+  const results = await searchSkills(query);
+  if (results.data.length === 0) {
+    console.log(yellow("  No skills found."));
+    return;
+  }
+  console.log(`  ${dim(`${results.total} results (showing ${results.data.length}):`)}
+`);
+  for (const skill of results.data) {
+    const stars = dim(`\u2605 ${skill.starsCount}`);
+    const cat = dim(`[${skill.category}]`);
+    console.log(`  ${bold(skill.name)} ${stars} ${cat}`);
+    console.log(`  ${dim(skill.description.length > 80 ? skill.description.slice(0, 80) + "..." : skill.description)}`);
+    console.log("");
+  }
+  console.log(dim(`  Install with: npx agentskills install <name>`));
+}
+function cmdList(global) {
+  const cwd = process.cwd();
+  const agents = detectAgents(cwd);
+  const results = listInstalledSkills(agents, cwd, global);
+  if (results.length === 0) {
+    console.log(yellow("  No skills installed."));
+    console.log(dim("  Install with: npx agentskills install <name>"));
+    return;
+  }
+  for (const { agent, skills } of results) {
+    console.log(`
+  ${bold(agent)} ${dim(`(${skills.length} skills)`)}`);
+    for (const skill of skills) {
+      console.log(`    ${green("\u2022")} ${skill}`);
+    }
+  }
+  console.log("");
+}
+function cmdAgents() {
+  const cwd = process.cwd();
+  const agents = detectAgents(cwd);
+  console.log(`
+  ${bold("Agent Detection Results")}
+`);
+  for (const agent of agents) {
+    const status = agent.detected ? green("\u2713 detected") : dim("not found");
+    console.log(`  ${agent.detected ? green("\u2022") : dim("\u2022")} ${bold(agent.name)} ${status}`);
+    console.log(`    ${dim(`project: ${agent.projectPath}/`)}`);
+    console.log(`    ${dim(`global:  ${agent.globalPath}/`)}`);
+    console.log("");
+  }
+}
+async function cmdConvert(source, install, global) {
+  const cwd = process.cwd();
+  const isUrl = source.startsWith("http://") || source.startsWith("https://") || source.startsWith("github.com");
+  let result;
+  if (isUrl) {
+    const url = source.startsWith("http") ? source : `https://${source}`;
+    console.log(dim(`  Importing from GitHub: ${url}`));
+    result = await convertGithub(url);
+  } else {
+    if (!existsSync3(source)) {
+      console.log(red(`  Error: File not found: ${source}`));
+      process.exit(1);
+    }
+    console.log(dim(`  Reading: ${source}`));
+    const content = readFileSync(source, "utf-8");
+    result = await convertPaste(content, source);
+  }
+  console.log("");
+  console.log(`  ${bold("Validation")} (score: ${result.validation.score >= 80 ? green(result.validation.score.toString()) : result.validation.score >= 50 ? yellow(result.validation.score.toString()) : red(result.validation.score.toString())}/100)`);
+  console.log("");
+  for (const check of result.validation.checks) {
+    const icon = check.passed ? green("\u2713") : check.autoFixed ? yellow("~") : dim("\xB7");
+    const suffix = check.autoFixed ? dim(" (auto-fixed)") : "";
+    console.log(`  ${icon} ${check.message}${suffix}`);
+  }
+  console.log("");
+  console.log(`  ${bold("Converted SKILL.md")} (${result.skillMd.length} bytes)`);
+  if (install) {
+    const agents = detectAgents(cwd);
+    const nameMatch = result.skillMd.match(/^name:\s*(.+)$/m);
+    const skillName = nameMatch ? nameMatch[1].trim() : "converted-skill";
+    const scope = global ? "global" : "project";
+    console.log(dim(`  Installing "${skillName}" (${scope})...`));
+    const results = installSkill(skillName, result.skillMd, agents, cwd, global);
+    console.log("");
+    for (const r of results) {
+      if (r.success) {
+        console.log(`  ${green("\u2713")} ${r.agent}: ${dim(r.path)}`);
+      } else {
+        console.log(`  ${red("\u2717")} ${r.agent}: ${r.error}`);
+      }
+    }
+    const successCount = results.filter((r) => r.success).length;
+    if (successCount > 0) {
+      console.log(`
+  ${green("Done!")} Converted and installed to ${successCount} agent(s).`);
+    }
+  } else {
+    const { writeFileSync: writeFileSync2 } = await import("fs");
+    writeFileSync2("SKILL.md", result.skillMd, "utf-8");
+    console.log(`  ${green("\u2713")} Written to ${bold("SKILL.md")}`);
+    console.log(dim(`  Tip: use --install to install directly, or --install -g for global`));
+  }
+}
+async function main() {
+  const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: {
+      global: { type: "boolean", short: "g", default: false },
+      install: { type: "boolean", default: false },
+      help: { type: "boolean", short: "h", default: false },
+      version: { type: "boolean", short: "v", default: false }
+    }
+  });
+  if (values.version) {
+    console.log("agentskills v0.1.0");
+    return;
+  }
+  if (values.help || positionals.length === 0) {
+    printHelp();
+    return;
+  }
+  const command = positionals[0];
+  const arg = positionals[1];
+  console.log("");
+  try {
+    switch (command) {
+      case "install":
+      case "add":
+      case "i":
+        if (!arg) {
+          console.log(red("  Error: Please specify a skill name."));
+          console.log(dim("  Usage: npx agentskills install <name>"));
+          process.exit(1);
+        }
+        await cmdInstall(arg, values.global);
+        break;
+      case "search":
+      case "s":
+        if (!arg) {
+          console.log(red("  Error: Please specify a search query."));
+          process.exit(1);
+        }
+        await cmdSearch(positionals.slice(1).join(" "));
+        break;
+      case "list":
+      case "ls":
+        cmdList(values.global);
+        break;
+      case "agents":
+        cmdAgents();
+        break;
+      case "convert":
+      case "c":
+        if (!arg) {
+          console.log(red("  Error: Please specify a file path or GitHub URL."));
+          console.log(dim("  Usage: npx agentskills convert <source>"));
+          process.exit(1);
+        }
+        await cmdConvert(arg, values.install, values.global);
+        break;
+      default:
+        console.log(red(`  Unknown command: ${command}`));
+        printHelp();
+        process.exit(1);
+    }
+  } catch (err) {
+    console.log(red(`
+  Error: ${err instanceof Error ? err.message : String(err)}`));
+    process.exit(1);
+  }
+}
+main();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@jefflee2002/agentskills",
+  "version": "0.1.0",
+  "description": "CLI tool to install AI agent skills from the AgentSkills marketplace",
+  "type": "module",
+  "bin": {
+    "agentskills": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --target node22 --clean",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "ai",
+    "agent",
+    "skills",
+    "claude",
+    "cursor",
+    "codex",
+    "openclaw"
+  ],
+  "author": "AgentSkills Team",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeffleeismyhero/agentskills.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://agentskills.cv",
+  "bugs": {
+    "url": "https://github.com/jeffleeismyhero/agentskills/issues"
+  },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0"
+  }
+}