@emmraan/ai-skills 0.0.3 → 1.0.0

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);
@@ -50,21 +54,26 @@ export async function installSkill(skillName: string, skillContent: string): Pro
   return installedPaths;
 }
 
-export async function removeSkill(skillName: string): Promise<string[]> {
-  const installPaths = getSkillInstallPaths(skillName);
-  const metadataPaths = getSkillMetadataPaths(skillName);
+export async function removeSkill(
+  skillName: string,
+  options: InstallOptions = {}
+): Promise<string[]> {
+  const installPaths = getSkillInstallPaths(skillName, options);
+  const metadataPaths = getSkillMetadataPaths(skillName, options);
   const removedPaths: string[] = [];
 
   for (let i = 0; i < installPaths.length; i++) {
     const skillPath = installPaths[i];
     const metadataPath = metadataPaths[i];
+    const skillDir = dirname(skillPath);
     try {
       await rm(skillPath, { force: true });
       await rm(metadataPath, { force: true });
+      await rm(skillDir, { recursive: true, force: true });
       removedPaths.push(skillPath);
-      info(`Removed ${skillPath}`);
+      info(`Removed ${skillDir}`);
     } catch (err) {
-      warn(`Failed to remove ${skillPath}: ${err instanceof Error ? err.message : String(err)}`);
+      warn(`Failed to remove ${skillDir}: ${err instanceof Error ? err.message : String(err)}`);
     }
   }
 

package/src/core/lockfile.ts

@@ -59,6 +59,21 @@ export async function removeSkillFromLockfile(skillName: string): Promise<void>
   await writeLockfile(lockfile);
 }
 
+export async function updateSkillInstallPathsInLockfile(
+  skillName: string,
+  installPaths: string[]
+): Promise<void> {
+  const lockfile = await readLockfile();
+  const entry = lockfile.installedSkills[skillName];
+  if (!entry) {
+    return;
+  }
+
+  entry.installPaths = installPaths;
+  entry.timestamp = new Date().toISOString();
+  await writeLockfile(lockfile);
+}
+
 export async function getInstalledSkills(): Promise<LockfileEntry[]> {
   const lockfile = await readLockfile();
   return Object.values(lockfile.installedSkills);

package/src/index.ts

@@ -1,13 +1,16 @@
-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(): Promise<void> {
+  ui.printBanner();
+
   if (args.length === 0) {
     showHelp();
     return;
@@ -18,11 +21,15 @@ 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];
-      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') {
       const jsonFlag = args.includes('--json');
@@ -43,7 +50,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 +68,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/src/utils/logger.ts

@@ -1,21 +1,23 @@
 /* eslint-disable no-console */
 
+import chalk from 'chalk';
+
 export function log(message: string) {
   console.log(message);
 }
 
 export function info(message: string) {
-  console.log(`ℹ ${message}`);
+  console.log(`${chalk.cyan('ℹ')} ${chalk.gray(message)}`);
 }
 
 export function success(message: string) {
-  console.log(`✓ ${message}`);
+  console.log(`${chalk.green('✓')} ${chalk.green(message)}`);
 }
 
 export function error(message: string) {
-  console.error(`✗ ${message}`);
+  console.error(`${chalk.red('✗')} ${chalk.red(message)}`);
 }
 
 export function warn(message: string) {
-  console.warn(`⚠ ${message}`);
+  console.warn(`${chalk.yellow('⚠')} ${chalk.yellow(message)}`);
 }

package/src/utils/ui.ts

@@ -0,0 +1,57 @@
+import chalk from 'chalk';
+import ora, { type Ora } from 'ora';
+import { info } from '../utils/logger.js';
+
+let activeSpinner: Ora | null = null;
+
+export const ui = {
+  bannerShown: false,
+
+  printBanner(): void {
+    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: string): void {
+    if (!process.stdout.isTTY) {
+      return;
+    }
+
+    if (activeSpinner) {
+      activeSpinner.stop();
+    }
+    activeSpinner = ora({ text, spinner: 'dots' }).start();
+  },
+
+  stopSpinnerSuccess(text?: string): void {
+    if (!activeSpinner) {
+      return;
+    }
+    activeSpinner.succeed(text);
+    activeSpinner = null;
+  },
+
+  stopSpinnerFail(text?: string): void {
+    if (!activeSpinner) {
+      return;
+    }
+    activeSpinner.fail(text);
+    activeSpinner = null;
+  },
+
+  stopSpinner(): void {
+    if (!activeSpinner) {
+      return;
+    }
+    activeSpinner.stop();
+    activeSpinner = null;
+  },
+};
+