@hasnatools/skills 0.1.37 → 0.1.39

package/dist/index.js

@@ -13018,7 +13018,7 @@ var require_prompt = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/prompts@2.4.2/node_modules/prompts/dist/elements/text.js
 var require_text = __commonJS((exports, module) => {
-  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+  function asyncGeneratorStep(gen, resolve2, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
       var value = info.value;
@@ -13027,7 +13027,7 @@ var require_text = __commonJS((exports, module) => {
       return;
     }
     if (info.done) {
-      resolve(value);
+      resolve2(value);
     } else {
       Promise.resolve(value).then(_next, _throw);
     }
@@ -13035,13 +13035,13 @@ var require_text = __commonJS((exports, module) => {
   function _asyncToGenerator(fn) {
     return function() {
       var self = this, args = arguments;
-      return new Promise(function(resolve, reject) {
+      return new Promise(function(resolve2, reject) {
         var gen = fn.apply(self, args);
         function _next(value) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "next", value);
         }
         function _throw(err) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "throw", err);
         }
         _next(undefined);
       });
@@ -13755,7 +13755,7 @@ var require_dateparts = __commonJS((exports, module) => {
 
 // ../../node_modules/.bun/prompts@2.4.2/node_modules/prompts/dist/elements/date.js
 var require_date = __commonJS((exports, module) => {
-  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+  function asyncGeneratorStep(gen, resolve2, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
       var value = info.value;
@@ -13764,7 +13764,7 @@ var require_date = __commonJS((exports, module) => {
       return;
     }
     if (info.done) {
-      resolve(value);
+      resolve2(value);
     } else {
       Promise.resolve(value).then(_next, _throw);
     }
@@ -13772,13 +13772,13 @@ var require_date = __commonJS((exports, module) => {
   function _asyncToGenerator(fn) {
     return function() {
       var self = this, args = arguments;
-      return new Promise(function(resolve, reject) {
+      return new Promise(function(resolve2, reject) {
         var gen = fn.apply(self, args);
         function _next(value) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "next", value);
         }
         function _throw(err) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "throw", err);
         }
         _next(undefined);
       });
@@ -13982,7 +13982,7 @@ ${i ? ` ` : figures.pointerSmall} ${color.red().italic(l)}`, ``);
 
 // ../../node_modules/.bun/prompts@2.4.2/node_modules/prompts/dist/elements/number.js
 var require_number = __commonJS((exports, module) => {
-  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+  function asyncGeneratorStep(gen, resolve2, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
       var value = info.value;
@@ -13991,7 +13991,7 @@ var require_number = __commonJS((exports, module) => {
       return;
     }
     if (info.done) {
-      resolve(value);
+      resolve2(value);
     } else {
       Promise.resolve(value).then(_next, _throw);
     }
@@ -13999,13 +13999,13 @@ var require_number = __commonJS((exports, module) => {
   function _asyncToGenerator(fn) {
     return function() {
       var self = this, args = arguments;
-      return new Promise(function(resolve, reject) {
+      return new Promise(function(resolve2, reject) {
         var gen = fn.apply(self, args);
         function _next(value) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "next", value);
         }
         function _throw(err) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "throw", err);
         }
         _next(undefined);
       });
@@ -14441,7 +14441,7 @@ Instructions:
 
 // ../../node_modules/.bun/prompts@2.4.2/node_modules/prompts/dist/elements/autocomplete.js
 var require_autocomplete = __commonJS((exports, module) => {
-  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+  function asyncGeneratorStep(gen, resolve2, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
       var value = info.value;
@@ -14450,7 +14450,7 @@ var require_autocomplete = __commonJS((exports, module) => {
       return;
     }
     if (info.done) {
-      resolve(value);
+      resolve2(value);
     } else {
       Promise.resolve(value).then(_next, _throw);
     }
@@ -14458,13 +14458,13 @@ var require_autocomplete = __commonJS((exports, module) => {
   function _asyncToGenerator(fn) {
     return function() {
       var self = this, args = arguments;
-      return new Promise(function(resolve, reject) {
+      return new Promise(function(resolve2, reject) {
         var gen = fn.apply(self, args);
         function _next(value) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "next", value);
         }
         function _throw(err) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "throw", err);
         }
         _next(undefined);
       });
@@ -15122,7 +15122,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
       arr2[i] = arr[i];
     return arr2;
   }
-  function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+  function asyncGeneratorStep(gen, resolve2, reject, _next, _throw, key, arg) {
     try {
       var info = gen[key](arg);
       var value = info.value;
@@ -15131,7 +15131,7 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
       return;
     }
     if (info.done) {
-      resolve(value);
+      resolve2(value);
     } else {
       Promise.resolve(value).then(_next, _throw);
     }
@@ -15139,13 +15139,13 @@ In order to be iterable, non-array objects must have a [Symbol.iterator]() metho
   function _asyncToGenerator(fn) {
     return function() {
       var self = this, args = arguments;
-      return new Promise(function(resolve, reject) {
+      return new Promise(function(resolve2, reject) {
         var gen = fn.apply(self, args);
         function _next(value) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "next", value);
         }
         function _throw(err) {
-          asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+          asyncGeneratorStep(gen, resolve2, reject, _next, _throw, "throw", err);
         }
         _next(undefined);
       });
@@ -19926,7 +19926,7 @@ class Conf {
 
 // src/lib/config.ts
 import { homedir as homedir2 } from "os";
-import { join } from "path";
+import { join, dirname, resolve } from "path";
 import { existsSync, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
 var defaultConfig = {
   version: "0.1.0",
@@ -20014,13 +20014,16 @@ function ensureSkillsDir(dir) {
   }
 }
 function findProjectRoot(startDir = process.cwd()) {
-  let currentDir = startDir;
-  const root = "/";
-  while (currentDir !== root) {
+  let currentDir = resolve(startDir);
+  while (true) {
     if (existsSync(join(currentDir, LOCAL_CONFIG_DIR, LOCAL_CONFIG_FILE))) {
       return currentDir;
     }
-    currentDir = join(currentDir, "..");
+    const parentDir = dirname(currentDir);
+    if (parentDir === currentDir) {
+      break;
+    }
+    currentDir = parentDir;
   }
   return null;
 }
@@ -20031,6 +20034,23 @@ function getProjectSkillsOutputDir(startDir = process.cwd()) {
   }
   return null;
 }
+function isValidSlug(slug) {
+  if (!slug || typeof slug !== "string") {
+    return false;
+  }
+  const validSlugPattern = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+  return validSlugPattern.test(slug) && slug.length <= 64;
+}
+function getSkillsDir(options = {}) {
+  const target = options.target ?? getDefaultTarget();
+  if (options.local) {
+    const projectRoot = findProjectRoot();
+    if (projectRoot) {
+      return target === "claude" ? getProjectClaudeSkillsDir(projectRoot) : getProjectCodexSkillsDir(projectRoot);
+    }
+  }
+  return target === "claude" ? getClaudeSkillsDir() : getCodexSkillsDir();
+}
 
 // src/commands/init.ts
 async function initCommand(options = {}) {
@@ -20557,19 +20577,19 @@ var baseOpen = async (options) => {
   }
   const subprocess = childProcess3.spawn(command, cliArguments, childProcessOptions);
   if (options.wait) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       subprocess.once("error", reject);
       subprocess.once("close", (exitCode) => {
         if (!options.allowNonzeroExitCode && exitCode !== 0) {
           reject(new Error(`Exited with code ${exitCode}`));
           return;
         }
-        resolve(subprocess);
+        resolve2(subprocess);
       });
     });
   }
   if (isFallbackAttempt) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       subprocess.once("error", reject);
       subprocess.once("spawn", () => {
         subprocess.once("close", (exitCode) => {
@@ -20579,17 +20599,17 @@ var baseOpen = async (options) => {
             return;
           }
           subprocess.unref();
-          resolve(subprocess);
+          resolve2(subprocess);
         });
       });
     });
   }
   subprocess.unref();
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     subprocess.once("error", reject);
     subprocess.once("spawn", () => {
       subprocess.off("error", reject);
-      resolve(subprocess);
+      resolve2(subprocess);
     });
   });
 };
@@ -20675,25 +20695,40 @@ async function apiRequest(path6, options = {}) {
   if (apiKey) {
     headers["Authorization"] = `Bearer ${apiKey}`;
   }
+  let response;
   try {
-    const response = await fetch(`${endpoint}${path6}`, {
+    response = await fetch(`${endpoint}${path6}`, {
       ...options,
       headers
     });
-    const data = await response.json();
+  } catch (error) {
+    return {
+      error: error instanceof Error ? error.message : "Network error",
+      status: 0
+    };
+  }
+  let data;
+  try {
+    data = await response.json();
+  } catch {
     if (!response.ok) {
       return {
-        error: data.error || "Request failed",
+        error: `Server error: ${response.status} ${response.statusText}`,
         status: response.status
       };
     }
-    return { data, status: response.status };
-  } catch (error) {
     return {
-      error: error instanceof Error ? error.message : "Network error",
-      status: 0
+      error: "Invalid response from server",
+      status: response.status
+    };
+  }
+  if (!response.ok) {
+    return {
+      error: data.error || `Request failed: ${response.status}`,
+      status: response.status
     };
   }
+  return { data, status: response.status };
 }
 async function searchSkills(query) {
   return apiRequest(`/skills?q=${encodeURIComponent(query)}`);
@@ -20706,9 +20741,27 @@ async function getMarketplaceSkills(options) {
     params.set("page", options.page.toString());
   if (options?.category)
     params.set("category", options.category);
+  if (options?.tag)
+    params.set("tag", options.tag);
   const query = params.toString();
   return apiRequest(`/skills${query ? `?${query}` : ""}`);
 }
+async function getSkillsByTag(tag) {
+  const allSkills = [];
+  let page = 1;
+  const limit = 100;
+  let totalPages = 1;
+  while (page <= totalPages) {
+    const result = await getMarketplaceSkills({ page, limit, tag });
+    if (result.error || !result.data) {
+      return { error: result.error || "Failed to fetch skills", status: result.status };
+    }
+    allSkills.push(...result.data.skills);
+    totalPages = result.data.pagination.totalPages;
+    page++;
+  }
+  return { data: { skills: allSkills, total: allSkills.length }, status: 200 };
+}
 async function getAllMarketplaceSkills() {
   const allSkills = [];
   let page = 1;
@@ -20793,6 +20846,52 @@ async function makeApiRequest(path6, options = {}) {
     headers
   });
 }
+async function listSchedules(options) {
+  const params = new URLSearchParams;
+  if (options?.status)
+    params.set("status", options.status);
+  if (options?.skill)
+    params.set("skill", options.skill);
+  if (options?.search)
+    params.set("search", options.search);
+  if (options?.limit)
+    params.set("limit", options.limit.toString());
+  if (options?.offset)
+    params.set("offset", options.offset.toString());
+  const query = params.toString();
+  return apiRequest(`/schedules${query ? `?${query}` : ""}`);
+}
+async function getSchedule(id) {
+  return apiRequest(`/schedules/${id}`);
+}
+async function createSchedule(input) {
+  return apiRequest("/schedules", {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+}
+async function updateSchedule(id, input) {
+  return apiRequest(`/schedules/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify(input)
+  });
+}
+async function deleteSchedule(id) {
+  return apiRequest(`/schedules/${id}`, {
+    method: "DELETE"
+  });
+}
+async function getScheduleRuns(id, options) {
+  const params = new URLSearchParams;
+  if (options?.status)
+    params.set("status", options.status);
+  if (options?.limit)
+    params.set("limit", options.limit.toString());
+  if (options?.offset)
+    params.set("offset", options.offset.toString());
+  const query = params.toString();
+  return apiRequest(`/schedules/${id}/runs${query ? `?${query}` : ""}`);
+}
 
 // src/commands/login.ts
 async function loginCommand(options = {}) {
@@ -20985,7 +21084,7 @@ async function whoamiCommand() {
   console.log();
 }
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 
 // src/commands/search.ts
@@ -21133,10 +21232,14 @@ async function installCommand(slug, options = {}) {
   if (options.all) {
     return installAllSkills(options);
   }
+  if (options.tag) {
+    return installSkillsByTag(options.tag, options);
+  }
   if (!slug || slug.trim() === "") {
     console.log(colors.warning("Please provide a skill name"));
     console.log(colors.dim("Usage: skills install <name>"));
     console.log(colors.dim("       skills install --all"));
+    console.log(colors.dim("       skills install --tag <tag-name>"));
     return;
   }
   const isLocal = options.local ?? false;
@@ -21299,6 +21402,141 @@ async function installAllSkills(options) {
     console.error(colors.error(error instanceof Error ? error.message : "Unknown error"));
   }
 }
+async function installSkillsByTag(tag, options) {
+  const isLocal = options.local ?? false;
+  const target = options.target ?? getDefaultTarget();
+  const apiKey = getApiKey();
+  let installDir;
+  if (isLocal) {
+    const projectRoot = findProjectRoot();
+    if (!projectRoot) {
+      console.log(colors.warning("Not in a skills.md project"));
+      console.log(colors.dim("Run `skills init` first or install globally (default)"));
+      return;
+    }
+    installDir = target === "claude" ? getProjectClaudeSkillsDir(projectRoot) : getProjectCodexSkillsDir(projectRoot);
+  } else {
+    installDir = target === "claude" ? getClaudeSkillsDir() : getCodexSkillsDir();
+  }
+  banner(`Installing Skills by Tag: ${tag}`);
+  const fetchSpinner = ora({
+    text: `Fetching skills with tag "${tag}"...`,
+    color: "magenta"
+  }).start();
+  try {
+    const result = await getSkillsByTag(tag);
+    if (result.error || !result.data) {
+      fetchSpinner.fail(colors.error("Failed to fetch skills"));
+      console.error(colors.error(result.error || "Could not fetch skills by tag"));
+      return;
+    }
+    const skills = result.data.skills;
+    const total = skills.length;
+    if (total === 0) {
+      fetchSpinner.warn(colors.warning(`No skills found with tag "${tag}"`));
+      console.log();
+      console.log(colors.dim("Try searching for available tags in the marketplace:"));
+      console.log(`  ${command("skills marketplace")}`);
+      return;
+    }
+    fetchSpinner.succeed(colors.success(`Found ${count(total)} skill${total !== 1 ? "s" : ""} with tag "${tag}"`));
+    console.log();
+    console.log(keyValue("Tag", colors.primaryBold(tag)));
+    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(colors.dim("Skills to install:"));
+    const displayCount = Math.min(skills.length, 15);
+    for (let i = 0;i < displayCount; i++) {
+      console.log(`  ${colors.primary(symbols.bullet)} ${skillName(skills[i].name)} ${colors.dim(`(${skills[i].slug})`)}`);
+    }
+    if (skills.length > displayCount) {
+      console.log(colors.dim(`  ... and ${skills.length - displayCount} more`));
+    }
+    console.log();
+    if (!options.force) {
+      const prompts2 = (await Promise.resolve().then(() => __toESM(require_prompts3(), 1))).default;
+      const response = await prompts2({
+        type: "confirm",
+        name: "confirm",
+        message: `Install ${total} skill${total !== 1 ? "s" : ""} with tag "${tag}"?`,
+        initial: true
+      });
+      if (!response.confirm) {
+        console.log(colors.dim("Cancelled"));
+        return;
+      }
+      console.log();
+    }
+    const results = {
+      success: [],
+      failed: [],
+      skipped: []
+    };
+    for (let i = 0;i < skills.length; i++) {
+      const skill = skills[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}%`)} Installing ${colors.primary(skill.slug)}...`);
+      process.stdout.write("\x1B[K");
+      try {
+        const skillResult = await installSkill(skill.slug);
+        if (skillResult.error || !skillResult.data) {
+          results.failed.push({ slug: skill.slug, error: skillResult.error || "Not found" });
+          continue;
+        }
+        const skillData = skillResult.data;
+        const skillDir = join3(installDir, `skill-${skill.slug}`);
+        const exportsDir = join3(skillDir, "exports");
+        const logsDir = join3(skillDir, "logs");
+        ensureSkillsDir(skillDir);
+        ensureSkillsDir(exportsDir);
+        ensureSkillsDir(logsDir);
+        writeFileSync3(join3(skillDir, "SKILL.md"), addSkillsMdMarker(skillData.skillMdContent));
+        if (apiKey) {
+          try {
+            await installSkillRemote(skill.slug);
+          } catch {}
+        }
+        results.success.push(skill.slug);
+      } catch (error) {
+        results.failed.push({
+          slug: skill.slug,
+          error: error instanceof Error ? error.message : "Unknown error"
+        });
+      }
+    }
+    process.stdout.write("\r\x1B[K");
+    completionBanner("Installation Complete");
+    if (results.success.length > 0) {
+      console.log(successItem(`Successfully installed: ${colors.successBold(String(results.success.length))} skills`));
+    }
+    if (results.failed.length > 0) {
+      console.log(errorItem(`Failed to install: ${colors.errorBold(String(results.failed.length))} skills`));
+      console.log();
+      console.log(colors.dim("Failed skills:"));
+      for (const fail of results.failed.slice(0, 10)) {
+        console.log(colors.error(`  ${symbols.bullet} ${fail.slug}: ${fail.error}`));
+      }
+      if (results.failed.length > 10) {
+        console.log(colors.dim(`  ... and ${results.failed.length - 10} more`));
+      }
+    }
+    console.log();
+    console.log(colors.dim("Installation directory:"));
+    console.log(`  ${path6(installDir)}`);
+    console.log();
+    console.log(colors.dim("Run any skill with:"));
+    console.log(`  ${command('skills run <skill-name> -- "your prompt"')}`);
+    console.log();
+  } catch (error) {
+    fetchSpinner.fail(colors.error("Installation failed"));
+    console.error(colors.error(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
 function getInstalledSkillsWithStatus(installDir) {
   const { readdirSync, statSync } = __require("fs");
   if (!existsSync3(installDir)) {
@@ -21608,7 +21846,7 @@ async function uninstallAllSkills(installDir, target, isLocal, force) {
 
 // src/commands/download.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
-import { join as join4, normalize, basename, dirname, isAbsolute } from "path";
+import { join as join4, normalize, basename, dirname as dirname2, isAbsolute } from "path";
 var indigo2 = source_default.hex("#6366f1");
 function validateFilename(filename) {
   if (!filename || filename.trim() === "") {
@@ -21747,7 +21985,7 @@ async function downloadCommand(slug, options = {}) {
         filesSkipped++;
         continue;
       }
-      const parentDir = dirname(safePath);
+      const parentDir = dirname2(safePath);
       if (!existsSync4(parentDir)) {
         mkdirSync3(parentDir, { recursive: true });
       }
@@ -22306,21 +22544,25 @@ function findLocalSkill(skillName2) {
   }
   return null;
 }
+function escapeShellArg(arg) {
+  return `'${arg.replace(/'/g, "'\\''")}'`;
+}
 async function runLocalSkill(skillDir, args) {
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     const skillMdPath = join7(skillDir, "SKILL.md");
     if (!existsSync7(skillMdPath)) {
-      resolve(false);
+      resolve2(false);
       return;
     }
     const content = __require("fs").readFileSync(skillMdPath, "utf-8");
     const match = content.match(/scripts:\s*\n\s*run:\s*(.+)/);
     if (!match) {
-      resolve(false);
+      resolve2(false);
       return;
     }
     const runScript = match[1].trim();
-    const fullCommand = args.length > 0 ? `${runScript} ${args.join(" ")}` : runScript;
+    const escapedArgs = args.map(escapeShellArg);
+    const fullCommand = args.length > 0 ? `${runScript} ${escapedArgs.join(" ")}` : runScript;
     const projectRoot = findProjectRoot();
     const skillsOutputDir = projectRoot ? join7(projectRoot, ".skills") : null;
     const child = spawn(fullCommand, {
@@ -22335,8 +22577,11 @@ async function runLocalSkill(skillDir, args) {
         SKILLS_OUTPUT_DIR: skillsOutputDir || ""
       }
     });
-    child.on("error", () => resolve(false));
-    child.on("exit", (code) => resolve(code === 0));
+    child.on("error", (err) => {
+      console.error("Skill execution error:", err.message);
+      resolve2(false);
+    });
+    child.on("exit", (code) => resolve2(code === 0));
   });
 }
 async function generateCommand(mediaType, prompt, options = {}) {
@@ -22683,8 +22928,12 @@ async function localHistoryCommand(options) {
   }
 }
 async function exportsCommand(slug, options = {}) {
-  const target = options.target || getDefaultTarget();
-  const skillsDir = target === "claude" ? getProjectClaudeSkillsDir() : getProjectCodexSkillsDir();
+  if (!isValidSlug(slug)) {
+    console.log(source_default.red(`Invalid skill name: "${slug}"`));
+    console.log(source_default.dim("Skill names can only contain letters, numbers, hyphens, and underscores"));
+    return;
+  }
+  const skillsDir = getSkillsDir({ target: options.target });
   let skillDir = join8(skillsDir, `skill-${slug}`);
   if (!existsSync8(skillDir)) {
     skillDir = join8(skillsDir, slug);
@@ -22723,8 +22972,12 @@ async function exportsCommand(slug, options = {}) {
   console.log(source_default.dim(`Total: ${files.length} file(s)`));
 }
 async function logsCommand(slug, options = {}) {
-  const target = options.target || getDefaultTarget();
-  const skillsDir = target === "claude" ? getProjectClaudeSkillsDir() : getProjectCodexSkillsDir();
+  if (!isValidSlug(slug)) {
+    console.log(source_default.red(`Invalid skill name: "${slug}"`));
+    console.log(source_default.dim("Skill names can only contain letters, numbers, hyphens, and underscores"));
+    return;
+  }
+  const skillsDir = getSkillsDir({ target: options.target });
   let skillDir = join8(skillsDir, `skill-${slug}`);
   if (!existsSync8(skillDir)) {
     skillDir = join8(skillsDir, slug);
@@ -23739,10 +23992,383 @@ async function setupCommand(promptArg, options = {}) {
   console.log(`  ${command("skills list")}`);
 }
 
+// src/commands/schedule.ts
+var indigo12 = source_default.hex("#6366f1");
+async function scheduleCreateCommand(skill, scheduleInput, options) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  let scheduleConfig = {};
+  if (options.cron) {
+    scheduleConfig.cronExpression = options.cron;
+  } else if (options.at) {
+    scheduleConfig.scheduledAt = options.at;
+  } else if (scheduleInput) {
+    scheduleConfig.schedule = scheduleInput;
+  } else {
+    console.log(source_default.red("Please provide a schedule"));
+    console.log(source_default.dim("Examples:"));
+    console.log(source_default.dim('  skills schedule <skill> "every Monday at 9am"'));
+    console.log(source_default.dim('  skills schedule <skill> --cron "0 9 * * 1"'));
+    console.log(source_default.dim('  skills schedule <skill> --at "2025-01-15T09:00:00"'));
+    return;
+  }
+  const spinner = ora("Creating schedule...").start();
+  try {
+    const result = await createSchedule({
+      skillSlug: skill,
+      name: options.name || `${skill} schedule`,
+      ...scheduleConfig,
+      command: options.command,
+      timezone: options.timezone || "UTC",
+      maxRuns: options.maxRuns
+    });
+    if (result.error) {
+      spinner.fail("Failed to create schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule created successfully");
+    console.log();
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      printScheduleDetails(schedule);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleListCommand(options = {}) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching schedules...").start();
+  try {
+    const result = await listSchedules({
+      status: options.status,
+      skill: options.skill,
+      limit: options.limit || 20
+    });
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedules, stats } = result.data || { schedules: [], stats: { total: 0, active: 0, paused: 0, completed: 0, failed: 0, cancelled: 0 } };
+    console.log();
+    console.log(indigo12.bold("Scheduled Jobs"));
+    console.log(source_default.dim(`Total: ${stats.total} | Active: ${stats.active} | Paused: ${stats.paused} | Completed: ${stats.completed} | Failed: ${stats.failed}`));
+    console.log();
+    if (schedules.length === 0) {
+      console.log(source_default.dim("No schedules found"));
+      console.log(source_default.dim('Create one with: skills schedule <skill> "every day at 9am"'));
+      return;
+    }
+    for (const schedule of schedules) {
+      printScheduleSummary(schedule);
+    }
+    console.log();
+    console.log(source_default.dim("View all at: https://skills.md (go to your team dashboard)"));
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleGetCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching schedule...").start();
+  try {
+    const result = await getSchedule(id);
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedule, recentRuns, stats } = result.data || {};
+    if (!schedule) {
+      console.log(source_default.red("Schedule not found"));
+      return;
+    }
+    console.log();
+    printScheduleDetails(schedule);
+    if (stats) {
+      console.log();
+      console.log(indigo12.bold("Run Statistics"));
+      console.log(`  ${source_default.dim("Total Runs:")} ${stats.totalRuns}`);
+      console.log(`  ${source_default.dim("Successful:")} ${source_default.green(String(stats.successfulRuns))}`);
+      console.log(`  ${source_default.dim("Failed:")} ${source_default.red(String(stats.failedRuns))}`);
+      console.log(`  ${source_default.dim("Credits Used:")} ${indigo12(String(stats.totalCredits))}`);
+      if (stats.avgDurationMs) {
+        console.log(`  ${source_default.dim("Avg Duration:")} ${formatDuration3(stats.avgDurationMs)}`);
+      }
+    }
+    if (recentRuns && recentRuns.length > 0) {
+      console.log();
+      console.log(indigo12.bold("Recent Runs"));
+      for (const run of recentRuns.slice(0, 5)) {
+        printRunSummary(run);
+      }
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function schedulePauseCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Pausing schedule...").start();
+  try {
+    const result = await updateSchedule(id, { status: "paused" });
+    if (result.error) {
+      spinner.fail("Failed to pause schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule paused successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleResumeCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Resuming schedule...").start();
+  try {
+    const result = await updateSchedule(id, { status: "active" });
+    if (result.error) {
+      spinner.fail("Failed to resume schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule resumed successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+      if (schedule.nextRunAt) {
+        console.log(`  ${source_default.dim("Next Run:")} ${formatDate(schedule.nextRunAt)}`);
+      }
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleCancelCommand(id) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Cancelling schedule...").start();
+  try {
+    const result = await deleteSchedule(id);
+    if (result.error) {
+      spinner.fail("Failed to cancel schedule");
+      console.log(source_default.red(result.error));
+      return;
+    }
+    spinner.succeed("Schedule cancelled successfully");
+    const schedule = result.data?.schedule;
+    if (schedule) {
+      console.log();
+      console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+      console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+async function scheduleHistoryCommand(id, options = {}) {
+  const apiKey = getApiKey();
+  if (!apiKey) {
+    console.log(source_default.red("Not logged in"));
+    console.log(source_default.dim("Run `skills login` first"));
+    return;
+  }
+  const spinner = ora("Fetching run history...").start();
+  try {
+    const result = await getScheduleRuns(id, {
+      status: options.status,
+      limit: options.limit || 20
+    });
+    spinner.stop();
+    if (result.error) {
+      console.log(source_default.red(result.error));
+      return;
+    }
+    const { schedule, runs, stats } = result.data || {};
+    if (!schedule) {
+      console.log(source_default.red("Schedule not found"));
+      return;
+    }
+    console.log();
+    console.log(indigo12.bold(`Run History: ${schedule.name}`));
+    console.log(source_default.dim(`Skill: ${schedule.skillSlug}`));
+    console.log(source_default.dim(`Total: ${stats?.totalRuns || 0} | Success: ${stats?.successfulRuns || 0} | Failed: ${stats?.failedRuns || 0} | Success Rate: ${stats?.successRate || 0}%`));
+    console.log();
+    if (!runs || runs.length === 0) {
+      console.log(source_default.dim("No runs yet"));
+      return;
+    }
+    for (const run of runs) {
+      printRunSummary(run);
+    }
+  } catch (error) {
+    spinner.fail("Request failed");
+    console.log(source_default.red(error instanceof Error ? error.message : "Unknown error"));
+  }
+}
+function printScheduleSummary(schedule) {
+  const statusIcon = getStatusIcon2(schedule.status);
+  const nextRun = schedule.nextRunAt ? formatRelativeTime(schedule.nextRunAt) : "-";
+  console.log(`${statusIcon} ${source_default.bold(schedule.name)} ${source_default.dim(`(${schedule.skillSlug})`)}`);
+  console.log(`  ${source_default.dim("ID:")} ${schedule.id.slice(0, 8)}...`);
+  console.log(`  ${source_default.dim("Schedule:")} ${schedule.scheduleDescription || schedule.cronExpression || "One-time"}`);
+  console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+  console.log(`  ${source_default.dim("Next Run:")} ${nextRun}`);
+  console.log(`  ${source_default.dim("Runs:")} ${schedule.runCount}${schedule.maxRuns ? `/${schedule.maxRuns}` : ""}`);
+  console.log();
+}
+function printScheduleDetails(schedule) {
+  console.log(indigo12.bold("Schedule Details"));
+  console.log(`  ${source_default.dim("ID:")} ${schedule.id}`);
+  console.log(`  ${source_default.dim("Name:")} ${schedule.name}`);
+  console.log(`  ${source_default.dim("Skill:")} ${schedule.skillSlug}`);
+  console.log(`  ${source_default.dim("Status:")} ${formatStatus3(schedule.status)}`);
+  console.log(`  ${source_default.dim("Type:")} ${schedule.scheduleType === "cron" ? "Recurring" : "One-time"}`);
+  console.log(`  ${source_default.dim("Schedule:")} ${schedule.scheduleDescription || schedule.cronExpression || formatDate(schedule.scheduledAt)}`);
+  console.log(`  ${source_default.dim("Timezone:")} ${schedule.timezone}`);
+  if (schedule.command) {
+    console.log(`  ${source_default.dim("Command:")} ${schedule.command}`);
+  }
+  console.log(`  ${source_default.dim("Runs:")} ${schedule.runCount}${schedule.maxRuns ? `/${schedule.maxRuns}` : ""}`);
+  if (schedule.nextRunAt) {
+    console.log(`  ${source_default.dim("Next Run:")} ${formatDate(schedule.nextRunAt)} (${formatRelativeTime(schedule.nextRunAt)})`);
+  }
+  if (schedule.lastRunAt) {
+    console.log(`  ${source_default.dim("Last Run:")} ${formatDate(schedule.lastRunAt)} - ${formatStatus3(schedule.lastRunStatus || "unknown")}`);
+  }
+  console.log(`  ${source_default.dim("Created:")} ${formatDate(schedule.createdAt)}`);
+}
+function printRunSummary(run) {
+  const statusIcon = run.status === "completed" ? source_default.green("✓") : source_default.red("✗");
+  const duration = run.durationMs ? formatDuration3(run.durationMs) : "-";
+  console.log(`  ${statusIcon} Run #${run.runNumber} - ${formatStatus3(run.status)}`);
+  console.log(`    ${source_default.dim("Time:")} ${formatDate(run.createdAt)}`);
+  console.log(`    ${source_default.dim("Duration:")} ${duration}`);
+  if (run.creditsUsed) {
+    console.log(`    ${source_default.dim("Credits:")} ${run.creditsUsed}`);
+  }
+  if (run.errorMessage) {
+    console.log(`    ${source_default.dim("Error:")} ${source_default.red(run.errorMessage)}`);
+  }
+}
+function getStatusIcon2(status) {
+  switch (status) {
+    case "active":
+      return source_default.green("●");
+    case "paused":
+      return source_default.yellow("◐");
+    case "completed":
+      return source_default.blue("✓");
+    case "failed":
+      return source_default.red("✗");
+    case "cancelled":
+      return source_default.dim("○");
+    default:
+      return source_default.dim("○");
+  }
+}
+function formatStatus3(status) {
+  switch (status) {
+    case "active":
+      return source_default.green("active");
+    case "paused":
+      return source_default.yellow("paused");
+    case "completed":
+      return source_default.blue("completed");
+    case "failed":
+      return source_default.red("failed");
+    case "cancelled":
+      return source_default.dim("cancelled");
+    default:
+      return source_default.dim(status || "unknown");
+  }
+}
+function formatDate(dateString) {
+  if (!dateString)
+    return "-";
+  const date = new Date(dateString);
+  return date.toLocaleString();
+}
+function formatRelativeTime(dateString) {
+  const date = new Date(dateString);
+  const now = new Date;
+  const diffMs = date.getTime() - now.getTime();
+  const diffMins = Math.round(diffMs / 60000);
+  const diffHours = Math.round(diffMs / 3600000);
+  const diffDays = Math.round(diffMs / 86400000);
+  if (diffMins < 0) {
+    if (diffMins > -60)
+      return `${Math.abs(diffMins)}m ago`;
+    if (diffHours > -24)
+      return `${Math.abs(diffHours)}h ago`;
+    return `${Math.abs(diffDays)}d ago`;
+  }
+  if (diffMins < 60)
+    return `in ${diffMins}m`;
+  if (diffHours < 24)
+    return `in ${diffHours}h`;
+  return `in ${diffDays}d`;
+}
+function formatDuration3(ms) {
+  if (ms < 1000) {
+    return `${ms}ms`;
+  } else if (ms < 60000) {
+    return `${(ms / 1000).toFixed(1)}s`;
+  } else {
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.floor(ms % 60000 / 1000);
+    return `${minutes}m ${seconds}s`;
+  }
+}
+
 // src/index.ts
-var indigo12 = colors.primary;
+var indigo13 = colors.primary;
 var program2 = new Command;
-program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.37");
+program2.name("skills").description("CLI for skills.md - AI Agent Skills Marketplace").version("0.1.39");
 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 });
 });
@@ -23759,11 +24385,13 @@ program2.command("marketplace").alias("market").description("Browse skills from
     category: options.category
   });
 });
-program2.command("install [name]").alias("i").description("Install a skill or all skills (global by default)").option("-l, --local", "Install to current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").option("-a, --all", "Install all skills from marketplace").action((name, options) => {
+program2.command("install [name]").alias("i").description("Install a skill, all skills, or skills by tag (global by default)").option("-l, --local", "Install to current project instead of global").option("-t, --target <target>", "Target platform (claude, codex)").option("-a, --all", "Install all skills from marketplace").option("--tag <tag>", "Install all skills with a specific tag").option("-f, --force", "Skip confirmation prompt").action((name, options) => {
   installCommand(name || "", {
     local: options.local,
     target: options.target,
-    all: options.all
+    all: options.all,
+    tag: options.tag,
+    force: options.force
   });
 });
 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) => {
@@ -23847,8 +24475,36 @@ program2.command("update [skill]").description("Update installed skills (refresh
 });
 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);
+var scheduleCmd = program2.command("schedule").description("Schedule skills to run automatically");
+scheduleCmd.command("create <skill> [schedule]").description("Create a new schedule (use natural language or --cron/--at)").option("-c, --cron <expression>", "Cron expression (e.g., '0 9 * * 1' for every Monday at 9am)").option("-a, --at <datetime>", "One-time schedule (ISO 8601 format)").option("--command <command>", "Skill command to run").option("-t, --timezone <timezone>", "Timezone (default: UTC)").option("-m, --max-runs <number>", "Maximum number of runs").option("-n, --name <name>", "Schedule name").action((skill, schedule, options) => {
+  scheduleCreateCommand(skill, schedule, {
+    cron: options.cron,
+    at: options.at,
+    command: options.command,
+    timezone: options.timezone,
+    maxRuns: options.maxRuns ? parseInt(options.maxRuns, 10) : undefined,
+    name: options.name
+  });
+});
+scheduleCmd.command("list").alias("ls").description("List all schedules").option("-s, --status <status>", "Filter by status (active, paused, completed, failed, cancelled)").option("-k, --skill <skill>", "Filter by skill slug").option("-n, --limit <number>", "Limit number of results").action((options) => {
+  scheduleListCommand({
+    status: options.status,
+    skill: options.skill,
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
+  });
+});
+scheduleCmd.command("get <id>").description("Get schedule details").action(scheduleGetCommand);
+scheduleCmd.command("pause <id>").description("Pause a schedule").action(schedulePauseCommand);
+scheduleCmd.command("resume <id>").description("Resume a paused schedule").action(scheduleResumeCommand);
+scheduleCmd.command("cancel <id>").description("Cancel a schedule").action(scheduleCancelCommand);
+scheduleCmd.command("history <id>").description("View run history for a schedule").option("-s, --status <status>", "Filter by run status").option("-n, --limit <number>", "Limit number of results").action((id, options) => {
+  scheduleHistoryCommand(id, {
+    status: options.status,
+    limit: options.limit ? parseInt(options.limit, 10) : undefined
+  });
+});
 program2.addHelpText("after", `
-${indigo12.bold("Examples:")}
+${indigo13.bold("Examples:")}
   ${source_default.dim("# Initialize in current project")}
   $ skills init
 
@@ -23867,6 +24523,10 @@ ${indigo12.bold("Examples:")}
   ${source_default.dim("# Install globally for Claude Code")}
   $ skills install code-review -g -t claude
 
+  ${source_default.dim("# Install all skills with a tag")}
+  $ skills install --tag automation
+  $ skills install --tag ai -f  ${source_default.dim("# skip confirmation")}
+
   ${source_default.dim("# AI-powered setup wizard")}
   $ skills setup
   $ skills setup "SaaS application with API"
@@ -23913,7 +24573,23 @@ ${indigo12.bold("Examples:")}
   ${source_default.dim("# Check environment")}
   $ skills doctor
 
-${indigo12.bold("Documentation:")}
-  ${indigo12("https://skills.md/docs")}
+  ${source_default.dim("# Schedule a skill (natural language)")}
+  $ skills schedule create calendar-events "every Monday at 9am" --command list
+  $ skills schedule create linear-issues "daily at midnight" --command sync
+
+  ${source_default.dim("# Schedule a skill (cron expression)")}
+  $ skills schedule create calendar-events --cron "0 9 * * 1-5" --command list
+
+  ${source_default.dim("# Schedule a one-time run")}
+  $ skills schedule create compose-gmail --at "2025-01-15T09:00:00"
+
+  ${source_default.dim("# Manage schedules")}
+  $ skills schedule list
+  $ skills schedule pause <id>
+  $ skills schedule resume <id>
+  $ skills schedule history <id>
+
+${indigo13.bold("Documentation:")}
+  ${indigo13("https://skills.md/docs")}
 `);
 program2.parse();

package/package.json

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