cursor-kit-cli 1.1.1 → 1.2.0-beta.2

package/dist/cli.cjs

@@ -28,7 +28,7 @@ var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${_
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
 // src/cli.ts
-var import_citty6 = require("citty");
+var import_citty7 = require("citty");
 var import_node_module = require("module");
 
 // src/utils/branding.ts
@@ -54,6 +54,9 @@ function printSuccess(message) {
 function printInfo(message) {
   console.log(import_picocolors.default.cyan("\u2139") + import_picocolors.default.dim(" ") + message);
 }
+function printWarning(message) {
+  console.log(import_picocolors.default.yellow("\u26A0") + import_picocolors.default.dim(" ") + message);
+}
 function printDivider() {
   console.log(import_picocolors.default.dim("\u2500".repeat(50)));
 }
@@ -63,8 +66,8 @@ function printVersion(version) {
   );
   console.log();
 }
-function highlight(text2) {
-  return import_picocolors.default.cyan(text2);
+function highlight(text3) {
+  return import_picocolors.default.cyan(text3);
 }
 
 // src/commands/init.ts
@@ -99,6 +102,9 @@ function removeFile(path) {
     (0, import_node_fs.rmSync)(path, { recursive: true });
   }
 }
+function copyDir(src, dest) {
+  (0, import_node_fs.cpSync)(src, dest, { recursive: true });
+}
 function listFiles(dir, extension) {
   if (!dirExists(dir)) return [];
   const files = (0, import_node_fs.readdirSync)(dir);
@@ -107,6 +113,13 @@ function listFiles(dir, extension) {
   }
   return files;
 }
+function listDirs(dir) {
+  if (!dirExists(dir)) return [];
+  return (0, import_node_fs.readdirSync)(dir).filter((item) => {
+    const itemPath = (0, import_node_path.join)(dir, item);
+    return (0, import_node_fs.statSync)(itemPath).isDirectory();
+  });
+}
 function getCursorDir(cwd = process.cwd()) {
   return (0, import_node_path.join)(cwd, ".cursor");
 }
@@ -116,10 +129,17 @@ function getCommandsDir(cwd = process.cwd()) {
 function getRulesDir(cwd = process.cwd()) {
   return (0, import_node_path.join)(getCursorDir(cwd), "rules");
 }
+function getSkillsDir(cwd = process.cwd()) {
+  return (0, import_node_path.join)(getCursorDir(cwd), "skills");
+}
 function getConflictingFiles(dir, files) {
   if (!dirExists(dir)) return [];
   return files.filter((file) => fileExists((0, import_node_path.join)(dir, file)));
 }
+function getConflictingDirs(dir, dirs) {
+  if (!dirExists(dir)) return [];
+  return dirs.filter((d) => dirExists((0, import_node_path.join)(dir, d)));
+}
 
 // src/utils/templates.ts
 var import_node_path2 = require("path");
@@ -131,7 +151,8 @@ var REPO_REF = "master";
 var REPO_RAW_URL = "https://raw.githubusercontent.com/duongductrong/cursor-kit/master";
 var TEMPLATE_PATHS = {
   commands: "templates/commands",
-  rules: "templates/rules"
+  rules: "templates/rules",
+  skills: "templates/skills"
 };
 
 // src/utils/templates.ts
@@ -151,12 +172,14 @@ function getLocalManifest() {
   }
   const commandsDir = (0, import_node_path2.join)(templatesDir, "commands");
   const rulesDir = (0, import_node_path2.join)(templatesDir, "rules");
-  if (!dirExists(commandsDir) && !dirExists(rulesDir)) {
+  const skillsDir = (0, import_node_path2.join)(templatesDir, "skills");
+  if (!dirExists(commandsDir) && !dirExists(rulesDir) && !dirExists(skillsDir)) {
     return null;
   }
   return {
     commands: dirExists(commandsDir) ? listFiles(commandsDir, ".md") : [],
-    rules: dirExists(rulesDir) ? listFiles(rulesDir, ".mdc") : []
+    rules: dirExists(rulesDir) ? listFiles(rulesDir, ".mdc") : [],
+    skills: dirExists(skillsDir) ? listDirs(skillsDir) : []
   };
 }
 function getLocalTemplateContent(type, filename) {
@@ -167,6 +190,22 @@ function getLocalTemplateContent(type, filename) {
   }
   return null;
 }
+function getLocalSkillDir(skillName) {
+  const templatesDir = getLocalTemplatesDir();
+  const skillPath = (0, import_node_path2.join)(templatesDir, "skills", skillName);
+  if (dirExists(skillPath)) {
+    return skillPath;
+  }
+  return null;
+}
+function copyLocalSkill(skillName, targetDir) {
+  const sourcePath = getLocalSkillDir(skillName);
+  if (!sourcePath) return false;
+  const destPath = (0, import_node_path2.join)(targetDir, skillName);
+  ensureDir(destPath);
+  copyDir(sourcePath, destPath);
+  return true;
+}
 async function fetchTemplateManifest() {
   const localManifest = getLocalManifest();
   if (localManifest) {
@@ -210,9 +249,13 @@ function getTemplateLabel(filename) {
   const nameWithoutExt = filename.replace(/\.(md|mdc)$/, "");
   return nameWithoutExt.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
+function getSkillLabel(skillName) {
+  return skillName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
 
 // src/commands/init.ts
 async function selectTemplates(type, availableTemplates) {
+  const labelFn = type === "skills" ? getSkillLabel : getTemplateLabel;
   const selectionMode = await p.select({
     message: `How would you like to add ${type}?`,
     options: [
@@ -236,7 +279,7 @@ async function selectTemplates(type, availableTemplates) {
     message: `Select ${type} to add:`,
     options: availableTemplates.map((template) => ({
       value: template,
-      label: getTemplateLabel(template),
+      label: labelFn(template),
       hint: template
     })),
     required: true
@@ -300,10 +343,36 @@ async function installTemplates(type, targetDir, selectedTemplates, conflictStra
   }
   return result;
 }
+async function installSkills(targetDir, selectedSkills, conflictStrategy) {
+  const result = { added: [], skipped: [] };
+  const conflictingDirs = getConflictingDirs(targetDir, selectedSkills);
+  let skillsToInstall;
+  if (conflictStrategy === "merge") {
+    skillsToInstall = selectedSkills.filter(
+      (s) => !conflictingDirs.includes(s)
+    );
+    result.skipped = conflictingDirs.filter(
+      (d) => selectedSkills.includes(d)
+    );
+  } else {
+    skillsToInstall = selectedSkills;
+  }
+  if (skillsToInstall.length === 0) {
+    return result;
+  }
+  ensureDir(targetDir);
+  for (const skillName of skillsToInstall) {
+    const success = copyLocalSkill(skillName, targetDir);
+    if (success) {
+      result.added.push(skillName);
+    }
+  }
+  return result;
+}
 var initCommand = (0, import_citty.defineCommand)({
   meta: {
     name: "init",
-    description: "Initialize .cursor/commands and .cursor/rules in your project"
+    description: "Initialize .cursor/commands, .cursor/rules, and .cursor/skills in your project"
   },
   args: {
     force: {
@@ -324,6 +393,12 @@ var initCommand = (0, import_citty.defineCommand)({
       description: "Only initialize rules",
       default: false
     },
+    skills: {
+      type: "boolean",
+      alias: "s",
+      description: "Only initialize skills",
+      default: false
+    },
     all: {
       type: "boolean",
       alias: "a",
@@ -336,9 +411,11 @@ var initCommand = (0, import_citty.defineCommand)({
     const cursorDir = getCursorDir(cwd);
     const commandsDir = getCommandsDir(cwd);
     const rulesDir = getRulesDir(cwd);
-    const initBoth = !args.commands && !args.rules;
-    const shouldInitCommands = initBoth || args.commands;
-    const shouldInitRules = initBoth || args.rules;
+    const skillsDir = getSkillsDir(cwd);
+    const initAll = !args.commands && !args.rules && !args.skills;
+    const shouldInitCommands = initAll || args.commands;
+    const shouldInitRules = initAll || args.rules;
+    const shouldInitSkills = initAll || args.skills;
     p.intro(import_picocolors2.default.bgCyan(import_picocolors2.default.black(" cursor-kit init ")));
     const s = p.spinner();
     let manifest;
@@ -421,6 +498,36 @@ var initCommand = (0, import_citty.defineCommand)({
         );
         s.stop("Rules installed");
       }
+      if (shouldInitSkills) {
+        let selectedSkills;
+        if (args.all) {
+          selectedSkills = manifest.skills;
+        } else {
+          const selection = await selectTemplates("skills", manifest.skills);
+          if (p.isCancel(selection)) {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          selectedSkills = selection;
+        }
+        const conflictingSkills = getConflictingDirs(skillsDir, selectedSkills);
+        let skillStrategy = "overwrite";
+        if (conflictingSkills.length > 0 && !args.force) {
+          const strategy = await handleConflicts("skills", conflictingSkills);
+          if (p.isCancel(strategy) || strategy === "cancel") {
+            p.cancel("Operation cancelled");
+            process.exit(0);
+          }
+          skillStrategy = strategy;
+        }
+        s.start("Installing skills...");
+        results.skills = await installSkills(
+          skillsDir,
+          selectedSkills,
+          skillStrategy
+        );
+        s.stop("Skills installed");
+      }
       printDivider();
       console.log();
       if (results.commands) {
@@ -451,8 +558,22 @@ var initCommand = (0, import_citty.defineCommand)({
           }
         }
       }
-      const totalAdded = (results.commands?.added.length ?? 0) + (results.rules?.added.length ?? 0);
-      const totalSkipped = (results.commands?.skipped.length ?? 0) + (results.rules?.skipped.length ?? 0);
+      if (results.skills) {
+        const { added, skipped } = results.skills;
+        if (added.length > 0 || skipped.length > 0) {
+          printSuccess(
+            `Skills: ${highlight(added.length.toString())} added${skipped.length > 0 ? `, ${import_picocolors2.default.yellow(skipped.length.toString())} skipped` : ""}`
+          );
+          for (const f of added) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.green("+")} ${f}`));
+          }
+          for (const f of skipped) {
+            console.log(import_picocolors2.default.dim(`   \u2514\u2500 ${import_picocolors2.default.yellow("\u25CB")} ${f} (kept existing)`));
+          }
+        }
+      }
+      const totalAdded = (results.commands?.added.length ?? 0) + (results.rules?.added.length ?? 0) + (results.skills?.added.length ?? 0);
+      const totalSkipped = (results.commands?.skipped.length ?? 0) + (results.rules?.skipped.length ?? 0) + (results.skills?.skipped.length ?? 0);
       if (totalAdded === 0 && totalSkipped > 0) {
         console.log();
         p.outro(import_picocolors2.default.yellow("No new templates added (all selected files already exist)"));
@@ -471,10 +592,10 @@ var initCommand = (0, import_citty.defineCommand)({
 });
 
 // src/commands/add.ts
-var import_citty2 = require("citty");
 var p2 = __toESM(require("@clack/prompts"), 1);
-var import_picocolors3 = __toESM(require("picocolors"), 1);
+var import_citty2 = require("citty");
 var import_node_path4 = require("path");
+var import_picocolors3 = __toESM(require("picocolors"), 1);
 var COMMAND_TEMPLATE = `You are a helpful assistant. Describe what this command does.
 
 ## Instructions
@@ -501,31 +622,69 @@ Describe the rule behavior here.
 - Guideline 1
 - Guideline 2
 `;
+var SKILL_TEMPLATE = `---
+description: Describe when this skill should be activated
+globs:
+alwaysApply: false
+---
+
+# Skill Name
+
+Brief description of what this skill enables.
+
+## Core Capabilities
+
+- Capability 1
+- Capability 2
+
+## When to Use
+
+Use this skill when:
+- Condition 1
+- Condition 2
+
+## References
+
+For detailed guidance, see the references folder:
+- [Reference 1](./references/example.md) - Description
+`;
+var SKILL_REFERENCE_TEMPLATE = `# Reference Title
+
+Detailed reference content goes here.
+
+## Section 1
+
+Content...
+
+## Section 2
+
+Content...
+`;
 function generateSlug(name) {
   return name.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").trim();
 }
 var addCommand = (0, import_citty2.defineCommand)({
   meta: {
     name: "add",
-    description: "Add a new command or rule"
+    description: "Add a new command, rule, or skill"
   },
   args: {
     type: {
       type: "string",
       alias: "t",
-      description: "Type: 'command' or 'rule'"
+      description: "Type: 'command', 'rule', or 'skill'"
     },
     name: {
       type: "string",
       alias: "n",
-      description: "Name of the command or rule"
+      description: "Name of the command, rule, or skill"
     }
   },
   async run({ args }) {
     p2.intro(import_picocolors3.default.bgCyan(import_picocolors3.default.black(" cursor-kit add ")));
     let itemType;
     let itemName;
-    if (args.type && ["command", "rule"].includes(args.type)) {
+    if (args.type && ["command", "rule", "skill"].includes(args.type)) {
       itemType = args.type;
     } else {
       const typeResult = await p2.select({
@@ -540,6 +699,11 @@ var addCommand = (0, import_citty2.defineCommand)({
             value: "rule",
             label: "Rule",
             hint: "Project-specific AI behavior rules"
+          },
+          {
+            value: "skill",
+            label: "Skill",
+            hint: "Comprehensive guide with references"
           }
         ]
       });
@@ -554,7 +718,7 @@ var addCommand = (0, import_citty2.defineCommand)({
     } else {
       const nameResult = await p2.text({
         message: `Enter ${itemType} name:`,
-        placeholder: itemType === "command" ? "my-command" : "my-rule",
+        placeholder: itemType === "command" ? "my-command" : itemType === "rule" ? "my-rule" : "my-skill",
         validate: (value) => {
           if (!value.trim()) return "Name is required";
           if (value.length < 2) return "Name must be at least 2 characters";
@@ -569,12 +733,22 @@ var addCommand = (0, import_citty2.defineCommand)({
     }
     const slug = generateSlug(itemName);
     const isCommand = itemType === "command";
-    const targetDir = isCommand ? getCommandsDir() : getRulesDir();
-    const extension = isCommand ? ".md" : ".mdc";
-    const filePath = (0, import_node_path4.join)(targetDir, `${slug}${extension}`);
-    if (fileExists(filePath)) {
+    const isSkill = itemType === "skill";
+    let targetPath;
+    let displayPath;
+    if (isSkill) {
+      const skillsDir = getSkillsDir();
+      targetPath = (0, import_node_path4.join)(skillsDir, slug);
+      displayPath = targetPath;
+    } else {
+      const targetDir = isCommand ? getCommandsDir() : getRulesDir();
+      const extension = isCommand ? ".md" : ".mdc";
+      targetPath = (0, import_node_path4.join)(targetDir, `${slug}${extension}`);
+      displayPath = targetPath;
+    }
+    if (isSkill ? dirExists(targetPath) : fileExists(targetPath)) {
       const shouldOverwrite = await p2.confirm({
-        message: `${highlight(slug + extension)} already exists. Overwrite?`,
+        message: `${highlight(isSkill ? slug : slug + (isCommand ? ".md" : ".mdc"))} already exists. Overwrite?`,
         initialValue: false
       });
       if (p2.isCancel(shouldOverwrite) || !shouldOverwrite) {
@@ -585,12 +759,25 @@ var addCommand = (0, import_citty2.defineCommand)({
     const s = p2.spinner();
     s.start(`Creating ${itemType}...`);
     try {
-      ensureDir(targetDir);
-      const template = isCommand ? COMMAND_TEMPLATE : RULE_TEMPLATE;
-      writeFile(filePath, template);
+      if (isSkill) {
+        ensureDir(targetPath);
+        ensureDir((0, import_node_path4.join)(targetPath, "references"));
+        writeFile((0, import_node_path4.join)(targetPath, "SKILL.mdc"), SKILL_TEMPLATE);
+        writeFile((0, import_node_path4.join)(targetPath, "references", "example.md"), SKILL_REFERENCE_TEMPLATE);
+      } else {
+        const targetDir = isCommand ? getCommandsDir() : getRulesDir();
+        ensureDir(targetDir);
+        const template = isCommand ? COMMAND_TEMPLATE : RULE_TEMPLATE;
+        writeFile(targetPath, template);
+      }
       s.stop(`${itemType.charAt(0).toUpperCase() + itemType.slice(1)} created`);
       console.log();
-      console.log(import_picocolors3.default.dim("  File: ") + highlight(filePath));
+      if (isSkill) {
+        console.log(import_picocolors3.default.dim("  Directory: ") + highlight(displayPath));
+        console.log(import_picocolors3.default.dim("  Main file: ") + highlight((0, import_node_path4.join)(displayPath, "SKILL.mdc")));
+      } else {
+        console.log(import_picocolors3.default.dim("  File: ") + highlight(displayPath));
+      }
       console.log();
       p2.outro(
         import_picocolors3.default.green(`\u2728 ${itemType.charAt(0).toUpperCase() + itemType.slice(1)} created! Edit the file to customize it.`)
@@ -626,6 +813,12 @@ var pullCommand = (0, import_citty3.defineCommand)({
       description: "Only pull rules",
       default: false
     },
+    skills: {
+      type: "boolean",
+      alias: "s",
+      description: "Only pull skills",
+      default: false
+    },
     force: {
       type: "boolean",
       alias: "f",
@@ -634,15 +827,18 @@ var pullCommand = (0, import_citty3.defineCommand)({
     }
   },
   async run({ args }) {
-    const pullBoth = !args.commands && !args.rules;
-    const shouldPullCommands = pullBoth || args.commands;
-    const shouldPullRules = pullBoth || args.rules;
+    const pullAll = !args.commands && !args.rules && !args.skills;
+    const shouldPullCommands = pullAll || args.commands;
+    const shouldPullRules = pullAll || args.rules;
+    const shouldPullSkills = pullAll || args.skills;
     p3.intro(import_picocolors4.default.bgCyan(import_picocolors4.default.black(" cursor-kit pull ")));
     const commandsDir = getCommandsDir();
     const rulesDir = getRulesDir();
+    const skillsDir = getSkillsDir();
     const existingCommands = listFiles(commandsDir, ".md");
     const existingRules = listFiles(rulesDir, ".mdc");
-    const hasExisting = existingCommands.length > 0 || existingRules.length > 0;
+    const existingSkills = listDirs(skillsDir);
+    const hasExisting = existingCommands.length > 0 || existingRules.length > 0 || existingSkills.length > 0;
     if (hasExisting && !args.force) {
       printInfo("Current status:");
       if (existingCommands.length > 0) {
@@ -651,6 +847,9 @@ var pullCommand = (0, import_citty3.defineCommand)({
       if (existingRules.length > 0) {
         console.log(import_picocolors4.default.dim(`  Rules: ${existingRules.length} files`));
       }
+      if (existingSkills.length > 0) {
+        console.log(import_picocolors4.default.dim(`  Skills: ${existingSkills.length} directories`));
+      }
       console.log();
       const shouldContinue = await p3.confirm({
         message: "This will merge with existing files. Continue?",
@@ -680,10 +879,19 @@ var pullCommand = (0, import_citty3.defineCommand)({
         });
         s.stop("Rules updated");
       }
+      if (shouldPullSkills) {
+        s.start("Pulling skills...");
+        await (0, import_giget.downloadTemplate)(`${REPO_URL}/templates/skills#${REPO_REF}`, {
+          dir: skillsDir,
+          force: true
+        });
+        s.stop("Skills updated");
+      }
       printDivider();
       console.log();
       const newCommands = listFiles(commandsDir, ".md");
       const newRules = listFiles(rulesDir, ".mdc");
+      const newSkills = listDirs(skillsDir);
       if (shouldPullCommands) {
         const added = newCommands.length - existingCommands.length;
         printSuccess(
@@ -696,6 +904,12 @@ var pullCommand = (0, import_citty3.defineCommand)({
           `Rules: ${highlight(newRules.length.toString())} total` + (added > 0 ? import_picocolors4.default.green(` (+${added} new)`) : "")
         );
       }
+      if (shouldPullSkills) {
+        const added = newSkills.length - existingSkills.length;
+        printSuccess(
+          `Skills: ${highlight(newSkills.length.toString())} total` + (added > 0 ? import_picocolors4.default.green(` (+${added} new)`) : "")
+        );
+      }
       console.log();
       p3.outro(import_picocolors4.default.green("\u2728 Successfully pulled latest updates!"));
     } catch (error) {
@@ -707,10 +921,10 @@ var pullCommand = (0, import_citty3.defineCommand)({
 });
 
 // src/commands/list.ts
-var import_citty4 = require("citty");
 var p4 = __toESM(require("@clack/prompts"), 1);
-var import_picocolors5 = __toESM(require("picocolors"), 1);
+var import_citty4 = require("citty");
 var import_node_path5 = require("path");
+var import_picocolors5 = __toESM(require("picocolors"), 1);
 function extractDescription(content, isCommand) {
   if (isCommand) {
     const firstLine = content.trim().split("\n")[0];
@@ -737,10 +951,31 @@ function getItems(dir, extension, isCommand) {
     };
   });
 }
+function getSkills(dir) {
+  const skillDirs = listDirs(dir);
+  return skillDirs.map((skillName) => {
+    const skillPath = (0, import_node_path5.join)(dir, skillName);
+    const skillFile = (0, import_node_path5.join)(skillPath, "SKILL.mdc");
+    const altSkillFile = (0, import_node_path5.join)(skillPath, "SKILL.md");
+    let description;
+    if (fileExists(skillFile)) {
+      const content = readFile(skillFile);
+      description = extractDescription(content, false);
+    } else if (fileExists(altSkillFile)) {
+      const content = readFile(altSkillFile);
+      description = extractDescription(content, false);
+    }
+    return {
+      name: skillName,
+      path: skillPath,
+      description
+    };
+  });
+}
 var listCommand = (0, import_citty4.defineCommand)({
   meta: {
     name: "list",
-    description: "List all commands and rules"
+    description: "List all commands, rules, and skills"
   },
   args: {
     commands: {
@@ -755,6 +990,12 @@ var listCommand = (0, import_citty4.defineCommand)({
       description: "Only list rules",
       default: false
     },
+    skills: {
+      type: "boolean",
+      alias: "s",
+      description: "Only list skills",
+      default: false
+    },
     verbose: {
       type: "boolean",
       alias: "v",
@@ -763,18 +1004,23 @@ var listCommand = (0, import_citty4.defineCommand)({
     }
   },
   async run({ args }) {
-    const listBoth = !args.commands && !args.rules;
-    const shouldListCommands = listBoth || args.commands;
-    const shouldListRules = listBoth || args.rules;
+    const listAll = !args.commands && !args.rules && !args.skills;
+    const shouldListCommands = listAll || args.commands;
+    const shouldListRules = listAll || args.rules;
+    const shouldListSkills = listAll || args.skills;
     p4.intro(import_picocolors5.default.bgCyan(import_picocolors5.default.black(" cursor-kit list ")));
     const commandsDir = getCommandsDir();
     const rulesDir = getRulesDir();
+    const skillsDir = getSkillsDir();
     const commands = shouldListCommands ? getItems(commandsDir, ".md", true) : [];
     const rules = shouldListRules ? getItems(rulesDir, ".mdc", false) : [];
-    if (commands.length === 0 && rules.length === 0) {
+    const skills = shouldListSkills ? getSkills(skillsDir) : [];
+    if (commands.length === 0 && rules.length === 0 && skills.length === 0) {
       console.log();
-      console.log(import_picocolors5.default.yellow("  No commands or rules found."));
-      console.log(import_picocolors5.default.dim("  Run ") + highlight("cursor-kit init") + import_picocolors5.default.dim(" to get started."));
+      console.log(import_picocolors5.default.yellow("  No commands, rules, or skills found."));
+      console.log(
+        import_picocolors5.default.dim("  Run ") + highlight("cursor-kit init") + import_picocolors5.default.dim(" to get started.")
+      );
       console.log();
       p4.outro(import_picocolors5.default.dim("Nothing to show"));
       return;
@@ -782,7 +1028,9 @@ var listCommand = (0, import_citty4.defineCommand)({
     printDivider();
     if (shouldListCommands && commands.length > 0) {
       console.log();
-      console.log(import_picocolors5.default.bold(import_picocolors5.default.cyan("  \u{1F4DC} Commands")) + import_picocolors5.default.dim(` (${commands.length})`));
+      console.log(
+        import_picocolors5.default.bold(import_picocolors5.default.cyan("  \u{1F4DC} Commands")) + import_picocolors5.default.dim(` (${commands.length})`)
+      );
       console.log();
       commands.forEach((cmd) => {
         console.log(`  ${import_picocolors5.default.green("\u25CF")} ${highlight(cmd.name)}`);
@@ -796,7 +1044,9 @@ var listCommand = (0, import_citty4.defineCommand)({
     }
     if (shouldListRules && rules.length > 0) {
       console.log();
-      console.log(import_picocolors5.default.bold(import_picocolors5.default.cyan("  \u{1F4CB} Rules")) + import_picocolors5.default.dim(` (${rules.length})`));
+      console.log(
+        import_picocolors5.default.bold(import_picocolors5.default.cyan("  \u{1F4CB} Rules")) + import_picocolors5.default.dim(` (${rules.length})`)
+      );
       console.log();
       rules.forEach((rule) => {
         console.log(`  ${import_picocolors5.default.green("\u25CF")} ${highlight(rule.name)}`);
@@ -808,9 +1058,25 @@ var listCommand = (0, import_citty4.defineCommand)({
         }
       });
     }
+    if (shouldListSkills && skills.length > 0) {
+      console.log();
+      console.log(
+        import_picocolors5.default.bold(import_picocolors5.default.cyan("  \u{1F3AF} Skills")) + import_picocolors5.default.dim(` (${skills.length})`)
+      );
+      console.log();
+      skills.forEach((skill) => {
+        console.log(`  ${import_picocolors5.default.green("\u25CF")} ${highlight(skill.name)}`);
+        if (skill.description) {
+          console.log(import_picocolors5.default.dim(`    ${skill.description}`));
+        }
+        if (args.verbose) {
+          console.log(import_picocolors5.default.dim(`    ${skill.path}`));
+        }
+      });
+    }
     console.log();
     printDivider();
-    const total = commands.length + rules.length;
+    const total = commands.length + rules.length + skills.length;
     p4.outro(import_picocolors5.default.dim(`Total: ${total} item${total !== 1 ? "s" : ""}`));
   }
 });
@@ -823,18 +1089,18 @@ var import_node_path6 = require("path");
 var removeCommand = (0, import_citty5.defineCommand)({
   meta: {
     name: "remove",
-    description: "Remove a command or rule"
+    description: "Remove a command, rule, or skill"
   },
   args: {
     type: {
       type: "string",
       alias: "t",
-      description: "Type: 'command' or 'rule'"
+      description: "Type: 'command', 'rule', or 'skill'"
     },
     name: {
       type: "string",
       alias: "n",
-      description: "Name of the command or rule to remove"
+      description: "Name of the command, rule, or skill to remove"
     },
     force: {
       type: "boolean",
@@ -847,18 +1113,20 @@ var removeCommand = (0, import_citty5.defineCommand)({
     p5.intro(import_picocolors6.default.bgCyan(import_picocolors6.default.black(" cursor-kit remove ")));
     const commandsDir = getCommandsDir();
     const rulesDir = getRulesDir();
+    const skillsDir = getSkillsDir();
     const commands = listFiles(commandsDir, ".md").map((f) => f.replace(".md", ""));
     const rules = listFiles(rulesDir, ".mdc").map((f) => f.replace(".mdc", ""));
-    if (commands.length === 0 && rules.length === 0) {
+    const skills = listDirs(skillsDir);
+    if (commands.length === 0 && rules.length === 0 && skills.length === 0) {
       console.log();
-      console.log(import_picocolors6.default.yellow("  No commands or rules to remove."));
+      console.log(import_picocolors6.default.yellow("  No commands, rules, or skills to remove."));
       console.log();
       p5.outro(import_picocolors6.default.dim("Nothing to do"));
       return;
     }
     let itemType;
     let itemName;
-    if (args.type && ["command", "rule"].includes(args.type)) {
+    if (args.type && ["command", "rule", "skill"].includes(args.type)) {
       itemType = args.type;
     } else {
       const typeOptions = [];
@@ -876,6 +1144,13 @@ var removeCommand = (0, import_citty5.defineCommand)({
           hint: `${rules.length} available`
         });
       }
+      if (skills.length > 0) {
+        typeOptions.push({
+          value: "skill",
+          label: "Skill",
+          hint: `${skills.length} available`
+        });
+      }
       const typeResult = await p5.select({
         message: "What do you want to remove?",
         options: typeOptions
@@ -887,9 +1162,11 @@ var removeCommand = (0, import_citty5.defineCommand)({
       itemType = typeResult;
     }
     const isCommand = itemType === "command";
-    const items = isCommand ? commands : rules;
-    const dir = isCommand ? commandsDir : rulesDir;
-    const extension = isCommand ? ".md" : ".mdc";
+    const isRule = itemType === "rule";
+    const isSkill = itemType === "skill";
+    const items = isCommand ? commands : isRule ? rules : skills;
+    const dir = isCommand ? commandsDir : isRule ? rulesDir : skillsDir;
+    const extension = isCommand ? ".md" : isRule ? ".mdc" : "";
     if (items.length === 0) {
       p5.cancel(`No ${itemType}s found`);
       process.exit(0);
@@ -911,14 +1188,16 @@ var removeCommand = (0, import_citty5.defineCommand)({
       }
       itemName = nameResult;
     }
-    const filePath = (0, import_node_path6.join)(dir, `${itemName}${extension}`);
-    if (!fileExists(filePath)) {
+    const targetPath = isSkill ? (0, import_node_path6.join)(dir, itemName) : (0, import_node_path6.join)(dir, `${itemName}${extension}`);
+    const exists = isSkill ? dirExists(targetPath) : fileExists(targetPath);
+    if (!exists) {
       p5.cancel(`${itemType} '${itemName}' not found`);
       process.exit(1);
     }
     if (!args.force) {
+      const displayName = isSkill ? itemName : itemName + extension;
       const shouldDelete = await p5.confirm({
-        message: `Are you sure you want to delete ${highlight(itemName + extension)}?`,
+        message: `Are you sure you want to delete ${highlight(displayName)}?${isSkill ? " (This will remove the entire skill directory)" : ""}`,
         initialValue: false
       });
       if (p5.isCancel(shouldDelete) || !shouldDelete) {
@@ -927,9 +1206,10 @@ var removeCommand = (0, import_citty5.defineCommand)({
       }
     }
     try {
-      removeFile(filePath);
+      removeFile(targetPath);
+      const displayName = isSkill ? itemName : itemName + extension;
       console.log();
-      printSuccess(`Removed ${highlight(itemName + extension)}`);
+      printSuccess(`Removed ${highlight(displayName)}`);
       console.log();
       p5.outro(import_picocolors6.default.green("\u2728 Done!"));
     } catch (error) {
@@ -939,10 +1219,268 @@ var removeCommand = (0, import_citty5.defineCommand)({
   }
 });
 
+// src/commands/instance.ts
+var import_citty6 = require("citty");
+var p6 = __toESM(require("@clack/prompts"), 1);
+var import_picocolors7 = __toESM(require("picocolors"), 1);
+var import_node_child_process = require("child_process");
+var import_node_path7 = require("path");
+var import_node_url2 = require("url");
+var import_node_fs2 = require("fs");
+function getBinPath() {
+  const currentDir = (0, import_node_path7.dirname)((0, import_node_url2.fileURLToPath)(importMetaUrl));
+  const possiblePaths = [
+    (0, import_node_path7.join)(currentDir, "..", "..", "bin"),
+    (0, import_node_path7.join)(currentDir, "..", "bin")
+  ];
+  for (const binPath of possiblePaths) {
+    if ((0, import_node_fs2.existsSync)(binPath)) {
+      return binPath;
+    }
+  }
+  return possiblePaths[0];
+}
+function ensureExecutable(scriptPath) {
+  try {
+    (0, import_node_fs2.chmodSync)(scriptPath, 493);
+  } catch {
+  }
+}
+function getExistingInstances() {
+  const userAppsDir = (0, import_node_path7.join)(process.env.HOME ?? "", "Applications");
+  if (!(0, import_node_fs2.existsSync)(userAppsDir)) return [];
+  try {
+    const apps = (0, import_node_fs2.readdirSync)(userAppsDir);
+    return apps.filter((app) => app.startsWith("Cursor") && app.endsWith(".app") && app !== "Cursor.app").map((app) => ({
+      name: app.replace(".app", ""),
+      path: (0, import_node_path7.join)(userAppsDir, app)
+    }));
+  } catch {
+    return [];
+  }
+}
+function runScript(scriptPath, args) {
+  return new Promise((resolve2) => {
+    ensureExecutable(scriptPath);
+    const child = (0, import_node_child_process.spawn)(scriptPath, args, {
+      stdio: "inherit"
+    });
+    child.on("close", (code) => {
+      resolve2(code ?? 1);
+    });
+    child.on("error", () => {
+      resolve2(1);
+    });
+  });
+}
+var instanceCommand = (0, import_citty6.defineCommand)({
+  meta: {
+    name: "instance",
+    description: "Manage Cursor IDE instances for multi-account login (macOS only)"
+  },
+  args: {
+    action: {
+      type: "string",
+      alias: "a",
+      description: "Action: 'create' or 'remove'"
+    },
+    name: {
+      type: "string",
+      alias: "n",
+      description: "Name of the instance (e.g. 'Cursor Enterprise')"
+    },
+    list: {
+      type: "boolean",
+      alias: "l",
+      description: "List existing Cursor instances",
+      default: false
+    }
+  },
+  async run({ args }) {
+    p6.intro(import_picocolors7.default.bgCyan(import_picocolors7.default.black(" cursor-kit instance ")));
+    if (process.platform !== "darwin") {
+      console.log();
+      printWarning("This command only works on macOS.");
+      console.log(import_picocolors7.default.dim("  Cursor instance management requires macOS-specific features."));
+      console.log();
+      p6.outro(import_picocolors7.default.dim("Exiting"));
+      process.exit(1);
+    }
+    if (args.list) {
+      const instances = getExistingInstances();
+      printDivider();
+      console.log();
+      if (instances.length === 0) {
+        printInfo("No custom Cursor instances found.");
+        console.log(import_picocolors7.default.dim("  Run ") + highlight("cursor-kit instance") + import_picocolors7.default.dim(" to create one."));
+      } else {
+        console.log(import_picocolors7.default.bold(import_picocolors7.default.cyan("  \u{1F5A5}  Cursor Instances")) + import_picocolors7.default.dim(` (${instances.length})`));
+        console.log();
+        for (const instance of instances) {
+          console.log(`  ${import_picocolors7.default.green("\u25CF")} ${highlight(instance.name)}`);
+          console.log(import_picocolors7.default.dim(`    \u2514\u2500 ${instance.path}`));
+        }
+      }
+      console.log();
+      printDivider();
+      p6.outro(import_picocolors7.default.dim(`Total: ${instances.length} instance${instances.length !== 1 ? "s" : ""}`));
+      return;
+    }
+    const s = p6.spinner();
+    s.start("Checking prerequisites...");
+    const binPath = getBinPath();
+    const createScript = (0, import_node_path7.join)(binPath, "cursor-new-instance");
+    const removeScript = (0, import_node_path7.join)(binPath, "cursor-remove-instance");
+    const scriptsExist = (0, import_node_fs2.existsSync)(createScript) && (0, import_node_fs2.existsSync)(removeScript);
+    if (!scriptsExist) {
+      s.stop("Prerequisites check failed");
+      console.log();
+      printWarning("Required scripts not found.");
+      console.log(import_picocolors7.default.dim(`  Expected at: ${binPath}`));
+      console.log();
+      p6.outro(import_picocolors7.default.red("Installation may be corrupted"));
+      process.exit(1);
+    }
+    const originalCursor = "/Applications/Cursor.app";
+    if (!(0, import_node_fs2.existsSync)(originalCursor)) {
+      s.stop("Prerequisites check failed");
+      console.log();
+      printWarning("Cursor.app not found in /Applications");
+      console.log(import_picocolors7.default.dim("  Please install Cursor IDE first."));
+      console.log();
+      p6.outro(import_picocolors7.default.red("Cursor IDE required"));
+      process.exit(1);
+    }
+    s.stop("Prerequisites verified");
+    const existingInstances = getExistingInstances();
+    let action;
+    let instanceName;
+    if (args.action && ["create", "remove"].includes(args.action)) {
+      action = args.action;
+    } else {
+      const actionResult = await p6.select({
+        message: "What would you like to do?",
+        options: [
+          {
+            value: "create",
+            label: "Create new instance",
+            hint: "Clone Cursor with separate identity"
+          },
+          {
+            value: "remove",
+            label: "Remove instance",
+            hint: existingInstances.length > 0 ? `${existingInstances.length} instance${existingInstances.length !== 1 ? "s" : ""} available` : "No instances to remove"
+          }
+        ]
+      });
+      if (p6.isCancel(actionResult)) {
+        p6.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      action = actionResult;
+    }
+    if (args.name) {
+      instanceName = args.name;
+    } else if (action === "remove" && existingInstances.length > 0) {
+      const instanceResult = await p6.select({
+        message: "Select instance to remove:",
+        options: existingInstances.map((inst) => ({
+          value: inst.name,
+          label: inst.name,
+          hint: inst.path
+        }))
+      });
+      if (p6.isCancel(instanceResult)) {
+        p6.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      instanceName = instanceResult;
+    } else if (action === "remove" && existingInstances.length === 0) {
+      console.log();
+      printInfo("No custom Cursor instances found to remove.");
+      console.log();
+      p6.outro(import_picocolors7.default.dim("Nothing to do"));
+      return;
+    } else {
+      const nameResult = await p6.text({
+        message: "Enter a name for the new instance:",
+        placeholder: "Cursor Enterprise",
+        validate: (value) => {
+          if (!value.trim()) return "Instance name is required";
+          if (value.length < 2) return "Name must be at least 2 characters";
+          const existing = existingInstances.find(
+            (i) => i.name.toLowerCase() === value.toLowerCase()
+          );
+          if (existing) return `Instance "${value}" already exists`;
+          return void 0;
+        }
+      });
+      if (p6.isCancel(nameResult)) {
+        p6.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      instanceName = nameResult;
+    }
+    printDivider();
+    console.log();
+    console.log(import_picocolors7.default.bold(import_picocolors7.default.cyan("  \u{1F4CB} Summary")));
+    console.log();
+    console.log(`  ${import_picocolors7.default.dim("Action:")}    ${action === "create" ? import_picocolors7.default.green("Create") : import_picocolors7.default.yellow("Remove")}`);
+    console.log(`  ${import_picocolors7.default.dim("Instance:")}  ${highlight(instanceName)}`);
+    if (action === "create") {
+      const slug = instanceName.toLowerCase().replace(/[^a-z0-9]/g, "");
+      console.log(`  ${import_picocolors7.default.dim("Bundle ID:")} ${import_picocolors7.default.dim("com.cursor.")}${highlight(slug)}`);
+      console.log(`  ${import_picocolors7.default.dim("Location:")}  ${import_picocolors7.default.dim("~/Applications/")}${highlight(instanceName + ".app")}`);
+    } else {
+      const targetPath = (0, import_node_path7.join)(process.env.HOME ?? "", "Applications", `${instanceName}.app`);
+      console.log(`  ${import_picocolors7.default.dim("Path:")}      ${import_picocolors7.default.dim(targetPath)}`);
+    }
+    console.log();
+    printDivider();
+    console.log();
+    const shouldContinue = await p6.confirm({
+      message: action === "create" ? "Create this Cursor instance?" : "Remove this Cursor instance? This cannot be undone.",
+      initialValue: action === "create"
+    });
+    if (p6.isCancel(shouldContinue) || !shouldContinue) {
+      p6.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    console.log();
+    printDivider();
+    console.log();
+    const scriptPath = action === "create" ? createScript : removeScript;
+    const scriptArgs = action === "remove" ? ["--yes", instanceName] : [instanceName];
+    const exitCode = await runScript(scriptPath, scriptArgs);
+    console.log();
+    printDivider();
+    console.log();
+    if (exitCode === 0) {
+      if (action === "create") {
+        printSuccess(`Instance ${highlight(instanceName)} created successfully!`);
+        console.log();
+        console.log(import_picocolors7.default.dim("  Next steps:"));
+        console.log(import_picocolors7.default.dim("  \u2022 The new instance should launch automatically"));
+        console.log(import_picocolors7.default.dim("  \u2022 Sign in with a different Cursor account"));
+        console.log(import_picocolors7.default.dim("  \u2022 Find it in ~/Applications/"));
+      } else {
+        printSuccess(`Instance ${highlight(instanceName)} removed successfully!`);
+      }
+      console.log();
+      p6.outro(import_picocolors7.default.green("\u2728 Done!"));
+    } else {
+      printWarning(`Operation completed with exit code ${exitCode}`);
+      console.log();
+      p6.outro(import_picocolors7.default.yellow("Check the output above for details"));
+      process.exit(exitCode);
+    }
+  }
+});
+
 // src/cli.ts
 var require2 = (0, import_node_module.createRequire)(importMetaUrl);
 var pkg = require2("../package.json");
-var main = (0, import_citty6.defineCommand)({
+var main = (0, import_citty7.defineCommand)({
   meta: {
     name: "cursor-kit",
     version: pkg.version,
@@ -957,8 +1495,9 @@ var main = (0, import_citty6.defineCommand)({
     add: addCommand,
     pull: pullCommand,
     list: listCommand,
-    remove: removeCommand
+    remove: removeCommand,
+    instance: instanceCommand
   }
 });
-(0, import_citty6.runMain)(main);
+(0, import_citty7.runMain)(main);
 //# sourceMappingURL=cli.cjs.map