@spardutti/claude-skills 1.0.0

package/bin/cli.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+
+import { fetchSkills } from "../lib/github.mjs";
+import { promptSkillSelection } from "../lib/prompt.mjs";
+import { installSkills } from "../lib/install.mjs";
+
+async function main() {
+  console.log("\n  Claude Skills Installer\n");
+
+  console.log("  Fetching available skills...\n");
+  const skills = await fetchSkills();
+
+  if (skills.length === 0) {
+    console.log("  No skills found.");
+    process.exit(0);
+  }
+
+  const selected = await promptSkillSelection(skills);
+
+  if (selected.length === 0) {
+    console.log("\n  No skills selected.");
+    process.exit(0);
+  }
+
+  console.log();
+  await installSkills(selected);
+  console.log(`\n  Done! ${selected.length} skill(s) installed.\n`);
+}
+
+main().catch((err) => {
+  if (err.name === "ExitPromptError") {
+    console.log("\n  Cancelled.\n");
+    process.exit(0);
+  }
+  console.error(`\n  Error: ${err.message}\n`);
+  process.exit(1);
+});

package/lib/github.mjs

@@ -0,0 +1,61 @@
+const REPO_OWNER = "Spardutti";
+const REPO_NAME = "claude-skills";
+const CONTENTS_API = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/contents/skills`;
+const RAW_BASE = `https://raw.githubusercontent.com/${REPO_OWNER}/${REPO_NAME}/main/skills`;
+
+export async function fetchSkills() {
+  const res = await fetch(CONTENTS_API, {
+    headers: { "User-Agent": "claude-skills-cli" },
+  });
+
+  if (!res.ok) {
+    if (res.status === 403) {
+      throw new Error("GitHub API rate limit exceeded. Try again later.");
+    }
+    throw new Error(`Failed to list skills: ${res.status} ${res.statusText}`);
+  }
+
+  const entries = await res.json();
+  const dirs = entries.filter((e) => e.type === "dir");
+
+  const results = await Promise.all(
+    dirs.map(async (dir) => {
+      try {
+        const url = `${RAW_BASE}/${dir.name}/SKILL.md`;
+        const r = await fetch(url, {
+          headers: { "User-Agent": "claude-skills-cli" },
+        });
+
+        if (!r.ok) {
+          console.warn(`  Warning: No SKILL.md found in ${dir.name}, skipping`);
+          return null;
+        }
+
+        const content = await r.text();
+        const { name, description } = parseFrontmatter(content, dir.name);
+
+        return { dirName: dir.name, name, description, content };
+      } catch {
+        console.warn(`  Warning: Failed to fetch ${dir.name}, skipping`);
+        return null;
+      }
+    })
+  );
+
+  return results.filter(Boolean);
+}
+
+function parseFrontmatter(content, fallbackName) {
+  const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
+  if (!match) {
+    return { name: fallbackName, description: "" };
+  }
+
+  const block = match[1];
+  const name =
+    block.match(/^name:\s*(.+)$/m)?.[1]?.trim() || fallbackName;
+  const description =
+    block.match(/^description:\s*(.+)$/m)?.[1]?.trim() || "";
+
+  return { name, description };
+}

package/lib/install.mjs

@@ -0,0 +1,13 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+
+export async function installSkills(skills, targetDir = process.cwd()) {
+  const baseDir = join(targetDir, ".claude", "skills");
+
+  for (const skill of skills) {
+    const skillDir = join(baseDir, skill.dirName);
+    await mkdir(skillDir, { recursive: true });
+    await writeFile(join(skillDir, "SKILL.md"), skill.content);
+    console.log(`  Installed: ${skill.name} → .claude/skills/${skill.dirName}/SKILL.md`);
+  }
+}

package/lib/prompt.mjs

@@ -0,0 +1,13 @@
+import { checkbox } from "@inquirer/prompts";
+
+export async function promptSkillSelection(skills) {
+  const selected = await checkbox({
+    message: "Select skills to install:",
+    choices: skills.map((skill) => ({
+      name: `${skill.name} - ${skill.description}`,
+      value: skill,
+    })),
+  });
+
+  return selected;
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@spardutti/claude-skills",
+  "version": "1.0.0",
+  "description": "CLI to install Claude Code skills from the claude-skills collection",
+  "type": "module",
+  "bin": {
+    "claude-skills": "bin/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "lib"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skills",
+    "cli"
+  ],
+  "author": "spardutti",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0"
+  }
+}