@hasnatools/skills 0.1.21 → 0.1.23

package/dist/index.js

@@ -21024,7 +21024,7 @@ async function searchCommand(query) {
 }
 
 // src/commands/install.ts
-import { existsSync as existsSync3, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync3, writeFileSync as writeFileSync3, readFileSync as readFileSync2 } from "fs";
 import { join as join3 } from "path";
 
 // src/lib/theme.ts
@@ -21110,6 +21110,25 @@ function completionBanner(title) {
 }
 
 // src/commands/install.ts
+var SKILLS_MD_MARKER = "<!-- skills.md:managed -->";
+function isSkillsMdManaged(skillDir) {
+  const skillMdPath = join3(skillDir, "SKILL.md");
+  if (!existsSync3(skillMdPath)) {
+    return false;
+  }
+  try {
+    const content = readFileSync2(skillMdPath, "utf-8");
+    return content.includes(SKILLS_MD_MARKER);
+  } catch {
+    return false;
+  }
+}
+function addSkillsMdMarker(content) {
+  return `${content.trim()}
+
+${SKILLS_MD_MARKER}
+`;
+}
 async function installCommand(slug, options = {}) {
   if (options.all) {
     return installAllSkills(options);
@@ -21153,7 +21172,7 @@ async function installCommand(slug, options = {}) {
     ensureSkillsDir(skillDir);
     ensureSkillsDir(exportsDir);
     ensureSkillsDir(logsDir);
-    writeFileSync3(join3(skillDir, "SKILL.md"), skill.skillMdContent);
+    writeFileSync3(join3(skillDir, "SKILL.md"), addSkillsMdMarker(skill.skillMdContent));
     if (apiKey) {
       await installSkillRemote(slug);
     }
@@ -21236,7 +21255,7 @@ async function installAllSkills(options) {
         ensureSkillsDir(skillDir);
         ensureSkillsDir(exportsDir);
         ensureSkillsDir(logsDir);
-        writeFileSync3(join3(skillDir, "SKILL.md"), skillData.skillMdContent);
+        writeFileSync3(join3(skillDir, "SKILL.md"), addSkillsMdMarker(skillData.skillMdContent));
         if (apiKey) {
           try {
             await installSkillRemote(skill.slug);
@@ -21278,12 +21297,40 @@ async function installAllSkills(options) {
     console.error(colors.error(error instanceof Error ? error.message : "Unknown error"));
   }
 }
-async function uninstallCommand(slug, options = {}) {
-  if (!slug || slug.trim() === "") {
-    console.log(colors.warning("Please provide a skill name"));
-    console.log(colors.dim("Usage: skills uninstall <name>"));
-    return;
+function getInstalledSkillsWithStatus(installDir) {
+  const { readdirSync, statSync } = __require("fs");
+  if (!existsSync3(installDir)) {
+    return [];
   }
+  try {
+    const entries = readdirSync(installDir);
+    return entries.filter((entry) => {
+      const fullPath = join3(installDir, entry);
+      return statSync(fullPath).isDirectory() && entry.startsWith("skill-");
+    }).map((entry) => {
+      const slug = entry.replace(/^skill-/, "");
+      const skillDir = join3(installDir, entry);
+      return {
+        slug,
+        isManaged: isSkillsMdManaged(skillDir)
+      };
+    });
+  } catch {
+    return [];
+  }
+}
+function getInstalledSkills2(installDir) {
+  return getInstalledSkillsWithStatus(installDir).map((s) => s.slug);
+}
+async function isMarketplaceSkill(slug) {
+  try {
+    const result = await getSkill(slug);
+    return !result.error && !!result.data;
+  } catch {
+    return false;
+  }
+}
+async function uninstallCommand(slug, options = {}) {
   const isLocal = options.local ?? false;
   const target = options.target ?? getDefaultTarget();
   let installDir;
@@ -21297,22 +21344,70 @@ async function uninstallCommand(slug, options = {}) {
   } else {
     installDir = target === "claude" ? getClaudeSkillsDir() : getCodexSkillsDir();
   }
-  const skillDir = join3(installDir, `skill-${slug}`);
+  if (options.all) {
+    return uninstallAllSkills(installDir, target, isLocal, options.force);
+  }
+  if (!slug || slug.trim() === "") {
+    console.log(colors.warning("Please provide a skill name"));
+    console.log();
+    console.log(colors.dim("Usage:"));
+    console.log(`  ${command("skills uninstall <name>")}       ${colors.dim("Uninstall a specific skill")}`);
+    console.log(`  ${command("skills uninstall --all")}        ${colors.dim("Uninstall all skills")}`);
+    console.log(`  ${command("skills uninstall --all -f")}     ${colors.dim("Uninstall all without confirmation")}`);
+    return;
+  }
+  const slugs = slug.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+  if (slugs.length > 1) {
+    return uninstallMultipleSkills(slugs, installDir, target, isLocal, options.force);
+  }
+  const skillSlug = slugs[0];
+  const skillDir = join3(installDir, `skill-${skillSlug}`);
   if (!existsSync3(skillDir)) {
-    const oldSkillDir = join3(installDir, slug);
+    const oldSkillDir = join3(installDir, skillSlug);
     if (!existsSync3(oldSkillDir)) {
-      console.log(colors.warning(`Skill "${slug}" is not installed`));
+      console.log(colors.warning(`Skill "${skillSlug}" is not installed`));
+      console.log();
+      const installed = getInstalledSkills2(installDir);
+      if (installed.length > 0) {
+        console.log(colors.dim("Installed skills:"));
+        installed.slice(0, 10).forEach((s) => {
+          console.log(`  ${colors.dim(symbols.bullet)} ${skillName(s)}`);
+        });
+        if (installed.length > 10) {
+          console.log(colors.dim(`  ... and ${installed.length - 10} more`));
+        }
+      }
+      return;
+    }
+  }
+  const isManaged = isSkillsMdManaged(skillDir);
+  if (!isManaged && !options.force) {
+    const spinner2 = ora({
+      text: `Verifying "${skillSlug}"...`,
+      color: "magenta"
+    }).start();
+    const inMarketplace = await isMarketplaceSkill(skillSlug);
+    spinner2.stop();
+    if (!inMarketplace) {
+      console.log(colors.error(`${symbols.error} Cannot uninstall "${skillSlug}"`));
+      console.log();
+      console.log(colors.warning("This skill was NOT installed via skills.md CLI."));
+      console.log(colors.warning("It appears to be a user-created or custom skill."));
+      console.log();
+      console.log(colors.dim("To protect your work, skills.md will not delete this skill."));
+      console.log(colors.dim("If you really want to delete it, remove it manually:"));
+      console.log(`  ${command(`rm -rf "${skillDir}"`)}`);
       return;
     }
   }
   const spinner = ora({
-    text: `Uninstalling "${slug}"...`,
+    text: `Uninstalling "${skillSlug}"...`,
     color: "magenta"
   }).start();
   try {
     const { rmSync: rmSync2 } = await import("fs");
     rmSync2(skillDir, { recursive: true, force: true });
-    spinner.succeed(colors.success(`Uninstalled ${skillName(slug)}`));
+    spinner.succeed(colors.success(`Uninstalled ${skillName(skillSlug)}`));
     console.log();
     console.log(successItem(`Removed from ${path6(skillDir)}`));
   } catch (error) {
@@ -21320,6 +21415,193 @@ async function uninstallCommand(slug, options = {}) {
     console.error(colors.error(error instanceof Error ? error.message : "Unknown error"));
   }
 }
+async function uninstallMultipleSkills(slugs, installDir, target, isLocal, force) {
+  const total = slugs.length;
+  banner("Uninstalling Skills");
+  console.log(keyValue("Target", colors.primaryBold(target)));
+  console.log(keyValue("Scope", colors.primaryBold(isLocal ? "project" : "global")));
+  console.log(keyValue("Skills", count(total)));
+  console.log();
+  console.log(colors.dim("Skills to uninstall:"));
+  slugs.forEach((s) => {
+    const skillDir = join3(installDir, `skill-${s}`);
+    const exists = existsSync3(skillDir);
+    if (exists) {
+      console.log(`  ${colors.warning(symbols.bullet)} ${skillName(s)}`);
+    } else {
+      console.log(`  ${colors.dim(symbols.bullet)} ${s} ${colors.dim("(not installed)")}`);
+    }
+  });
+  console.log();
+  if (!force) {
+    const prompts2 = (await Promise.resolve().then(() => __toESM(require_prompts3(), 1))).default;
+    const response = await prompts2({
+      type: "confirm",
+      name: "confirm",
+      message: `Uninstall ${slugs.length} skill(s)?`,
+      initial: false
+    });
+    if (!response.confirm) {
+      console.log(colors.dim("Cancelled"));
+      return;
+    }
+    console.log();
+  }
+  const results = {
+    success: [],
+    failed: [],
+    notFound: []
+  };
+  for (let i = 0;i < slugs.length; i++) {
+    const slug = slugs[i];
+    const current = i + 1;
+    const percent = Math.round(current / total * 100);
+    const padWidth = String(total).length;
+    const progress = `[${String(current).padStart(padWidth, " ")}/${total}]`;
+    process.stdout.write(`\r${colors.dim(progress)} ${progressBar(percent)} ${colors.dim(`${percent}%`)} Removing ${colors.primary(slug)}...`);
+    process.stdout.write("\x1B[K");
+    const skillDir = join3(installDir, `skill-${slug}`);
+    if (!existsSync3(skillDir)) {
+      results.notFound.push(slug);
+      continue;
+    }
+    try {
+      const { rmSync: rmSync2 } = await import("fs");
+      rmSync2(skillDir, { recursive: true, force: true });
+      results.success.push(slug);
+    } catch (error) {
+      results.failed.push({
+        slug,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  process.stdout.write("\r\x1B[K");
+  completionBanner("Uninstall Complete");
+  if (results.success.length > 0) {
+    console.log(successItem(`Uninstalled: ${colors.successBold(String(results.success.length))} skills`));
+  }
+  if (results.notFound.length > 0) {
+    console.log(colors.dim(`${symbols.info} Not found: ${results.notFound.length} skills`));
+  }
+  if (results.failed.length > 0) {
+    console.log(errorItem(`Failed: ${colors.errorBold(String(results.failed.length))} skills`));
+  }
+}
+async function uninstallAllSkills(installDir, target, isLocal, force) {
+  const allSkills = getInstalledSkillsWithStatus(installDir);
+  const managedSkills = allSkills.filter((s) => s.isManaged);
+  const userSkills = allSkills.filter((s) => !s.isManaged);
+  if (allSkills.length === 0) {
+    console.log(colors.dim("No skills installed"));
+    return;
+  }
+  banner("Uninstall All Skills");
+  console.log(keyValue("Target", colors.primaryBold(target)));
+  console.log(keyValue("Scope", colors.primaryBold(isLocal ? "project" : "global")));
+  console.log(keyValue("Directory", path6(installDir)));
+  console.log();
+  console.log(keyValue("skills.md managed", colors.warning(String(managedSkills.length))));
+  console.log(keyValue("User-created (protected)", colors.success(String(userSkills.length))));
+  console.log();
+  if (managedSkills.length === 0) {
+    console.log(colors.success(`${symbols.success} No skills.md managed skills to uninstall`));
+    if (userSkills.length > 0) {
+      console.log();
+      console.log(colors.dim("Your custom skills are safe:"));
+      userSkills.slice(0, 10).forEach((s) => {
+        console.log(`  ${colors.success(symbols.bullet)} ${skillName(s.slug)}`);
+      });
+      if (userSkills.length > 10) {
+        console.log(colors.dim(`  ... and ${userSkills.length - 10} more`));
+      }
+    }
+    return;
+  }
+  console.log(colors.warning("The following skills.md skills will be removed:"));
+  console.log();
+  const displayCount = Math.min(managedSkills.length, 15);
+  for (let i = 0;i < displayCount; i++) {
+    console.log(`  ${colors.warning(symbols.bullet)} ${skillName(managedSkills[i].slug)}`);
+  }
+  if (managedSkills.length > displayCount) {
+    console.log(colors.dim(`  ... and ${managedSkills.length - displayCount} more`));
+  }
+  console.log();
+  if (userSkills.length > 0) {
+    console.log(colors.success("The following user-created skills will be PROTECTED:"));
+    console.log();
+    userSkills.slice(0, 5).forEach((s) => {
+      console.log(`  ${colors.success(symbols.success)} ${skillName(s.slug)}`);
+    });
+    if (userSkills.length > 5) {
+      console.log(colors.dim(`  ... and ${userSkills.length - 5} more`));
+    }
+    console.log();
+  }
+  if (!force) {
+    const prompts2 = (await Promise.resolve().then(() => __toESM(require_prompts3(), 1))).default;
+    const response = await prompts2({
+      type: "confirm",
+      name: "confirm",
+      message: `Uninstall ${managedSkills.length} skills.md skill(s)?`,
+      initial: false
+    });
+    if (!response.confirm) {
+      console.log(colors.dim("Cancelled"));
+      return;
+    }
+    console.log();
+  }
+  const total = managedSkills.length;
+  const results = {
+    success: [],
+    failed: []
+  };
+  for (let i = 0;i < managedSkills.length; i++) {
+    const slug = managedSkills[i].slug;
+    const current = i + 1;
+    const percent = Math.round(current / total * 100);
+    const padWidth = String(total).length;
+    const progress = `[${String(current).padStart(padWidth, " ")}/${total}]`;
+    process.stdout.write(`\r${colors.dim(progress)} ${progressBar(percent)} ${colors.dim(`${percent}%`)} Removing ${colors.primary(slug)}...`);
+    process.stdout.write("\x1B[K");
+    const skillDir = join3(installDir, `skill-${slug}`);
+    try {
+      const { rmSync: rmSync2 } = await import("fs");
+      rmSync2(skillDir, { recursive: true, force: true });
+      results.success.push(slug);
+    } catch (error) {
+      results.failed.push({
+        slug,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  }
+  process.stdout.write("\r\x1B[K");
+  completionBanner("Uninstall Complete");
+  if (results.success.length > 0) {
+    console.log(successItem(`Uninstalled: ${colors.successBold(String(results.success.length))} skills.md skills`));
+  }
+  if (results.failed.length > 0) {
+    console.log(errorItem(`Failed: ${colors.errorBold(String(results.failed.length))} skills`));
+    console.log();
+    console.log(colors.dim("Failed skills:"));
+    for (const fail of results.failed.slice(0, 5)) {
+      console.log(colors.error(`  ${symbols.bullet} ${fail.slug}: ${fail.error}`));
+    }
+    if (results.failed.length > 5) {
+      console.log(colors.dim(`  ... and ${results.failed.length - 5} more`));
+    }
+  }
+  if (userSkills.length > 0) {
+    console.log();
+    console.log(colors.success(`${symbols.success} Protected ${userSkills.length} user-created skill(s)`));
+  }
+  console.log();
+  console.log(colors.dim("Reinstall skills with:"));
+  console.log(`  ${command("skills install --all")}`);
+}
 
 // src/commands/download.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
@@ -21492,7 +21774,7 @@ async function downloadCommand(slug, options = {}) {
 }
 
 // src/commands/list.ts
-import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync3 } from "fs";
 import { join as join5 } from "path";
 async function listCommand(options = {}) {
   const isGlobal = options.global ?? false;
@@ -21549,7 +21831,7 @@ async function listCommand(options = {}) {
       const skillMdPath = join5(skillDir, "SKILL.md");
       if (!existsSync5(skillMdPath))
         continue;
-      const content = readFileSync2(skillMdPath, "utf-8");
+      const content = readFileSync3(skillMdPath, "utf-8");
       const frontmatter = parseFrontmatter(content);
       installedSkills.push({
         slug: entry.name,
@@ -21779,7 +22061,7 @@ async function cli2faCommand(action) {
 }
 
 // src/commands/run.ts
-import { existsSync as existsSync6, readFileSync as readFileSync3, writeFileSync as writeFileSync5, mkdirSync as mkdirSync4, appendFileSync } from "fs";
+import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync5, mkdirSync as mkdirSync4, appendFileSync } from "fs";
 import { join as join6 } from "path";
 async function runCommand(slug, options = {}) {
   if (!slug || slug.trim() === "") {
@@ -21799,7 +22081,7 @@ async function runCommand(slug, options = {}) {
     console.log(source_default.red(`Invalid skill: missing SKILL.md`));
     return;
   }
-  const content = readFileSync3(skillMdPath, "utf-8");
+  const content = readFileSync4(skillMdPath, "utf-8");
   const { frontmatter } = parseSkillMd(content);
   console.log();
   console.log(source_default.bold(frontmatter.name || slug) + source_default.dim(` v${frontmatter.version || "unknown"}`));
@@ -22226,7 +22508,7 @@ function formatStatus(status) {
 }
 
 // src/commands/history.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4, readdirSync as readdirSync2, statSync } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync } from "fs";
 import { join as join8 } from "path";
 var indigo4 = source_default.hex("#6366f1");
 async function historyCommand(options = {}) {
@@ -22345,7 +22627,7 @@ async function localHistoryCommand(options) {
     console.log(source_default.dim("Run a skill with `skills run <name>` to start tracking"));
     return;
   }
-  const content = readFileSync4(historyFile, "utf-8");
+  const content = readFileSync5(historyFile, "utf-8");
   const lines = content.trim().split(`
 `).filter((line) => line.trim());
   let entries = [];
@@ -22463,7 +22745,7 @@ async function logsCommand(slug, options = {}) {
   console.log(source_default.dim(`File: ${logPath}`));
   console.log(source_default.dim("─".repeat(60)));
   console.log();
-  const content = readFileSync4(logPath, "utf-8");
+  const content = readFileSync5(logPath, "utf-8");
   const logLines = content.split(`
 `);
   const tailLines = options.tail || 50;
@@ -22842,7 +23124,7 @@ async function buyCreditsCommand(amount) {
 }
 
 // src/commands/update.ts
-import { existsSync as existsSync9, readdirSync as readdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync9, readdirSync as readdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
 import { join as join9 } from "path";
 var indigo9 = source_default.hex("#6366f1");
 function parseFrontmatter2(content) {
@@ -22882,7 +23164,7 @@ async function updateCommand(skillName2, options = {}) {
     const skillMdPath = join9(skillDir, "SKILL.md");
     if (!existsSync9(skillMdPath))
       continue;
-    const content = readFileSync5(skillMdPath, "utf-8");
+    const content = readFileSync6(skillMdPath, "utf-8");
     const frontmatter = parseFrontmatter2(content);
     const slug = entry.name.replace("skill-", "");
     if (skillName2 && slug !== skillName2 && frontmatter.name !== skillName2) {
@@ -22920,9 +23202,18 @@ async function updateCommand(skillName2, options = {}) {
       }
       const newVersion = result.data.version;
       const currentVersion = skill.version;
-      if (newVersion !== currentVersion) {
-        writeFileSync6(join9(skill.dir, "SKILL.md"), result.data.skillMdContent);
-        spinner.succeed(`${skill.name}: ${source_default.dim(currentVersion)} ${indigo9("→")} ${indigo9(newVersion)}`);
+      const skillMdPath = join9(skill.dir, "SKILL.md");
+      const currentContent = readFileSync6(skillMdPath, "utf-8");
+      const newContent = result.data.skillMdContent;
+      const contentChanged = currentContent !== newContent;
+      const versionChanged = newVersion !== currentVersion;
+      if (contentChanged || options.force) {
+        writeFileSync6(skillMdPath, newContent);
+        if (versionChanged) {
+          spinner.succeed(`${skill.name}: ${source_default.dim(currentVersion)} ${indigo9("→")} ${indigo9(newVersion)}`);
+        } else {
+          spinner.succeed(`${skill.name}: ${indigo9("refreshed")} ${source_default.dim(`v${currentVersion}`)}`);
+        }
         updated++;
       } else {
         spinner.succeed(`${skill.name}: ${source_default.dim(`v${currentVersion}`)} ${source_default.green("(up to date)")}`);
@@ -23137,7 +23428,7 @@ async function doctorCommand() {
 // src/index.ts
 var indigo12 = colors.primary;
 var program2 = new Command;
-program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.21");
+program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.23");
 program2.command("init").description("Initialize skills.md in current project").option("-f, --force", "Force re-initialization (removes existing .skills/)").action((options) => {
   initCommand({ force: options.force });
 });
@@ -23161,10 +23452,12 @@ program2.command("install [name]").alias("i").description("Install a skill or al
     all: options.all
   });
 });
-program2.command("uninstall <name>").alias("remove").description("Uninstall a skill (global by default)").option("-l, --local", "Uninstall from current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").action((name, options) => {
-  uninstallCommand(name, {
+program2.command("uninstall [name]").alias("remove").description("Uninstall skill(s) - single, comma-separated, or all").option("-l, --local", "Uninstall from current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").option("-a, --all", "Uninstall all installed skills").option("-f, --force", "Skip confirmation prompt").action((name, options) => {
+  uninstallCommand(name || "", {
     local: options.local,
-    target: options.target
+    target: options.target,
+    all: options.all,
+    force: options.force
   });
 });
 program2.command("download <name>").alias("dl").description("Download a skill with full source code (if available)").option("-l, --local", "Download to current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").action((name, options) => {
@@ -23232,8 +23525,8 @@ var creditsCmd = program2.command("credits").description("Manage credits");
 creditsCmd.command("balance").alias("bal").description("Check your credits balance").action(creditsCommand);
 creditsCmd.command("buy <amount>").description("Purchase credits ($5-$500)").action(buyCreditsCommand);
 creditsCmd.action(creditsCommand);
-program2.command("update [skill]").description("Update installed skills to latest versions").option("-t, --target <target>", "Target platform (claude, codex)").action((skill, options) => {
-  updateCommand(skill, { target: options.target });
+program2.command("update [skill]").description("Update installed skills (refreshes SKILL.md from server)").option("-t, --target <target>", "Target platform (claude, codex)").option("-f, --force", "Force update even if content matches").action((skill, options) => {
+  updateCommand(skill, { target: options.target, force: options.force });
 });
 program2.command("upgrade").description("Upgrade the Skills CLI to the latest version").action(upgradeCommand);
 program2.command("doctor").description("Check your environment and diagnose issues").action(doctorCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasnatools/skills",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "CLI for skills.md - AI Agent Skills Marketplace",
   "type": "module",
   "bin": {