@emmraan/ai-skills 0.0.1 → 0.0.2

package/README.md

@@ -1,24 +1,24 @@
-# AI Skills CLI
-
-Install framework-agnostic `SKILLS.md` files for AI agents.
-
-## Usage
-
-- `npx ai-skills react` - Install React skill
-- `npx ai-skills install react` - Install React skill (explicit command)
-- `npx ai-skills list` - List available and installed skills
-- `npx ai-skills update` - Update all installed skills
-- `npx ai-skills remove react` - Remove React skill
-- `npx ai-skills generate-local` - Run local backend generator
-
-## Publish to npm
-
-This package is the publishable CLI package for the `ai-skills` command.
-
-1. Build from workspace root: `pnpm build`
-2. Login to npm: `npm login`
-3. Publish CLI package: `npm publish --access public` (run inside `packages/cli`)
-
-After publishing, users can run:
-
-- `npx ai-skills list`
+# AI Skills CLI
+
+Install framework-agnostic `SKILLS.md` files for AI agents.
+
+## Usage
+
+- `npx @emmraan/ai-skills react` - Install React skill
+- `npx @emmraan/ai-skills install react` - Install React skill (explicit command)
+- `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
+
+## Publish to npm
+
+This package is the publishable CLI package for the `ai-skills` command.
+
+1. Build from workspace root: `pnpm build`
+2. Login to npm: `npm login`
+3. Publish CLI package: `npm publish --access public` (run inside `packages/cli`)
+
+After publishing, users can run:
+
+- `npx @emmraan/ai-skills list`

package/bin/skills.js

@@ -1,3 +1,3 @@
-#!/usr/bin/env node
-
-import '../dist/bin/skills.js';
+#!/usr/bin/env node
+
+import '../dist/bin/skills.js';

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "@emmraan/ai-skills",
-  "version": "0.0.1",
-  "description": "CLI tool for installing AI Skills across agent platforms",
-  "type": "module",
-  "bin": {
-    "ai-skills": "bin/skills.js",
-    "skills": "bin/skills.js"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsc --project tsconfig.json",
-    "dev": "tsx src/bin/skills.ts",
-    "test": "vitest run",
-    "lint": "node -e \"process.exit(0)\"",
-    "typecheck": "tsc --noEmit --project tsconfig.json",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "@ai-skills/shared-types": "workspace:*"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "tsx": "^4.7.0",
-    "vitest": "^1.1.0"
-  }
-}
+{
+  "name": "@emmraan/ai-skills",
+  "version": "0.0.2",
+  "description": "CLI tool for installing AI Skills across agent platforms",
+  "type": "module",
+  "bin": {
+    "ai-skills": "bin/skills.js",
+    "skills": "bin/skills.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsx src/bin/skills.ts",
+    "test": "vitest run",
+    "lint": "node -e \"process.exit(0)\"",
+    "typecheck": "tsc --noEmit --project tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@ai-skills/shared-types": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "vitest": "^1.1.0"
+  }
+}

package/src/bin/skills.ts

@@ -1,8 +1,8 @@
-#!/usr/bin/env node
-
-import { main } from '../index.js';
-
-main().catch((err) => {
-  console.error('Fatal error:', err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+import { main } from '../index.js';
+
+main().catch((err) => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/src/commands/__tests__/install.test.ts

@@ -1,49 +1,49 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-
-vi.mock('../../core/downloader', () => ({
-  fetchSkill: vi.fn(),
-  fetchRegistryIndex: vi.fn(),
-}));
-
-vi.mock('../../core/installer', () => ({
-  installSkill: vi.fn(),
-}));
-
-vi.mock('../../core/lockfile', () => ({
-  addSkillToLockfile: vi.fn(),
-}));
-
-import { install } from '../../commands/install';
-
-describe('install command', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it('uses registry index version when writing lockfile', async () => {
-    const downloader = await import('../../core/downloader');
-    const installer = await import('../../core/installer');
-    const lockfile = await import('../../core/lockfile');
-
-    vi.mocked(downloader.fetchSkill).mockResolvedValue('# React Skill');
-    vi.mocked(downloader.fetchRegistryIndex).mockResolvedValue({
-      skills: {
-        react: {
-          version: '18.2.0',
-          domains: ['frontend'],
-          lastGenerated: '2026-02-06T00:00:00Z',
-        },
-      },
-    });
-    vi.mocked(installer.installSkill).mockResolvedValue(['/tmp/.agents/skills/react/SKILLS.md']);
-
-    const ok = await install('react');
-    expect(ok).toBe(true);
-    expect(lockfile.addSkillToLockfile).toHaveBeenCalledWith(
-      'react',
-      '18.2.0',
-      expect.stringMatching(/^[a-f0-9]{64}$/),
-      ['/tmp/.agents/skills/react/SKILLS.md']
-    );
-  });
-});
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+vi.mock('../../core/downloader', () => ({
+  fetchSkill: vi.fn(),
+  fetchRegistryIndex: vi.fn(),
+}));
+
+vi.mock('../../core/installer', () => ({
+  installSkill: vi.fn(),
+}));
+
+vi.mock('../../core/lockfile', () => ({
+  addSkillToLockfile: vi.fn(),
+}));
+
+import { install } from '../../commands/install';
+
+describe('install command', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it('uses registry index version when writing lockfile', async () => {
+    const downloader = await import('../../core/downloader');
+    const installer = await import('../../core/installer');
+    const lockfile = await import('../../core/lockfile');
+
+    vi.mocked(downloader.fetchSkill).mockResolvedValue('# React Skill');
+    vi.mocked(downloader.fetchRegistryIndex).mockResolvedValue({
+      skills: {
+        react: {
+          version: '18.2.0',
+          domains: ['frontend'],
+          lastGenerated: '2026-02-06T00:00:00Z',
+        },
+      },
+    });
+    vi.mocked(installer.installSkill).mockResolvedValue(['/tmp/.agents/skills/react/SKILLS.md']);
+
+    const ok = await install('react');
+    expect(ok).toBe(true);
+    expect(lockfile.addSkillToLockfile).toHaveBeenCalledWith(
+      'react',
+      '18.2.0',
+      expect.stringMatching(/^[a-f0-9]{64}$/),
+      ['/tmp/.agents/skills/react/SKILLS.md']
+    );
+  });
+});

package/src/commands/generate-local.ts

@@ -1,38 +1,38 @@
-import { spawn } from 'child_process';
-import { resolve } from 'path';
-import { error, info, success } from '../utils/logger.js';
-
-export async function generateLocal(skill?: string): Promise<boolean> {
-  const backendDir = resolve(process.cwd(), 'backend');
-  const command = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
-  const args = ['run', 'generate'];
-
-  if (skill) {
-    args.push('--', '--skill', skill);
-  }
-
-  info(`Running local generator in ${backendDir}...`);
-
-  return new Promise((resolvePromise) => {
-    const child = spawn(command, args, {
-      cwd: backendDir,
-      stdio: 'inherit',
-      shell: false,
-    });
-
-    child.on('error', (err) => {
-      error(`Failed to start local generator: ${err.message}`);
-      resolvePromise(false);
-    });
-
-    child.on('exit', (code) => {
-      if (code === 0) {
-        success('Local generation completed successfully');
-        resolvePromise(true);
-      } else {
-        error(`Local generation failed with exit code ${code ?? -1}`);
-        resolvePromise(false);
-      }
-    });
-  });
-}
+import { spawn } from 'child_process';
+import { resolve } from 'path';
+import { error, info, success } from '../utils/logger.js';
+
+export async function generateLocal(skill?: string): Promise<boolean> {
+  const backendDir = resolve(process.cwd(), 'backend');
+  const command = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
+  const args = ['run', 'generate'];
+
+  if (skill) {
+    args.push('--', '--skill', skill);
+  }
+
+  info(`Running local generator in ${backendDir}...`);
+
+  return new Promise((resolvePromise) => {
+    const child = spawn(command, args, {
+      cwd: backendDir,
+      stdio: 'inherit',
+      shell: false,
+    });
+
+    child.on('error', (err) => {
+      error(`Failed to start local generator: ${err.message}`);
+      resolvePromise(false);
+    });
+
+    child.on('exit', (code) => {
+      if (code === 0) {
+        success('Local generation completed successfully');
+        resolvePromise(true);
+      } else {
+        error(`Local generation failed with exit code ${code ?? -1}`);
+        resolvePromise(false);
+      }
+    });
+  });
+}

package/src/commands/install.ts

@@ -1,31 +1,31 @@
-import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
-import { installSkill } from '../core/installer.js';
-import { addSkillToLockfile } from '../core/lockfile.js';
-import { sha256 } from '../utils/hash.js';
-import { error, success, info } from '../utils/logger.js';
-
-export async function install(skillName: string): Promise<boolean> {
-  try {
-    info(`Fetching ${skillName}...`);
-    const skillContent = await fetchSkill(skillName);
-    const hash = sha256(skillContent);
-
-    info(`Installing ${skillName}...`);
-    const installPaths = await installSkill(skillName, skillContent);
-
-    if (installPaths.length === 0) {
-      error(`Failed to install ${skillName} to any location`);
-      return false;
-    }
-
-    const index = await fetchRegistryIndex();
-    const skillVersion = index.skills[skillName]?.version || 'unknown';
-
-    await addSkillToLockfile(skillName, skillVersion, hash, installPaths);
-    success(`Installed ${skillName} (${skillVersion}) to ${installPaths.length} location(s)`);
-    return true;
-  } catch (err) {
-    error(`Failed to install ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-}
+import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
+import { installSkill } from '../core/installer.js';
+import { addSkillToLockfile } from '../core/lockfile.js';
+import { sha256 } from '../utils/hash.js';
+import { error, success, info } from '../utils/logger.js';
+
+export async function install(skillName: string): Promise<boolean> {
+  try {
+    info(`Fetching ${skillName}...`);
+    const skillContent = await fetchSkill(skillName);
+    const hash = sha256(skillContent);
+
+    info(`Installing ${skillName}...`);
+    const installPaths = await installSkill(skillName, skillContent);
+
+    if (installPaths.length === 0) {
+      error(`Failed to install ${skillName} to any location`);
+      return false;
+    }
+
+    const index = await fetchRegistryIndex();
+    const skillVersion = index.skills[skillName]?.version || 'unknown';
+
+    await addSkillToLockfile(skillName, skillVersion, hash, installPaths);
+    success(`Installed ${skillName} (${skillVersion}) to ${installPaths.length} location(s)`);
+    return true;
+  } catch (err) {
+    error(`Failed to install ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}

package/src/commands/list.ts

@@ -1,41 +1,41 @@
-import { getAvailableSkills } from '../core/downloader.js';
-import { getInstalledSkills } from '../core/lockfile.js';
-import { log } from '../utils/logger.js';
-
-export async function list(json: boolean = false): Promise<void> {
-  const installedSkills = await getInstalledSkills();
-  const availableSkills = await getAvailableSkills();
-
-  const installed = installedSkills.map((s) => s.name);
-
-  if (json) {
-    const output = {
-      installed,
-      available: availableSkills,
-      summary: {
-        installedCount: installed.length,
-        availableCount: availableSkills.length,
-      },
-    };
-    log(JSON.stringify(output, null, 2));
-  } else {
-    log('\n📦 Installed Skills:');
-    if (installed.length === 0) {
-      log('  (none)');
-    } else {
-      installed.forEach((name) => {
-        const entry = installedSkills.find((s) => s.name === name);
-        log(`  • ${name} (v${entry?.version || 'unknown'})`);
-      });
-    }
-
-    log('\n🌐 Available Skills:');
-    availableSkills.forEach((name) => {
-      const isInstalled = installed.includes(name);
-      const status = isInstalled ? ' [installed]' : '';
-      log(`  • ${name}${status}`);
-    });
-
-    log(`\nTotal: ${installed.length} installed, ${availableSkills.length} available\n`);
-  }
-}
+import { getAvailableSkills } from '../core/downloader.js';
+import { getInstalledSkills } from '../core/lockfile.js';
+import { log } from '../utils/logger.js';
+
+export async function list(json: boolean = false): Promise<void> {
+  const installedSkills = await getInstalledSkills();
+  const availableSkills = await getAvailableSkills();
+
+  const installed = installedSkills.map((s) => s.name);
+
+  if (json) {
+    const output = {
+      installed,
+      available: availableSkills,
+      summary: {
+        installedCount: installed.length,
+        availableCount: availableSkills.length,
+      },
+    };
+    log(JSON.stringify(output, null, 2));
+  } else {
+    log('\n📦 Installed Skills:');
+    if (installed.length === 0) {
+      log('  (none)');
+    } else {
+      installed.forEach((name) => {
+        const entry = installedSkills.find((s) => s.name === name);
+        log(`  • ${name} (v${entry?.version || 'unknown'})`);
+      });
+    }
+
+    log('\n🌐 Available Skills:');
+    availableSkills.forEach((name) => {
+      const isInstalled = installed.includes(name);
+      const status = isInstalled ? ' [installed]' : '';
+      log(`  • ${name}${status}`);
+    });
+
+    log(`\nTotal: ${installed.length} installed, ${availableSkills.length} available\n`);
+  }
+}

package/src/commands/remove.ts

@@ -1,22 +1,22 @@
-import { removeSkill } from '../core/installer.js';
-import { removeSkillFromLockfile, getSkillEntry } from '../core/lockfile.js';
-import { error, success, info } from '../utils/logger.js';
-
-export async function remove(skillName: string): Promise<boolean> {
-  try {
-    const entry = await getSkillEntry(skillName);
-    if (!entry) {
-      info(`${skillName} is not installed`);
-      return true;
-    }
-
-    info(`Removing ${skillName}...`);
-    await removeSkill(skillName);
-    await removeSkillFromLockfile(skillName);
-    success(`Removed ${skillName}`);
-    return true;
-  } catch (err) {
-    error(`Failed to remove ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-}
+import { removeSkill } from '../core/installer.js';
+import { removeSkillFromLockfile, getSkillEntry } from '../core/lockfile.js';
+import { error, success, info } from '../utils/logger.js';
+
+export async function remove(skillName: string): Promise<boolean> {
+  try {
+    const entry = await getSkillEntry(skillName);
+    if (!entry) {
+      info(`${skillName} is not installed`);
+      return true;
+    }
+
+    info(`Removing ${skillName}...`);
+    await removeSkill(skillName);
+    await removeSkillFromLockfile(skillName);
+    success(`Removed ${skillName}`);
+    return true;
+  } catch (err) {
+    error(`Failed to remove ${skillName}: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}

package/src/commands/update.ts

@@ -1,69 +1,69 @@
-import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
-import { installSkill } from '../core/installer.js';
-import { addSkillToLockfile, getInstalledSkills, getSkillEntry } from '../core/lockfile.js';
-import { sha256 } from '../utils/hash.js';
-import { error, success, info, warn } from '../utils/logger.js';
-
-export async function update(options: { force?: boolean; skill?: string } = {}): Promise<boolean> {
-  try {
-    const installed = await getInstalledSkills();
-    const index = await fetchRegistryIndex();
-
-    if (options.skill) {
-      // Update specific skill
-      const skillName = options.skill;
-      const entry = await getSkillEntry(skillName);
-
-      if (!entry) {
-        warn(`${skillName} is not installed`);
-        return false;
-      }
-
-      const skillContent = await fetchSkill(skillName);
-      const newHash = sha256(skillContent);
-
-      if (newHash === entry.hash && !options.force) {
-        info(`${skillName} is already up-to-date`);
-        return true;
-      }
-
-      info(`Updating ${skillName}...`);
-      const installPaths = await installSkill(skillName, skillContent);
-      const version = index.skills[skillName]?.version || 'unknown';
-      await addSkillToLockfile(skillName, version, newHash, installPaths);
-      success(`Updated ${skillName}`);
-      return true;
-    }
-
-    // Update all installed skills
-    let updateCount = 0;
-    for (const entry of installed) {
-      try {
-        const skillContent = await fetchSkill(entry.name);
-        const newHash = sha256(skillContent);
-
-        if (newHash === entry.hash && !options.force) {
-          info(`${entry.name} is already up-to-date`);
-          continue;
-        }
-
-        info(`Updating ${entry.name}...`);
-        const installPaths = await installSkill(entry.name, skillContent);
-        const version = index.skills[entry.name]?.version || 'unknown';
-        await addSkillToLockfile(entry.name, version, newHash, installPaths);
-        success(`Updated ${entry.name}`);
-        updateCount++;
-      } catch (err) {
-        error(
-          `Failed to update ${entry.name}: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
-    }
-
-    success(`Updated ${updateCount} skill(s)`);
-    return true;
-  } catch (err) {
-    error(`Update failed: ${err instanceof Error ? err.message : String(err)}`);
-    return false;
-  }
-}
+import { fetchSkill, fetchRegistryIndex } from '../core/downloader.js';
+import { installSkill } from '../core/installer.js';
+import { addSkillToLockfile, getInstalledSkills, getSkillEntry } from '../core/lockfile.js';
+import { sha256 } from '../utils/hash.js';
+import { error, success, info, warn } from '../utils/logger.js';
+
+export async function update(options: { force?: boolean; skill?: string } = {}): Promise<boolean> {
+  try {
+    const installed = await getInstalledSkills();
+    const index = await fetchRegistryIndex();
+
+    if (options.skill) {
+      // Update specific skill
+      const skillName = options.skill;
+      const entry = await getSkillEntry(skillName);
+
+      if (!entry) {
+        warn(`${skillName} is not installed`);
+        return false;
+      }
+
+      const skillContent = await fetchSkill(skillName);
+      const newHash = sha256(skillContent);
+
+      if (newHash === entry.hash && !options.force) {
+        info(`${skillName} is already up-to-date`);
+        return true;
+      }
+
+      info(`Updating ${skillName}...`);
+      const installPaths = await installSkill(skillName, skillContent);
+      const version = index.skills[skillName]?.version || 'unknown';
+      await addSkillToLockfile(skillName, version, newHash, installPaths);
+      success(`Updated ${skillName}`);
+      return true;
+    }
+
+    // Update all installed skills
+    let updateCount = 0;
+    for (const entry of installed) {
+      try {
+        const skillContent = await fetchSkill(entry.name);
+        const newHash = sha256(skillContent);
+
+        if (newHash === entry.hash && !options.force) {
+          info(`${entry.name} is already up-to-date`);
+          continue;
+        }
+
+        info(`Updating ${entry.name}...`);
+        const installPaths = await installSkill(entry.name, skillContent);
+        const version = index.skills[entry.name]?.version || 'unknown';
+        await addSkillToLockfile(entry.name, version, newHash, installPaths);
+        success(`Updated ${entry.name}`);
+        updateCount++;
+      } catch (err) {
+        error(
+          `Failed to update ${entry.name}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+
+    success(`Updated ${updateCount} skill(s)`);
+    return true;
+  } catch (err) {
+    error(`Update failed: ${err instanceof Error ? err.message : String(err)}`);
+    return false;
+  }
+}