@robosoft/skillhub-cli 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.2
+
+- Fixed `skillhub init --target cursor` when `skillhub.json` already exists.
+- Existing projects now update `target`, `skillsDir`, and adapters instead of continuing to create `.ai/skills`.
+- Added clearer init output showing the active target.
+
+## 0.1.1
+
+- Added configurable install targets: `ai`, `cursor`, and `claude`.
+- Added `skillhub target` command.
+- Added `--target` / `--to` support for `init`, `install`, and `sync`.
+- Cursor skills now install under `.cursor/skills` and update `.cursor/rules/skillhub.mdc`.
+- Claude skills now install under `.claude/skills` and update `CLAUDE.md` plus `.claude/skillhub.md`.
+- Added `cloude` alias for `claude`.
+
+# Changelog
+
 ## 0.1.0
 
 Initial publishable release of SkillHub CLI.

package/README.md

@@ -72,18 +72,46 @@ node ./bin/skillhub.mjs --help
 
 ## Use in Any Project
 
-Create SkillHub config inside your target project:
+Create SkillHub config inside your target project. The CLI can now ask where to place skill files:
 
 ```bash
 skillhub init
 ```
 
+Or pass the target directly:
+
+```bash
+skillhub init --target cursor
+skillhub init --target claude
+skillhub init --target ai
+```
+
+Targets:
+
+```txt
+ai      -> .ai/skills + AGENTS.md
+cursor  -> .cursor/skills + .cursor/rules/skillhub.mdc
+claude  -> .claude/skills + CLAUDE.md + .claude/skillhub.md
+```
+
 Install a skill from a local registry:
 
 ```bash
 skillhub install nextjs-clean-architecture --registry ./skillhub-registry
 ```
 
+Install directly into Cursor skill location:
+
+```bash
+skillhub install nextjs-clean-architecture --target cursor --registry ./skillhub-registry
+```
+
+Install directly into Claude skill location:
+
+```bash
+skillhub install nextjs-clean-architecture --target claude --registry ./skillhub-registry
+```
+
 Install a specific version:
 
 ```bash
@@ -96,6 +124,14 @@ List installed skills:
 skillhub list
 ```
 
+Change target later:
+
+```bash
+skillhub target cursor
+skillhub target claude
+skillhub target ai
+```
+
 Sync all skills from `skillhub.json`:
 
 ```bash
@@ -149,12 +185,32 @@ npm run demo:validate
 
 ## Project Output
 
-After installing skills, the target project gets files like:
+After installing skills, the target project gets files based on the selected target.
+
+For `--target cursor`:
+
+```txt
+.cursor/skills/<skill-name>/
+.cursor/rules/skillhub.mdc
+skillhub.json
+skillhub.lock.json
+```
+
+For `--target claude`:
+
+```txt
+.claude/skills/<skill-name>/
+.claude/skillhub.md
+CLAUDE.md
+skillhub.json
+skillhub.lock.json
+```
+
+For `--target ai`:
 
 ```txt
 .ai/skills/<skill-name>/
 AGENTS.md
-.cursor/rules/skillhub.mdc
 skillhub.json
 skillhub.lock.json
 ```
@@ -162,8 +218,9 @@ skillhub.lock.json
 ## Supported Commands
 
 ```txt
-skillhub init
-skillhub install <skill[@version]>
+skillhub init [--target ai|cursor|claude]
+skillhub target [ai|cursor|claude]
+skillhub install <skill[@version]> [--target ai|cursor|claude]
 skillhub sync
 skillhub list
 skillhub remove <skill>

package/bin/skillhub.mjs

@@ -4,10 +4,29 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import crypto from "node:crypto";
 import process from "node:process";
+import readline from "node:readline/promises";
 
 const CONFIG_FILE = "skillhub.json";
 const LOCK_FILE = "skillhub.lock.json";
