@emmraan/ai-skills 0.0.2 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 md εmrαη
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -6,11 +6,31 @@ Install framework-agnostic `SKILLS.md` files for AI agents.
 
 - `npx @emmraan/ai-skills react` - Install React skill
 - `npx @emmraan/ai-skills install react` - Install React skill (explicit command)
+- `npx @emmraan/ai-skills react --local` - Install to local project (`process.cwd()`)
+- `npx @emmraan/ai-skills react --platform claude,gemini` - Install globally to selected platforms
+- `npx @emmraan/ai-skills react --local --platform claude,gemini` - Install locally to selected platforms
+- `npx @emmraan/ai-skills react --global --all` - Install globally to all platforms
 - `npx @emmraan/ai-skills list` - List available and installed skills
 - `npx @emmraan/ai-skills update` - Update all installed skills
 - `npx @emmraan/ai-skills remove react` - Remove React skill
 - `npx @emmraan/ai-skills generate-local` - Run local backend generator
 
+## Interactive install flow
+
+When you run `npx @emmraan/ai-skills <skill>` without install flags, the CLI prompts for:
+
+1. Install location: Local (current project) or Global (agent platforms)
+2. If Global: All platforms or specific platforms
+
+Supported non-interactive install flags:
+
+- `--local`
+- `--global`
+- `--platform <name[,name]>`
+- `--all`
+
+Default behavior remains global + all platforms.
+
 ## Publish to npm
 
 This package is the publishable CLI package for the `ai-skills` command.

package/dist/commands/install.d.ts

@@ -1,2 +1,11 @@
-export declare function install(skillName: string): Promise<boolean>;
+import { type InstallOptions } from '../core/config.js';
+export interface CliInstallFlags {
+    local?: boolean;
+    global?: boolean;
+    all?: boolean;
+    platforms?: string[];
+}
+export declare function parseInstallFlags(args: string[]): CliInstallFlags;
+export declare function resolveInstallOptionsFromFlags(flags: CliInstallFlags, interactive: boolean): Promise<InstallOptions>;
+export declare function install(skillName: string, options?: InstallOptions): Promise<boolean>;
 //# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAMA,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBjE"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAM/F,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA0BjE;AAED,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,cAAc,CAAC,CAyCzB;AA4CD,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB/F"}

package/dist/commands/install.js

@@ -1,15 +1,107 @@
 import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
 import { installSkill } from '../core/installer.js';
 import { addSkillToLockfile } from '../core/lockfile.js';
+import { AGENT_PLATFORMS } from '../core/config.js';
 import { sha256 } from '../utils/hash.js';
 import { error, success, info } from '../utils/logger.js';
