@emmraan/ai-skills 0.0.3 → 1.0.0

package/dist/core/lockfile.js.map

@@ -1 +1 @@
-{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../src/core/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C,MAAM,gBAAgB,GAAa;IACjC,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAkB;IACpD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAAe,EACf,IAAY,EACZ,YAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG;QACpC,IAAI,EAAE,SAAS;QACf,OAAO;QACP,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY;KACb,CAAC;IACF,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,SAAiB;IAC7D,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AACrD,CAAC"}
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../../src/core/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAe9C,MAAM,gBAAgB,GAAa;IACjC,OAAO,EAAE,CAAC;IACV,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAkB;IACpD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,OAAe,EACf,IAAY,EACZ,YAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,GAAG;QACpC,IAAI,EAAE,SAAS;QACf,OAAO;QACP,IAAI;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,YAAY;KACb,CAAC;IACF,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,SAAiB;IAC7D,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,SAAiB,EACjB,YAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;IACT,CAAC;IAED,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC;AACrD,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA6C1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAqD1C"}

package/dist/index.js

@@ -1,11 +1,13 @@
-import { install } from './commands/install.js';
-import { remove } from './commands/remove.js';
+import { install, parseInstallFlags, resolveInstallOptionsFromFlags } from './commands/install.js';
+import { remove, parseRemoveFlags, resolveRemoveOptionsFromFlags } from './commands/remove.js';
 import { list } from './commands/list.js';
 import { update } from './commands/update.js';
 import { generateLocal } from './commands/generate-local.js';
 import { error, info } from './utils/logger.js';
+import { ui } from './utils/ui.js';
 const args = process.argv.slice(2);
 export async function main() {
+    ui.printBanner();
     if (args.length === 0) {
         showHelp();
         return;
@@ -14,12 +16,16 @@ export async function main() {
     try {
         if (command === 'install' && args.length >= 2) {
             const skill = args[1];
-            const success = await install(skill);
+            const flags = parseInstallFlags(args.slice(2));
+            const options = await resolveInstallOptionsFromFlags(flags, true);
+            const success = await install(skill, options);
             process.exit(success ? 0 : 1);
         }
         else if (command === 'remove' && args.length >= 2) {
             const skill = args[1];
-            const success = await remove(skill);
+            const flags = parseRemoveFlags(args.slice(2));
+            const options = await resolveRemoveOptionsFromFlags(flags, true);
+            const success = await remove(skill, options);
             process.exit(success ? 0 : 1);
         }
         else if (command === 'list') {
@@ -44,7 +50,9 @@ export async function main() {
         }
         else if (!command.startsWith('-')) {
             // Default behavior: treat first arg as skill name to install
-            const success = await install(command);
+            const flags = parseInstallFlags(args.slice(1));
+            const options = await resolveInstallOptionsFromFlags(flags, true);
+            const success = await install(command, options);
             process.exit(success ? 0 : 1);
         }
         else {
@@ -61,16 +69,30 @@ function showHelp() {
 AI Skills CLI - Install framework-agnostic SKILLS.md files
 
 Usage:
-  ai-skills <skill>              Install a skill
-  ai-skills install <skill>      Install a skill
+  ai-skills <skill> [options]              Install a skill
+  ai-skills install <skill> [options]      Install a skill
   ai-skills list [--json]        List installed and available skills
-  ai-skills remove <skill>       Remove an installed skill
+  ai-skills remove <skill> [options]   Remove an installed skill
   ai-skills update [--force]     Update all installed skills
                   [--skill <name>]   Update a specific skill
   ai-skills generate-local [skill]    Run local backend generator
 
+Install options:
+  --local                         Install in current project (.ai-skills/skills)
+  --global                        Install in home agent folders
+  --all                           Install to all global platforms
+  --platform <a,b,c>              Install to selected global platforms
+
+Remove options:
+  --local                         Remove from current project platforms
+  --global                        Remove from home agent platforms
+  --all                           Remove from all platforms for selected scope
+  --platform <a,b,c>              Remove from selected platforms for selected scope
+
 Examples:
   ai-skills react
+  ai-skills react --local
+  ai-skills react --platform claude,gemini,opencode,vscode,codex,agents
   ai-skills install typescript
   ai-skills list
   ai-skills remove python

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,QAElC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,QAEnC;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,QAEtC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,QAEpC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,QAEnC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,QAElC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,QAEnC;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,QAEtC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,QAEpC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,QAEnC"}

package/dist/utils/logger.js

@@ -1,17 +1,18 @@
 /* eslint-disable no-console */
+import chalk from 'chalk';
 export function log(message) {
     console.log(message);
 }
 export function info(message) {
-    console.log(`ℹ ${message}`);
+    console.log(`${chalk.cyan('ℹ')} ${chalk.gray(message)}`);
 }
 export function success(message) {
-    console.log(`✓ ${message}`);
+    console.log(`${chalk.green('✓')} ${chalk.green(message)}`);
 }
 export function error(message) {
-    console.error(`✗ ${message}`);
+    console.error(`${chalk.red('✗')} ${chalk.red(message)}`);
 }
 export function warn(message) {
-    console.warn(`⚠ ${message}`);
+    console.warn(`${chalk.yellow('⚠')} ${chalk.yellow(message)}`);
 }
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,UAAU,GAAG,CAAC,OAAe;IACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,GAAG,CAAC,OAAe;IACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/ui.d.ts

@@ -0,0 +1,9 @@
+export declare const ui: {
+    bannerShown: boolean;
+    printBanner(): void;
+    startSpinner(text: string): void;
+    stopSpinnerSuccess(text?: string): void;
+    stopSpinnerFail(text?: string): void;
+    stopSpinner(): void;
+};
+//# sourceMappingURL=ui.d.ts.map

package/dist/utils/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,EAAE;;mBAGE,IAAI;uBAYA,MAAM,GAAG,IAAI;8BAWN,MAAM,GAAG,IAAI;2BAQhB,MAAM,GAAG,IAAI;mBAQrB,IAAI;CAOpB,CAAC"}

package/dist/utils/ui.js

@@ -0,0 +1,48 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { info } from '../utils/logger.js';
+let activeSpinner = null;
+export const ui = {
+    bannerShown: false,
+    printBanner() {
+        if (this.bannerShown || !process.stdout.isTTY) {
+            return;
+        }
+        const title = chalk.bold.cyan('AI Skills CLI');
+        const subtitle = chalk.gray('Install framework-agnostic SKILLS.md files');
+        // Subtle, single-line banner to keep npx output concise
+        info(`${title} ${chalk.gray('•')} ${subtitle}`);
+        this.bannerShown = true;
+    },
+    startSpinner(text) {
+        if (!process.stdout.isTTY) {
+            return;
+        }
+        if (activeSpinner) {
+            activeSpinner.stop();
+        }
+        activeSpinner = ora({ text, spinner: 'dots' }).start();
+    },
+    stopSpinnerSuccess(text) {
+        if (!activeSpinner) {
+            return;
+        }
+        activeSpinner.succeed(text);
+        activeSpinner = null;
+    },
+    stopSpinnerFail(text) {
+        if (!activeSpinner) {
+            return;
+        }
+        activeSpinner.fail(text);
+        activeSpinner = null;
+    },
+    stopSpinner() {
+        if (!activeSpinner) {
+            return;
+        }
+        activeSpinner.stop();
+        activeSpinner = null;
+    },
+};
+//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAiB,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,IAAI,aAAa,GAAe,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,WAAW,EAAE,KAAK;IAElB,WAAW;QACT,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;QAC1E,wDAAwD;QACxD,IAAI,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QACD,aAAa,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;IAED,kBAAkB,CAAC,IAAa;QAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,eAAe,CAAC,IAAa;QAC3B,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,WAAW;QACT,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,aAAa,CAAC,IAAI,EAAE,CAAC;QACrB,aAAa,GAAG,IAAI,CAAC;IACvB,CAAC;CACF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emmraan/ai-skills",
-  "version": "0.0.3",
+  "version": "1.0.0",
   "description": "CLI tool for installing AI Skills across agent platforms",
   "type": "module",
   "bin": {
@@ -23,6 +23,11 @@
     "typecheck": "tsc --noEmit --project tsconfig.json",
     "clean": "rm -rf dist"
   },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "inquirer": "^12.9.6",
+    "ora": "^8.2.0"
+  },
   "devDependencies": {
     "@ai-skills/shared-types": "workspace:*",
     "@types/node": "^20.10.0",

package/src/commands/install.ts

@@ -1,30 +1,174 @@
 import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
 import { installSkill } from '../core/installer.js';
 import { addSkillToLockfile } from '../core/lockfile.js';
+import { AGENT_PLATFORMS, type InstallOptions, type InstallLocation } from '../core/config.js';
 import { sha256 } from '../utils/hash.js';
-import { error, success, info } from '../utils/logger.js';
+import { error, success } from '../utils/logger.js';
+import inquirer from 'inquirer';
+import { ui } from '../utils/ui.js';
 
-export async function install(skillName: string): Promise<boolean> {
+export interface CliInstallFlags {
+  local?: boolean;
+  global?: boolean;
+  all?: boolean;
+  platforms?: string[];
+}
+
+export function parseInstallFlags(args: string[]): CliInstallFlags {
+  const flags: CliInstallFlags = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--local') {
+      flags.local = true;
+    } else if (arg === '--global') {
+      flags.global = true;
+    } else if (arg === '--all') {
+      flags.all = true;
+    } else if (arg === '--platform') {
+      const value = args[i + 1];
+      if (!value || value.startsWith('--')) {
+        throw new Error('Missing value for --platform. Example: --platform claude,gemini');
+      }
+      i++;
+      const parsed = value
+        .split(',')
+        .map((p) => p.trim())
+        .filter(Boolean);
+      flags.platforms = [...(flags.platforms ?? []), ...parsed];
+    }
+  }
+
+  return flags;
+}
+
+export async function resolveInstallOptionsFromFlags(
+  flags: CliInstallFlags,
+  interactive: boolean
+): Promise<InstallOptions> {
+  if (flags.local && flags.global) {
+    throw new Error('Use only one of --local or --global');
+  }
+
+  const hasAnyFlag = Boolean(
+    flags.local || flags.global || flags.all || (flags.platforms ?? []).length
+  );
+
+  if (flags.local) {
+    return {
+      location: 'local',
+      all: flags.all || !flags.platforms || flags.platforms.length === 0,
+      platforms: flags.platforms,
+    };
+  }
+
+  if (flags.global) {
+    return {
+      location: 'global',
+      all: flags.all || !flags.platforms || flags.platforms.length === 0,
+      platforms: flags.platforms,
+    };
+  }
+
+  if ((flags.platforms ?? []).length > 0 || flags.all) {
+    return {
+      location: 'global',
+      all: flags.all,
+      platforms: flags.platforms,
+    };
+  }
+
+  if (!hasAnyFlag) {
+    if (interactive && process.stdin.isTTY && process.stdout.isTTY) {
+      return promptInstallOptions();
+    }
+    return { location: 'global', all: true };
+  }
+
+  return { location: 'global', all: true };
+}
+
+async function promptInstallOptions(): Promise<InstallOptions> {
+  const { location } = await inquirer.prompt<{ location: InstallLocation }>([
+    {
+      type: 'list',
+      name: 'location',
+      message: 'Install location',
+      choices: [
+        { name: 'Local (current project)', value: 'local' },
+        { name: 'Global (agent platforms)', value: 'global' },
+      ],
+      default: 'global',
+    },
+  ]);
+
+  const { target } = await inquirer.prompt<{ target: 'all' | 'specific' }>([
+    {
+      type: 'list',
+      name: 'target',
+      message: `${location === 'local' ? 'Local' : 'Global'} install target`,
+      choices: [
+        { name: 'All platforms', value: 'all' },
+        { name: 'Specific platforms', value: 'specific' },
+      ],
+      default: 'all',
+    },
+  ]);
+
+  if (target === 'all') {
+    return { location, all: true };
+  }
+
+  const platformChoices = AGENT_PLATFORMS.map((platform) => {
+    const value = platform.replace(/^\./, '');
+    return { name: value, value };
+  });
+
+  const { platforms } = await inquirer.prompt<{ platforms: string[] }>([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Select target platforms',
+      choices: platformChoices,
+      pageSize: 10,
+      validate: (value: string[]) =>
+        value.length > 0 ? true : 'Please select at least one platform.',
+    },
+  ]);
+
+  return {
+    location,
+    all: false,
+    platforms,
+  };
+}
+
+export async function install(skillName: string, options: InstallOptions = {}): Promise<boolean> {
   try {
-    info(`Fetching ${skillName}...`);
+    ui.startSpinner(`Fetching ${skillName}...`);
     const skillContent = await fetchSkill(skillName);
+    ui.stopSpinnerSuccess(`Fetched ${skillName}`);
     const hash = sha256(skillContent);
 
-    info(`Installing ${skillName}...`);
-    const installPaths = await installSkill(skillName, skillContent);
+    ui.startSpinner(`Installing ${skillName}...`);
+    const installPaths = await installSkill(skillName, skillContent, options);
+    ui.stopSpinnerSuccess(`Installed files for ${skillName}`);
 
     if (installPaths.length === 0) {
       error(`Failed to install ${skillName} to any location`);
       return false;
     }
 
+    ui.startSpinner(`Updating lockfile for ${skillName}...`);
     const index = await fetchRegistryIndex();
     const skillVersion = index.skills[skillName]?.version || 'unknown';
 
     await addSkillToLockfile(skillName, skillVersion, hash, installPaths);
+    ui.stopSpinnerSuccess(`Updated lockfile for ${skillName}`);
     success(`Installed ${skillName} (${skillVersion}) to ${installPaths.length} location(s)`);
     return true;
   } catch (err) {
+    ui.stopSpinner();
     error(`Failed to install ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
     return false;
   }

package/src/commands/remove.ts

@@ -1,8 +1,149 @@
 import { removeSkill } from '../core/installer.js';
-import { removeSkillFromLockfile, getSkillEntry } from '../core/lockfile.js';
+import {
+  removeSkillFromLockfile,
+  getSkillEntry,
+  updateSkillInstallPathsInLockfile,
+} from '../core/lockfile.js';
+import { AGENT_PLATFORMS, type InstallLocation, type InstallOptions } from '../core/config.js';
 import { error, success, info } from '../utils/logger.js';
+import { ui } from '../utils/ui.js';
+import inquirer from 'inquirer';
 
-export async function remove(skillName: string): Promise<boolean> {
+export interface CliRemoveFlags {
+  local?: boolean;
+  global?: boolean;
+  all?: boolean;
+  platforms?: string[];
+}
+
+export function parseRemoveFlags(args: string[]): CliRemoveFlags {
+  const flags: CliRemoveFlags = {};
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--local') {
+      flags.local = true;
+    } else if (arg === '--global') {
+      flags.global = true;
+    } else if (arg === '--all') {
+      flags.all = true;
+    } else if (arg === '--platform') {
+      const value = args[i + 1];
+      if (!value || value.startsWith('--')) {
+        throw new Error('Missing value for --platform. Example: --platform claude,gemini');
+      }
+      i++;
+      const parsed = value
+        .split(',')
+        .map((p) => p.trim())
+        .filter(Boolean);
+      flags.platforms = [...(flags.platforms ?? []), ...parsed];
+    }
+  }
+
+  return flags;
+}
+
+export async function resolveRemoveOptionsFromFlags(
+  flags: CliRemoveFlags,
+  interactive: boolean
+): Promise<InstallOptions> {
+  if (flags.local && flags.global) {
+    throw new Error('Use only one of --local or --global');
+  }
+
+  const hasAnyFlag = Boolean(
+    flags.local || flags.global || flags.all || (flags.platforms ?? []).length
+  );
+
+  if (flags.local) {
+    return {
+      location: 'local',
+      all: flags.all || !flags.platforms || flags.platforms.length === 0,
+      platforms: flags.platforms,
+    };
+  }
+
+  if (flags.global) {
+    return {
+      location: 'global',
+      all: flags.all || !flags.platforms || flags.platforms.length === 0,
+      platforms: flags.platforms,
+    };
+  }
+
+  if ((flags.platforms ?? []).length > 0 || flags.all) {
+    return {
+      location: 'global',
+      all: flags.all,
+      platforms: flags.platforms,
+    };
+  }
+
+  if (!hasAnyFlag) {
+    if (interactive && process.stdin.isTTY && process.stdout.isTTY) {
+      return promptRemoveOptions();
+    }
+    return { location: 'global', all: true };
+  }
+
+  return { location: 'global', all: true };
+}
+
+async function promptRemoveOptions(): Promise<InstallOptions> {
+  const { location } = await inquirer.prompt<{ location: InstallLocation }>([
+    {
+      type: 'list',
+      name: 'location',
+      message: 'Remove from location',
+      choices: [
+        { name: 'Local (current project)', value: 'local' },
+        { name: 'Global (agent platforms)', value: 'global' },
+      ],
+      default: 'global',
+    },
+  ]);
+
+  const { target } = await inquirer.prompt<{ target: 'all' | 'specific' }>([
+    {
+      type: 'list',
+      name: 'target',
+      message: `${location === 'local' ? 'Local' : 'Global'} remove target`,
+      choices: [
+        { name: 'All platforms', value: 'all' },
+        { name: 'Specific platforms', value: 'specific' },
+      ],
+      default: 'all',
+    },
+  ]);
+
+  if (target === 'all') {
+    return { location, all: true };
+  }
+
+  const platformChoices = AGENT_PLATFORMS.map((platform) => {
+    const value = platform.replace(/^\./, '');
+    return { name: value, value };
+  });
+
+  const { platforms } = await inquirer.prompt<{ platforms: string[] }>([
+    {
+      type: 'checkbox',
+      name: 'platforms',
+      message: 'Select target platforms',
+      choices: platformChoices,
+      pageSize: 10,
+    },
+  ]);
+
+  return {
+    location,
+    all: platforms.length === 0,
+    platforms,
+  };
+}
+
+export async function remove(skillName: string, options: InstallOptions = {}): Promise<boolean> {
   try {
     const entry = await getSkillEntry(skillName);
     if (!entry) {
@@ -10,12 +151,21 @@ export async function remove(skillName: string): Promise<boolean> {
       return true;
     }
 
-    info(`Removing ${skillName}...`);
-    await removeSkill(skillName);
-    await removeSkillFromLockfile(skillName);
-    success(`Removed ${skillName}`);
+    ui.startSpinner(`Removing ${skillName}...`);
+    const removedPaths = await removeSkill(skillName, options);
+
+    const remaining = entry.installPaths.filter((p) => !removedPaths.includes(p));
+    if (remaining.length === 0) {
+      await removeSkillFromLockfile(skillName);
+    } else {
+      await updateSkillInstallPathsInLockfile(skillName, remaining);
+    }
+
+    ui.stopSpinnerSuccess(`Removed files for ${skillName}`);
+    success(`Removed ${skillName} from ${removedPaths.length} location(s)`);
     return true;
   } catch (err) {
+    ui.stopSpinner();
     error(`Failed to remove ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
     return false;
   }

package/src/core/config.ts

@@ -8,22 +8,68 @@ export const REGISTRY_INDEX_URL = `${REGISTRY_URL}/skills/.index.json`;
 
 export const AGENT_PLATFORMS = ['.claude', '.gemini', '.vscode', '.opencode', '.codex', '.agents'];
 
+export type InstallLocation = 'local' | 'global';
+
+export interface InstallOptions {
+  location?: InstallLocation;
+  platforms?: string[];
+  all?: boolean;
+}
+
+export interface ResolvedInstallOptions {
+  location: InstallLocation;
+  platforms: string[];
+}
+
 export function getAgentPlatformDirs(): string[] {
   const home = homedir();
   return AGENT_PLATFORMS.map((p) => join(home, p, 'skills'));
 }
 
+export function resolveInstallOptions(options: InstallOptions = {}): ResolvedInstallOptions {
+  const location: InstallLocation = options.location ?? 'global';
+
+  const normalized = (options.platforms ?? []).map((p) => normalizePlatformName(p));
+  const unique = [...new Set(normalized)];
+
+  if (options.all || unique.length === 0) {
+    return { location, platforms: [...AGENT_PLATFORMS] };
+  }
+
+  for (const p of unique) {
+    if (!AGENT_PLATFORMS.includes(p)) {
+      throw new Error(`Unknown platform: ${p}. Supported: ${AGENT_PLATFORMS.join(', ')}`);
+    }
+  }
+
+  return { location, platforms: unique };
+}
+
+function normalizePlatformName(name: string): string {
+  const trimmed = name.trim();
+  return trimmed.startsWith('.') ? trimmed : `.${trimmed}`;
+}
+
+function getSelectedPlatformDirs(resolved: ResolvedInstallOptions): string[] {
+  const baseDir = resolved.location === 'local' ? process.cwd() : homedir();
+  return resolved.platforms.map((p) => join(baseDir, p, 'skills'));
+}
+
 export function getLockfilePath(): string {
   const home = homedir();
   return join(home, '.ai-skills', '.skill-lock.json');
 }
 
-export function getSkillInstallPaths(skillName: string): string[] {
-  return getAgentPlatformDirs().map((dir) => join(dir, skillName, 'SKILLS.md'));
+export function getSkillInstallPaths(skillName: string, options: InstallOptions = {}): string[] {
+  const resolved = resolveInstallOptions(options);
+  return getSelectedPlatformDirs(resolved).map((dir) => join(dir, skillName, 'SKILLS.md'));
 }
 
-export function getSkillMetadataPaths(skillName: string): string[] {
-  return getAgentPlatformDirs().map((dir) => join(dir, skillName, '.skill-metadata.json'));
+export function getSkillMetadataPaths(skillName: string, options: InstallOptions = {}): string[] {
+  const resolved = resolveInstallOptions(options);
+  return getSelectedPlatformDirs(resolved).map((dir) =>
+    join(dir, skillName, '.skill-metadata.json')
+  );
 }
 
 export const IS_WINDOWS = platform() === 'win32';