@spardutti/claude-skills 1.5.0 → 1.7.0

package/bin/cli.mjs

@@ -1,16 +1,23 @@
 #!/usr/bin/env node
 
 import { confirm } from "@inquirer/prompts";
+import chalk from "chalk";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 import { fetchSkills } from "../lib/github.mjs";
 import { promptSkillSelection } from "../lib/prompt.mjs";
 import { installSkills } from "../lib/install.mjs";
 import { setupHook } from "../lib/setup-hook.mjs";
 import { setupClaudeMd } from "../lib/setup-claude-md.mjs";
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+
 async function main() {
-  console.log("\n  Claude Skills Installer\n");
+  console.log(`\n  ${chalk.bold.cyan("Claude Skills Installer")} ${chalk.dim(`v${pkg.version}`)}\n`);
 
-  console.log("  Fetching available skills...\n");
+  console.log(chalk.dim("  Fetching available skills...\n"));
   const skills = await fetchSkills();
 
   if (skills.length === 0) {
@@ -40,7 +47,7 @@ async function main() {
     await setupClaudeMd();
   }
 
-  console.log(`\n  Done! ${selected.length} skill(s) installed.\n`);
+  console.log(`\n  ${chalk.green("✔")} ${chalk.bold(`${selected.length} skill(s) installed successfully.`)}\n`);
 }
 
 main().catch((err) => {
@@ -48,6 +55,6 @@ main().catch((err) => {
     console.log("\n  Cancelled.\n");
     process.exit(0);
   }
-  console.error(`\n  Error: ${err.message}\n`);
+  console.error(`\n  ${chalk.red("Error:")} ${err.message}\n`);
   process.exit(1);
 });

package/lib/github.mjs

@@ -59,9 +59,9 @@ export async function fetchSkills() {
         }
 
         const content = await r.text();
-        const { name, description } = parseFrontmatter(content, dir.name);
+        const { name, description, category } = parseFrontmatter(content, dir.name);
 
-        return { dirName: dir.name, name, description, content };
+        return { dirName: dir.name, name, description, category, content };
       } catch {
         console.warn(`  Warning: Failed to fetch ${dir.name}, skipping`);
         return null;
@@ -75,7 +75,7 @@ export async function fetchSkills() {
 function parseFrontmatter(content, fallbackName) {
   const match = content.match(/^---\s*\n([\s\S]*?)\n---/);
   if (!match) {
-    return { name: fallbackName, description: "" };
+    return { name: fallbackName, description: "", category: "General" };
   }
 
   const block = match[1];
@@ -83,6 +83,8 @@ function parseFrontmatter(content, fallbackName) {
     block.match(/^name:\s*(.+)$/m)?.[1]?.trim() || fallbackName;
   const description =
     block.match(/^description:\s*(.+)$/m)?.[1]?.trim() || "";
+  const category =
+    block.match(/^category:\s*(.+)$/m)?.[1]?.trim() || "General";
 
-  return { name, description };
+  return { name, description, category };
 }

package/lib/install.mjs

@@ -1,5 +1,12 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
+import chalk from "chalk";
+
+function humanName(skill) {
+  return skill.name
+    .replace(/-/g, " ")
+    .replace(/\b\w/g, (c) => c.toUpperCase());
+}
 
 export async function installSkills(skills, targetDir = process.cwd()) {
   const baseDir = join(targetDir, ".claude", "skills");
@@ -8,6 +15,6 @@ export async function installSkills(skills, targetDir = process.cwd()) {
     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`);
+    console.log(`  ${chalk.green("✔")} ${chalk.bold(humanName(skill))} ${chalk.dim(`→ .claude/skills/${skill.dirName}/`)}`);
   }
 }

package/lib/prompt.mjs

@@ -1,12 +1,52 @@
-import { checkbox } from "@inquirer/prompts";
+import { checkbox, Separator } from "@inquirer/prompts";
+import chalk from "chalk";
+
+const CATEGORY_ORDER = ["Frontend", "TypeScript", "Backend", "Quality", "General"];
+
+function humanName(skill) {
+  return skill.name
+    .replace(/-/g, " ")
+    .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+function stripQuotes(str) {
+  return str.replace(/^["']|["']$/g, "");
+}
 
 export async function promptSkillSelection(skills) {
+  // Group skills by category preserving order
+  const grouped = new Map();
+  for (const cat of CATEGORY_ORDER) {
+    const items = skills.filter((s) => s.category === cat);
+    if (items.length > 0) grouped.set(cat, items);
+  }
+
+  // Build choices with separators
+  const choices = [];
+  for (const [category, items] of grouped) {
+    choices.push(new Separator(`── ${category} ${"─".repeat(35 - category.length)}`));
+    for (const skill of items) {
+      choices.push({
+        name: chalk.bold(humanName(skill)),
+        value: skill,
+        description: chalk.dim(stripQuotes(skill.description)),
+      });
+    }
+  }
+
+  const theme = {
+    icon: { cursor: ">" },
+    style: {
+      highlight: (text) => chalk.cyan(text),
+      renderSelectedChoices: (selected) =>
+        selected.map((s) => chalk.cyan(humanName(s))).join(", "),
+    },
+  };
+
   const selected = await checkbox({
     message: "Select skills to install:",
-    choices: skills.map((skill) => ({
-      name: `${skill.name} - ${skill.description}`,
-      value: skill,
-    })),
+    choices,
+    theme,
   });
 
   return selected;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spardutti/claude-skills",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "CLI to install Claude Code skills from the claude-skills collection",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
   "author": "spardutti",
   "license": "MIT",
   "dependencies": {
-    "@inquirer/prompts": "^7.0.0"
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.0.0"
   }
 }