-export async function install(skillName) {
+import { createInterface } from 'readline/promises';
+import { stdin as input, stdout as output } from 'process';
+export function parseInstallFlags(args) {
+    const flags = {};
+    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, interactive) {
+    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 && input.isTTY && output.isTTY) {
+            return promptInstallOptions();
+        }
+        return { location: 'global', all: true };
+    }
+    return { location: 'global', all: true };
+}
+async function promptInstallOptions() {
+    const rl = createInterface({ input, output });
+    try {
+        const locationAnswer = (await rl.question('Install location? [1] Local (current project) [2] Global (agent platforms) (default: 2): ')).trim();
+        const location = locationAnswer === '1' ? 'local' : 'global';
+        if (location === 'local') {
+            return { location: 'local' };
+        }
+        const platformAnswer = (await rl.question('Global install target? [1] All platforms [2] Specific platforms (default: 1): ')).trim();
+        if (platformAnswer !== '2') {
+            return { location: 'global', all: true };
+        }
+        info(`Available platforms: ${AGENT_PLATFORMS.map((p) => p.replace(/^\./, '')).join(', ')}`);
+        const selected = (await rl.question('Enter comma-separated platform names (example: claude,gemini,vscode): '))
+            .split(',')
+            .map((p) => p.trim())
+            .filter(Boolean);
+        return {
+            location: 'global',
+            all: selected.length === 0,
+            platforms: selected,
+        };
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function install(skillName, options = {}) {
     try {
         info(`Fetching ${skillName}...`);
         const skillContent = await fetchSkill(skillName);
         const hash = sha256(skillContent);
         info(`Installing ${skillName}...`);
-        const installPaths = await installSkill(skillName, skillContent);
+        const installPaths = await installSkill(skillName, skillContent, options);
         if (installPaths.length === 0) {
             error(`Failed to install ${skillName} to any location`);
             return false;

package/dist/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,SAAiB;IAC7C,IAAI,CAAC;QACH,IAAI,CAAC,YAAY,SAAS,KAAK,CAAC,CAAC;QACjC,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QAElC,IAAI,CAAC,cAAc,SAAS,KAAK,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEjE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,qBAAqB,SAAS,kBAAkB,CAAC,CAAC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,kBAAkB,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,IAAI,SAAS,CAAC;QAEnE,MAAM,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;QACtE,OAAO,CAAC,aAAa,SAAS,KAAK,YAAY,QAAQ,YAAY,CAAC,MAAM,cAAc,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,qBAAqB,SAAS,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/core/config.d.ts

@@ -1,9 +1,20 @@
 export declare const REGISTRY_URL = "https://raw.githubusercontent.com/Emmraan/ai-skills/main/packages/skills-registry";
 export declare const REGISTRY_INDEX_URL = "https://raw.githubusercontent.com/Emmraan/ai-skills/main/packages/skills-registry/skills/.index.json";
 export declare const AGENT_PLATFORMS: string[];
+export type InstallLocation = 'local' | 'global';
+export interface InstallOptions {
+    location?: InstallLocation;
+    platforms?: string[];
+    all?: boolean;
+}
+export interface ResolvedInstallOptions {
+    location: InstallLocation;
+    platforms: string[];
+}
 export declare function getAgentPlatformDirs(): string[];
+export declare function resolveInstallOptions(options?: InstallOptions): ResolvedInstallOptions;
 export declare function getLockfilePath(): string;
-export declare function getSkillInstallPaths(skillName: string): string[];
-export declare function getSkillMetadataPaths(skillName: string): string[];
+export declare function getSkillInstallPaths(skillName: string, options?: InstallOptions): string[];
+export declare function getSkillMetadataPaths(skillName: string, options?: InstallOptions): string[];
 export declare const IS_WINDOWS: boolean;
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,sFAC4D,CAAC;AAEtF,eAAO,MAAM,kBAAkB,yGAAuC,CAAC;AAEvE,eAAO,MAAM,eAAe,UAAsE,CAAC;AAEnG,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAG/C;AAED,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjE;AAED,eAAO,MAAM,UAAU,SAAyB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,sFAC4D,CAAC;AAEtF,eAAO,MAAM,kBAAkB,yGAAuC,CAAC;AAEvE,eAAO,MAAM,eAAe,UAAsE,CAAC;AAEnG,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAG/C;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,sBAAsB,CAiB1F;AAYD,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,EAAE,CAG9F;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,EAAE,CAK/F;AAED,eAAO,MAAM,UAAU,SAAyB,CAAC"}

package/dist/core/config.js

@@ -7,15 +7,39 @@ export function getAgentPlatformDirs() {
     const home = homedir();
     return AGENT_PLATFORMS.map((p) => join(home, p, 'skills'));
 }
+export function resolveInstallOptions(options = {}) {
+    const location = 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) {
+    const trimmed = name.trim();
+    return trimmed.startsWith('.') ? trimmed : `.${trimmed}`;
+}
+function getSelectedPlatformDirs(resolved) {
+    const baseDir = resolved.location === 'local' ? process.cwd() : homedir();
+    return resolved.platforms.map((p) => join(baseDir, p, 'skills'));
+}
 export function getLockfilePath() {
     const home = homedir();
     return join(home, '.ai-skills', '.skill-lock.json');
 }
-export function getSkillInstallPaths(skillName) {
-    return getAgentPlatformDirs().map((dir) => join(dir, skillName, 'SKILLS.md'));
+export function getSkillInstallPaths(skillName, options = {}) {
+    const resolved = resolveInstallOptions(options);
+    return getSelectedPlatformDirs(resolved).map((dir) => join(dir, skillName, 'SKILLS.md'));
 }
-export function getSkillMetadataPaths(skillName) {
-    return getAgentPlatformDirs().map((dir) => join(dir, skillName, '.skill-metadata.json'));
+export function getSkillMetadataPaths(skillName, options = {}) {
+    const resolved = resolveInstallOptions(options);
+    return getSelectedPlatformDirs(resolved).map((dir) => join(dir, skillName, '.skill-metadata.json'));
 }
 export const IS_WINDOWS = platform() === 'win32';
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,CAAC,MAAM,YAAY,GACvB,mFAAmF,CAAC;AAEtF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,YAAY,qBAAqB,CAAC;AAEvE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEnG,MAAM,UAAU,oBAAoB;IAClC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,kBAAkB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/installer.d.ts

@@ -1,4 +1,5 @@
-export declare function installSkill(skillName: string, skillContent: string): Promise<string[]>;
+import { type InstallOptions } from './config.js';
+export declare function installSkill(skillName: string, skillContent: string, options?: InstallOptions): Promise<string[]>;
 export declare function removeSkill(skillName: string): Promise<string[]>;
 export declare function skillExists(skillName: string): Promise<boolean>;
 export declare function readSkill(skillName: string): Promise<string | null>;

package/dist/core/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4C7F;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBtE;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAarE;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzE"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/core/installer.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI/F,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CA4CnB;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBtE;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAarE;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzE"}

package/dist/core/installer.js

@@ -3,9 +3,9 @@ import { dirname } from 'path';
 import { getSkillInstallPaths, getSkillMetadataPaths } from './config.js';
 import { sha256 } from '../utils/hash.js';
 import { info, warn } from '../utils/logger.js';
-export async function installSkill(skillName, skillContent) {
-    const installPaths = getSkillInstallPaths(skillName);
-    const metadataPaths = getSkillMetadataPaths(skillName);
+export async function installSkill(skillName, skillContent, options = {}) {
+    const installPaths = getSkillInstallPaths(skillName, options);
+    const metadataPaths = getSkillMetadataPaths(skillName, options);
     const installedPaths = [];
     const installedMetadataPaths = [];
     const hash = sha256(skillContent);

package/dist/core/installer.js.map

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

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":"AASA,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiD1C"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { install } from './commands/install.js';
+import { install, parseInstallFlags, resolveInstallOptionsFromFlags } from './commands/install.js';
 import { remove } from './commands/remove.js';
 import { list } from './commands/list.js';
 import { update } from './commands/update.js';
@@ -14,7 +14,9 @@ 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) {
@@ -44,7 +46,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 {
@@ -57,27 +61,35 @@ export async function main() {
     }
 }
 function showHelp() {
-    info(`
-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 list [--json]        List installed and available skills
-  ai-skills remove <skill>       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
-
-Examples:
-  ai-skills react
-  ai-skills install typescript
-  ai-skills list
-  ai-skills remove python
-  ai-skills update --force
-  ai-skills update --skill react
-  ai-skills generate-local
-  ai-skills generate-local react
+    info(`
+AI Skills CLI - Install framework-agnostic SKILLS.md files
+
+Usage:
+  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 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
+
+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
+  ai-skills update --force
+  ai-skills update --skill react
+  ai-skills generate-local
+  ai-skills generate-local react
   `);
 }
 //# sourceMappingURL=index.js.map

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emmraan/ai-skills",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "CLI tool for installing AI Skills across agent platforms",
   "type": "module",
   "bin": {
@@ -23,10 +23,8 @@
     "typecheck": "tsc --noEmit --project tsconfig.json",
     "clean": "rm -rf dist"
   },
-  "dependencies": {
-    "@ai-skills/shared-types": "^0.0.1"
-  },
   "devDependencies": {
+    "@ai-skills/shared-types": "workspace:*",
     "@types/node": "^20.10.0",
     "tsx": "^4.7.0",
     "vitest": "^1.1.0"

package/src/commands/install.ts

@@ -1,17 +1,143 @@
 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 { createInterface } from 'readline/promises';
+import { stdin as input, stdout as output } from 'process';
 
-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 && input.isTTY && output.isTTY) {
+      return promptInstallOptions();
+    }
+    return { location: 'global', all: true };
+  }
+
+  return { location: 'global', all: true };
+}
+
+async function promptInstallOptions(): Promise<InstallOptions> {
+  const rl = createInterface({ input, output });
+  try {
+    const locationAnswer = (
+      await rl.question(
+        'Install location? [1] Local (current project) [2] Global (agent platforms) (default: 2): '
+      )
+    ).trim();
+
+    const location: InstallLocation = locationAnswer === '1' ? 'local' : 'global';
+    if (location === 'local') {
+      return { location: 'local' };
+    }
+
+    const platformAnswer = (
+      await rl.question(
+        'Global install target? [1] All platforms [2] Specific platforms (default: 1): '
+      )
+    ).trim();
+
+    if (platformAnswer !== '2') {
+      return { location: 'global', all: true };
+    }
+
+    info(`Available platforms: ${AGENT_PLATFORMS.map((p) => p.replace(/^\./, '')).join(', ')}`);
+    const selected = (
+      await rl.question('Enter comma-separated platform names (example: claude,gemini,vscode): ')
+    )
+      .split(',')
+      .map((p) => p.trim())
+      .filter(Boolean);
+
+    return {
+      location: 'global',
+      all: selected.length === 0,
+      platforms: selected,
+    };
+  } finally {
+    rl.close();
+  }
+}
+
+export async function install(skillName: string, options: InstallOptions = {}): Promise<boolean> {
   try {
     info(`Fetching ${skillName}...`);
     const skillContent = await fetchSkill(skillName);
     const hash = sha256(skillContent);
 
     info(`Installing ${skillName}...`);
-    const installPaths = await installSkill(skillName, skillContent);
+    const installPaths = await installSkill(skillName, skillContent, options);
 
     if (installPaths.length === 0) {
       error(`Failed to install ${skillName} to any location`);

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';

package/src/core/installer.ts

@@ -1,12 +1,16 @@
 import { writeFile, mkdir, readFile, rm } from 'fs/promises';
 import { dirname } from 'path';
-import { getSkillInstallPaths, getSkillMetadataPaths } from './config.js';
+import { getSkillInstallPaths, getSkillMetadataPaths, type InstallOptions } from './config.js';
 import { sha256 } from '../utils/hash.js';
 import { info, warn } from '../utils/logger.js';
 
-export async function installSkill(skillName: string, skillContent: string): Promise<string[]> {
-  const installPaths = getSkillInstallPaths(skillName);
-  const metadataPaths = getSkillMetadataPaths(skillName);
+export async function installSkill(
+  skillName: string,
+  skillContent: string,
+  options: InstallOptions = {}
+): Promise<string[]> {
+  const installPaths = getSkillInstallPaths(skillName, options);
+  const metadataPaths = getSkillMetadataPaths(skillName, options);
   const installedPaths: string[] = [];
   const installedMetadataPaths: string[] = [];
   const hash = sha256(skillContent);

package/src/index.ts

@@ -1,4 +1,4 @@
-import { install } from './commands/install.js';
+import { install, parseInstallFlags, resolveInstallOptionsFromFlags } from './commands/install.js';
 import { remove } from './commands/remove.js';
 import { list } from './commands/list.js';
 import { update } from './commands/update.js';
@@ -18,7 +18,9 @@ export async function main(): Promise<void> {
   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];
@@ -43,7 +45,9 @@ export async function main(): Promise<void> {
       process.exit(success ? 0 : 1);
     } 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 {
       showHelp();
@@ -59,16 +63,24 @@ 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 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
+
 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