@hasnatools/skills 0.1.22 → 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,7 +21297,7 @@ async function installAllSkills(options) {
     console.error(colors.error(error instanceof Error ? error.message : "Unknown error"));
   }
 }
-function getInstalledSkills2(installDir) {
+function getInstalledSkillsWithStatus(installDir) {
   const { readdirSync, statSync } = __require("fs");
   if (!existsSync3(installDir)) {
     return [];
@@ -21288,11 +21307,29 @@ function getInstalledSkills2(installDir) {
     return entries.filter((entry) => {
       const fullPath = join3(installDir, entry);
       return statSync(fullPath).isDirectory() && entry.startsWith("skill-");
-    }).map((entry) => entry.replace(/^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();
@@ -21343,6 +21380,26 @@ async function uninstallCommand(slug, options = {}) {
       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 "${skillSlug}"...`,
     color: "magenta"
@@ -21432,8 +21489,10 @@ async function uninstallMultipleSkills(slugs, installDir, target, isLocal, force
   }
 }
 async function uninstallAllSkills(installDir, target, isLocal, force) {
-  const installed = getInstalledSkills2(installDir);
-  if (installed.length === 0) {
+  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;
   }
@@ -21441,24 +21500,51 @@ async function uninstallAllSkills(installDir, target, isLocal, force) {
   console.log(keyValue("Target", colors.primaryBold(target)));
   console.log(keyValue("Scope", colors.primaryBold(isLocal ? "project" : "global")));
   console.log(keyValue("Directory", path6(installDir)));
-  console.log(keyValue("Skills found", count(installed.length)));
   console.log();
-  console.log(colors.warning("The following skills will be removed:"));
+  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(installed.length, 15);
+  const displayCount = Math.min(managedSkills.length, 15);
   for (let i = 0;i < displayCount; i++) {
-    console.log(`  ${colors.warning(symbols.bullet)} ${skillName(installed[i])}`);
+    console.log(`  ${colors.warning(symbols.bullet)} ${skillName(managedSkills[i].slug)}`);
   }
-  if (installed.length > displayCount) {
-    console.log(colors.dim(`  ... and ${installed.length - displayCount} more`));
+  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 all ${installed.length} skill(s)?`,
+      message: `Uninstall ${managedSkills.length} skills.md skill(s)?`,
       initial: false
     });
     if (!response.confirm) {
@@ -21467,13 +21553,13 @@ async function uninstallAllSkills(installDir, target, isLocal, force) {
     }
     console.log();
   }
-  const total = installed.length;
+  const total = managedSkills.length;
   const results = {
     success: [],
     failed: []
   };
-  for (let i = 0;i < installed.length; i++) {
-    const slug = installed[i];
+  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;
@@ -21495,7 +21581,7 @@ async function uninstallAllSkills(installDir, target, isLocal, force) {
   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`));
+    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`));
@@ -21508,6 +21594,10 @@ async function uninstallAllSkills(installDir, target, isLocal, force) {
       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")}`);
@@ -21684,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;
@@ -21741,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,
@@ -21971,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() === "") {
@@ -21991,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"}`));
@@ -22418,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 = {}) {
@@ -22537,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 = [];
@@ -22655,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;
@@ -23034,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) {
@@ -23074,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) {
@@ -23112,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)")}`);
@@ -23329,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.22");
+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 });
 });
@@ -23426,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.22",
+  "version": "0.1.23",
   "description": "CLI for skills.md - AI Agent Skills Marketplace",
   "type": "module",
   "bin": {