-const DEFAULT_SKILLS_DIR = ".ai/skills";
+const DEFAULT_TARGET = "ai";
+const TARGETS = {
+  ai: {
+    label: ".ai/skills",
+    skillsDir: ".ai/skills",
+    adapters: { agentsMd: true, cursorRules: false, claude: false, githubCopilot: false },
+  },
+  cursor: {
+    label: ".cursor/skills",
+    skillsDir: ".cursor/skills",
+    adapters: { agentsMd: false, cursorRules: true, claude: false, githubCopilot: false },
+  },
+  claude: {
+    label: ".claude/skills",
+    skillsDir: ".claude/skills",
+    adapters: { agentsMd: false, cursorRules: false, claude: true, githubCopilot: false },
+  },
+};
+const DEFAULT_SKILLS_DIR = TARGETS[DEFAULT_TARGET].skillsDir;
 const GENERATED_START = "<!-- skillhub:start -->";
 const GENERATED_END = "<!-- skillhub:end -->";
 
@@ -114,6 +133,75 @@ function parseFlags(argv) {
   return { positional, flags };
 }
 
+function normalizeTarget(value) {
+  if (!value) return null;
+
+  const normalized = String(value).trim().toLowerCase().replace(/^\./, "");
+  const aliases = {
+    ai: "ai",
+    cursor: "cursor",
+    cursorrules: "cursor",
+    ".cursor": "cursor",
+    claude: "claude",
+    cloude: "claude",
+    ".claude": "claude",
+    ".cloude": "claude",
+  };
+
+  const target = aliases[normalized] || normalized;
+  if (!TARGETS[target]) {
+    throw new Error(`Invalid target "${value}". Use: ai, cursor, or claude.`);
+  }
+
+  return target;
+}
+
+async function askTarget(defaultTarget = DEFAULT_TARGET) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return defaultTarget;
+  }
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log(paint("bold", "Where should SkillHub install skill files?"));
+    console.log(`  1. ${TARGETS.ai.skillsDir} ${paint("dim", "(generic AI folder + AGENTS.md)")}`);
+    console.log(`  2. ${TARGETS.cursor.skillsDir} ${paint("dim", "(Cursor rules)")}`);
+    console.log(`  3. ${TARGETS.claude.skillsDir} ${paint("dim", "(Claude project instructions)")}`);
+
+    const answer = await rl.question(`Choose target [1/2/3 or ai/cursor/claude] (${defaultTarget}): `);
+    const raw = answer.trim();
+    if (!raw) return defaultTarget;
+    if (raw === "1") return "ai";
+    if (raw === "2") return "cursor";
+    if (raw === "3") return "claude";
+    return normalizeTarget(raw);
+  } finally {
+    rl.close();
+  }
+}
+
+function getConfigTarget(config) {
+  if (config?.target) return normalizeTarget(config.target);
+
+  const skillsDir = config?.skillsDir || DEFAULT_SKILLS_DIR;
+  if (skillsDir.startsWith(".cursor/")) return "cursor";
+  if (skillsDir.startsWith(".claude/") || skillsDir.startsWith(".cloude/")) return "claude";
+  return "ai";
+}
+
+function applyTargetToConfig(config, targetValue, { preserveExistingAdapters = false } = {}) {
+  const target = normalizeTarget(targetValue) || DEFAULT_TARGET;
+  const targetConfig = TARGETS[target];
+
+  config.target = target;
+  config.skillsDir = targetConfig.skillsDir;
+  config.adapters = preserveExistingAdapters
+    ? { ...targetConfig.adapters, ...(config.adapters || {}) }
+    : { ...targetConfig.adapters, ...(target === "ai" ? { agentsMd: true } : {}) };
+
+  return config;
+}
+
 function parseSkillSpec(spec) {
   if (!spec || spec.trim().length === 0) {
     throw new Error("Skill name is required.");
@@ -188,20 +276,18 @@ function checksumFiles(files) {
   return `sha256-${hash.digest("hex")}`;
 }
 
-function defaultConfig(projectRoot) {
-  return {
+function defaultConfig(projectRoot, target = DEFAULT_TARGET) {
+  const config = {
     $schema: "https://skillhub.local/schema/skillhub.schema.json",
     project: path.basename(projectRoot),
     registry: "./skillhub-registry",
+    target: DEFAULT_TARGET,
     skillsDir: DEFAULT_SKILLS_DIR,
     skills: {},
-    adapters: {
-      agentsMd: true,
-      cursorRules: true,
-      claude: false,
-      githubCopilot: false,
-    },
+    adapters: {},
   };
+
+  return applyTargetToConfig(config, target);
 }
 
 function defaultLock() {
@@ -218,6 +304,10 @@ async function readProjectConfig(projectRoot) {
   if (!config) {
     throw new Error(`No ${CONFIG_FILE} found. Run: skillhub init`);
   }
+
+  config.target = getConfigTarget(config);
+  config.skillsDir = config.skillsDir || TARGETS[config.target].skillsDir;
+  config.adapters = config.adapters || TARGETS[config.target].adapters;
   return config;
 }
 
@@ -403,8 +493,9 @@ async function updateCursorRules(projectRoot, skillsDir, installed) {
 }
 
 async function updateClaudeMd(projectRoot, skillsDir, installed) {
-  const body = `# SkillHub Instructions\n\nFollow the installed skills below:\n\n${generatedSkillList(skillsDir, installed)}`;
+  const body = `# SkillHub Instructions\n\nFollow the installed skills below before generating or changing code:\n\n${generatedSkillList(skillsDir, installed)}`;
   await replaceGeneratedBlock(path.join(projectRoot, "CLAUDE.md"), body, "# Claude Project Instructions\n");
+  await replaceGeneratedBlock(path.join(projectRoot, ".claude/skillhub.md"), body, "# Claude SkillHub Instructions\n");
 }
 
 async function updateCopilotInstructions(projectRoot, skillsDir, installed) {
@@ -415,11 +506,34 @@ async function updateCopilotInstructions(projectRoot, skillsDir, installed) {
 async function commandInit(projectRoot, flags) {
   const configPath = path.join(projectRoot, CONFIG_FILE);
   const lockPath = path.join(projectRoot, LOCK_FILE);
+  const requestedTarget = normalizeTarget(flags.target || flags.to);
+  let config;
 
   if (await exists(configPath)) {
+    config = await readProjectConfig(projectRoot);
     warn(`${CONFIG_FILE} already exists.`);
+
+    if (requestedTarget) {
+      const previousTarget = getConfigTarget(config);
+      applyTargetToConfig(config, requestedTarget);
+      if (flags.registry) config.registry = flags.registry;
+      await writeJson(configPath, config);
+      if (previousTarget === requestedTarget) {
+        ok(`${CONFIG_FILE} already uses target ${requestedTarget}`);
+      } else {
+        ok(`Updated ${CONFIG_FILE} target: ${previousTarget} → ${requestedTarget}`);
+      }
+    } else if (flags.registry) {
+      config.registry = flags.registry;
+      await writeJson(configPath, config);
+      ok(`Updated ${CONFIG_FILE} registry`);
+    } else {
+      info(`Current target: ${getConfigTarget(config)}`);
+      info(`To change target: skillhub init --target cursor`);
+    }
   } else {
-    const config = defaultConfig(projectRoot);
+    const target = requestedTarget || (flags.yes ? DEFAULT_TARGET : await askTarget(DEFAULT_TARGET));
+    config = defaultConfig(projectRoot, target);
     if (flags.registry) config.registry = flags.registry;
     await writeJson(configPath, config);
     ok(`Created ${CONFIG_FILE}`);
@@ -432,9 +546,10 @@ async function commandInit(projectRoot, flags) {
     ok(`Created ${LOCK_FILE}`);
   }
 
-  await ensureDir(path.join(projectRoot, DEFAULT_SKILLS_DIR));
-  ok(`Created ${DEFAULT_SKILLS_DIR}`);
+  await ensureDir(path.join(projectRoot, config.skillsDir));
+  ok(`Created ${config.skillsDir}`);
 
+  info(`Target: ${config.target}`);
   info("Next: skillhub install nextjs-clean-architecture");
 }
 
@@ -442,6 +557,9 @@ async function commandInstall(projectRoot, spec, flags = {}) {
   const configPath = path.join(projectRoot, CONFIG_FILE);
   const lockPath = path.join(projectRoot, LOCK_FILE);
   const config = await readProjectConfig(projectRoot);
+  if (flags.target || flags.to) {
+    applyTargetToConfig(config, flags.target || flags.to);
+  }
   const lock = (await readJson(lockPath, null)) || defaultLock();
   const registry = resolveRegistry(projectRoot, config, flags);
   const { name, version } = parseSkillSpec(spec);
@@ -476,7 +594,12 @@ async function commandInstall(projectRoot, spec, flags = {}) {
 }
 
 async function commandSync(projectRoot, flags = {}) {
+  const configPath = path.join(projectRoot, CONFIG_FILE);
   const config = await readProjectConfig(projectRoot);
+  if (flags.target || flags.to) {
+    applyTargetToConfig(config, flags.target || flags.to);
+    await writeJson(configPath, config);
+  }
   const skills = Object.entries(config.skills || {});
 
   if (skills.length === 0) {
@@ -513,12 +636,13 @@ async function commandRemove(projectRoot, skillName) {
   const config = await readProjectConfig(projectRoot);
   const lock = (await readJson(lockPath, null)) || defaultLock();
   const skillsDir = config.skillsDir || DEFAULT_SKILLS_DIR;
+  const installedPath = lock.skills?.[skillName]?.installTo || `${skillsDir}/${skillName}`;
 
   delete config.skills?.[skillName];
   delete lock.skills?.[skillName];
   lock.updatedAt = now();
 
-  await fs.rm(path.join(projectRoot, skillsDir, skillName), { recursive: true, force: true });
+  await fs.rm(path.join(projectRoot, installedPath), { recursive: true, force: true });
   await writeJson(configPath, config);
   await writeJson(lockPath, lock);
   await updateAdapters(projectRoot, config, lock);
@@ -526,6 +650,26 @@ async function commandRemove(projectRoot, skillName) {
   ok(`Removed ${skillName}`);
 }
 
+async function commandTarget(projectRoot, targetValue, flags = {}) {
+  const configPath = path.join(projectRoot, CONFIG_FILE);
+  const lockPath = path.join(projectRoot, LOCK_FILE);
+  const config = await readProjectConfig(projectRoot);
+  const target = normalizeTarget(targetValue || flags.target || flags.to) || await askTarget(getConfigTarget(config));
+
+  applyTargetToConfig(config, target);
+  await writeJson(configPath, config);
+  await ensureDir(path.join(projectRoot, config.skillsDir));
+
+  const lock = (await readJson(lockPath, null)) || defaultLock();
+  await updateAdapters(projectRoot, config, lock);
+
+  ok(`SkillHub target set to ${target}`);
+  info(`Skill files will be installed to ${config.skillsDir}`);
+  if (Object.keys(lock.skills || {}).length > 0) {
+    info("Run: skillhub sync");
+  }
+}
+
 async function commandCreate(projectRoot, name, flags = {}) {
   if (!name) throw new Error("Skill name is required.");
 
@@ -684,7 +828,7 @@ async function commandGenerate(projectRoot, skillName, templateName, resourceNam
 }
 
 function printHelp() {
-  console.log(`\n${paint("bold", "SkillHub CLI")}\n\nInstall reusable AI/project skills into any codebase.\n\n${paint("bold", "Usage")}\n  skillhub <command> [options]\n\n${paint("bold", "Commands")}\n  init                         Create skillhub.json, lockfile, and .ai/skills\n  install <skill[@version]>    Install a skill from the registry\n  sync                         Reinstall all skills from skillhub.json\n  list                         Show installed skills\n  remove <skill>               Remove an installed skill\n  create <skill>               Scaffold a new local skill package\n  validate <skill|path>        Validate skill.json and SKILL.md\n\n${paint("bold", "Options")}\n  --registry <path|url>         Registry location. Default: ./skillhub-registry\n  --version <version>           Version used by create. Default: 1.0.0\n  --category <name>             Category used by create. Default: general\n\n${paint("bold", "Examples")}\n  skillhub init\n  skillhub install nextjs-clean-architecture\n  skillhub install shadcn-crud-generator@1.0.0\n  skillhub sync\n  skillhub create api-security-rules --category security\n`);
+  console.log(`\n${paint("bold", "SkillHub CLI")}\n\nInstall reusable AI/project skills into any codebase.\n\n${paint("bold", "Usage")}\n  skillhub <command> [options]\n\n${paint("bold", "Commands")}\n  init                         Create skillhub.json, lockfile, and chosen skills folder\n  target [ai|cursor|claude]    Change where skills are installed\n  install <skill[@version]>    Install a skill from the registry\n  sync                         Reinstall all skills from skillhub.json\n  list                         Show installed skills\n  remove <skill>               Remove an installed skill\n  create <skill>               Scaffold a new local skill package\n  validate <skill|path>        Validate skill.json and SKILL.md\n  generate <skill> <template> <name>  Generate files from a skill template\n\n${paint("bold", "Targets")}\n  ai                            Install to .ai/skills and update AGENTS.md\n  cursor                        Install to .cursor/skills and update .cursor/rules/skillhub.mdc\n  claude                        Install to .claude/skills and update CLAUDE.md + .claude/skillhub.md\n\n${paint("bold", "Options")}\n  --target <ai|cursor|claude>   Install target. Alias: --to\n  --registry <path|url>         Registry location. Default: ./skillhub-registry\n  --version <version>           Version used by create. Default: 1.0.0\n  --category <name>             Category used by create. Default: general\n  --yes                         Use default init target without prompting\n\n${paint("bold", "Examples")}\n  skillhub init --target cursor\n  skillhub init --target claude\n  skillhub install nextjs-clean-architecture --target cursor\n  skillhub target claude\n  skillhub sync\n  skillhub create api-security-rules --category security\n`);
 }
 
 async function main() {
@@ -705,6 +849,10 @@ async function main() {
     case "add":
       await commandInstall(projectRoot, positional[0], flags);
       break;
+    case "target":
+    case "configure":
+      await commandTarget(projectRoot, positional[0], flags);
+      break;
     case "sync":
       await commandSync(projectRoot, flags);
       break;
@@ -742,6 +890,8 @@ export {
   sortVersions,
   validateSkillManifest,
   defaultConfig,
+  normalizeTarget,
+  applyTargetToConfig,
 };
 
 // Let people run this file through `node packages/skillhub-cli/bin/skillhub.mjs`.

package/docs/skillhub-cli-logic.md

@@ -143,3 +143,26 @@ The enabled adapters are controlled in `skillhub.json`:
   }
 }
 ```
+
+
+## Target folders
+
+SkillHub can install skill packages into different AI-tool folders instead of only `.ai/skills`.
+
+```bash
+skillhub init --target cursor
+skillhub init --target claude
+skillhub install nextjs-clean-architecture --target cursor
+skillhub target claude
+skillhub sync
+```
+
+Supported targets:
+
+```txt
+ai      -> .ai/skills + AGENTS.md
+cursor  -> .cursor/skills + .cursor/rules/skillhub.mdc
+claude  -> .claude/skills + CLAUDE.md + .claude/skillhub.md
+```
+
+The CLI also accepts `cloude` as an alias for `claude` to avoid failing on the common typo. Because apparently kindness can be implemented in 4 lines of code.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robosoft/skillhub-cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Standalone SkillHub CLI for installing reusable AI/project skills into any codebase.",
   "type": "module",
   "bin": {