Function buildSkillCommand

src/cli/skill-command.ts:18–396

()

import { seedBundledSkills } from '../skills/seed.js';

export function buildSkillCommand(): Command {
  const cmd = new Command('skill');
  cmd.description('Manage installed skills (taste, ui-ux-pro-max, ghost, OODA, etc.)');

  cmd
    .command('list')
    .alias('ls')
    .description('List every installed skill with origin, version, and enabled state')
    .action(async () => {
      // Seed bundled skills on first invocation so `qodex skill list` immediately
      // surfaces the defaults without forcing the user to launch the REPL first.
      await seedBundledSkills();
      await initSkillRegistry(process.cwd());
      const all = await listAllSkillsWithState(process.cwd());
      if (all.length === 0) {
        console.log('No skills installed. Try: qodex skill install gh:qodex-skills/taste');
        return;
      }
      console.log(`${all.length} skill(s):\n`);
      for (const s of all) {
        const flag = s.enabled ? '●' : '○';
        const ver = s.version ? ` v${s.version}` : '';
        const aliases = s.slashAliases?.length ? `  slash: ${s.slashAliases.map(a => '/' + a).join(' ')}` : '';
        console.log(`  ${flag} ${s.name}${ver}  [${s.origin}]${aliases}`);
        console.log(`      ${s.description}`);
      }
      console.log('\nLegend: ● enabled, ○ disabled');
    });

  cmd
    .command('install <source>')
    .description('Install a skill. Sources: ./path, file.tgz, gh:user/repo[@ref], npm:<pkg>')
    .option('-f, --force', 'Overwrite if a skill with the same name is already installed')
    .action(async (source: string, opts: { force?: boolean }) => {
      try {
        const result = await installSkill(source, { force: opts.force });
        console.log(`✓ Installed skill "${result.name}" from ${result.source}`);
        console.log(`  → ${result.installedTo}`);
        await refreshSkillRegistry();
      } catch (e: any) {
        console.error(`✗ ${e.message}`);
        process.exit(1);
      }
    });

  cmd
    .command('install-all <source>')
    .description('Install EVERY skill in a multi-skill repo OR every linked skill in a catalog repo (e.g. gh:abubakarsiddik31/claude-skills-collection)')
    .option('-f, --force', 'Overwrite skills already installed')
    .option('--max <n>', 'Cap the number of skills installed', (v) => parseInt(v, 10))
    .action(async (source: string, opts: { force?: boolean; max?: number }) => {
      try {
        const { installAll } = await import('../skills/bulk-installer.js');
        const result = await installAll(source, {
          force: opts.force,
          maxSkills: opts.max,
          onProgress: (m) => console.log(`  ${m}`),
        });