@codihaus/claude-skills 1.0.0

package/src/commands/doctor.js

@@ -0,0 +1,179 @@
+/**
+ * doctor command
+ *
+ * Check system dependencies and project setup.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import path from 'path';
+import fs from 'fs-extra';
+
+import {
+  checkGlobalDeps,
+  checkProjectDeps,
+  printDepsReport,
+  installProjectDeps
+} from '../utils/deps.js';
+import { getInstalledSkills } from '../utils/skills.js';
+
+export async function doctor(options) {
+  const projectPath = process.cwd();
+
+  console.log(chalk.bold('\n🩺 Claude Skills Doctor\n'));
+  console.log(chalk.gray(`Checking: ${projectPath}\n`));
+
+  let hasIssues = false;
+
+  // 1. Check global dependencies
+  console.log(chalk.cyan('1. System Dependencies'));
+  console.log('─'.repeat(40));
+
+  const globalDeps = await checkGlobalDeps();
+  printDepsReport(globalDeps);
+
+  if (globalDeps.hasErrors) {
+    hasIssues = true;
+    console.log(chalk.red('❌ Required dependencies missing'));
+  } else if (globalDeps.hasWarnings) {
+    console.log(chalk.yellow('⚠️  Some recommended dependencies missing'));
+  } else {
+    console.log(chalk.green('✅ All system dependencies OK'));
+  }
+
+  // 2. Check .claude folder
+  console.log('\n' + chalk.cyan('2. Claude Code Setup'));
+  console.log('─'.repeat(40));
+
+  const claudePath = path.join(projectPath, '.claude');
+  const skillsPath = path.join(claudePath, 'skills');
+  const settingsPath = path.join(claudePath, 'settings.local.json');
+
+  const checks = [
+    {
+      name: '.claude folder',
+      path: claudePath,
+      exists: await fs.pathExists(claudePath)
+    },
+    {
+      name: '.claude/skills folder',
+      path: skillsPath,
+      exists: await fs.pathExists(skillsPath)
+    },
+    {
+      name: 'settings.local.json',
+      path: settingsPath,
+      exists: await fs.pathExists(settingsPath)
+    },
+    {
+      name: 'CLAUDE.md',
+      path: path.join(projectPath, 'CLAUDE.md'),
+      exists: await fs.pathExists(path.join(projectPath, 'CLAUDE.md'))
+    }
+  ];
+
+  for (const check of checks) {
+    const icon = check.exists ? chalk.green('✓') : chalk.red('✗');
+    console.log(`  ${icon} ${check.name}`);
+  }
+
+  const missingSetup = checks.filter(c => !c.exists);
+  if (missingSetup.length > 0) {
+    hasIssues = true;
+    console.log(chalk.yellow('\n  Run `claude-skills init` to set up missing items'));
+  }
+
+  // 3. Check installed skills
+  console.log('\n' + chalk.cyan('3. Installed Skills'));
+  console.log('─'.repeat(40));
+
+  const installed = await getInstalledSkills(projectPath);
+
+  if (installed.length === 0) {
+    console.log(chalk.yellow('  No skills installed'));
+    hasIssues = true;
+  } else {
+    const skillsOnly = installed.filter(s => s.type !== 'config');
+    console.log(`  ${chalk.green('✓')} ${skillsOnly.length} skills installed`);
+
+    // Check for core skills
+    const coreSkills = ['debrief', 'dev-scout', 'dev-specs', 'dev-coding', 'dev-review'];
+    const installedNames = skillsOnly.map(s => s.name);
+    const missingCore = coreSkills.filter(s => !installedNames.includes(s));
+
+    if (missingCore.length > 0) {
+      console.log(chalk.yellow(`  ⚠️  Missing core skills: ${missingCore.join(', ')}`));
+    }
+  }
+
+  // 4. Check project dependencies
+  console.log('\n' + chalk.cyan('4. Project Dependencies'));
+  console.log('─'.repeat(40));
+
+  const projectDeps = await checkProjectDeps(projectPath);
+
+  if (projectDeps.noPackageJson) {
+    console.log(chalk.gray('  No package.json (not a Node.js project)'));
+  } else {
+    for (const dep of projectDeps.npm) {
+      const icon = dep.status === 'ok' ? chalk.green('✓') : chalk.yellow('○');
+      console.log(`  ${icon} ${dep.name} - ${dep.purpose}`);
+    }
+
+    if (projectDeps.missing.length > 0 && options.fix) {
+      console.log('');
+      const { install } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'install',
+        message: 'Install missing dependencies?',
+        default: true
+      }]);
+
+      if (install) {
+        await installProjectDeps(projectPath, projectDeps.missing);
+      }
+    }
+  }
+
+  // 5. Check for common issues
+  console.log('\n' + chalk.cyan('5. Common Issues'));
+  console.log('─'.repeat(40));
+
+  // Check .gitignore
+  const gitignorePath = path.join(projectPath, '.gitignore');
+  if (await fs.pathExists(gitignorePath)) {
+    const content = await fs.readFile(gitignorePath, 'utf-8');
+    if (content.includes('settings.local.json')) {
+      console.log(`  ${chalk.green('✓')} settings.local.json in .gitignore`);
+    } else {
+      console.log(`  ${chalk.yellow('○')} settings.local.json not in .gitignore`);
+    }
+  }
+
+  // Check for .env
+  const envPath = path.join(projectPath, '.env');
+  if (await fs.pathExists(envPath)) {
+    const content = await fs.readFile(envPath, 'utf-8');
+    if (content.includes('GEMINI_API_KEY')) {
+      console.log(`  ${chalk.green('✓')} GEMINI_API_KEY configured`);
+    } else {
+      console.log(`  ${chalk.gray('○')} GEMINI_API_KEY not set (optional for large codebase scanning)`);
+    }
+  }
+
+  // Summary
+  console.log('\n' + '─'.repeat(40));
+
+  if (hasIssues) {
+    console.log(chalk.yellow('\n⚠️  Some issues found. See above for details.\n'));
+
+    if (options.fix) {
+      console.log(chalk.cyan('Attempted to fix issues where possible.'));
+    } else {
+      console.log(chalk.gray('Run `claude-skills doctor --fix` to attempt automatic fixes.\n'));
+    }
+  } else {
+    console.log(chalk.green('\n✅ Everything looks good!\n'));
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,251 @@
+/**
+ * init command
+ *
+ * Initialize Claude Skills in a project.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+import path from 'path';
+import fs from 'fs-extra';
+
+import {
+  checkGlobalDeps,
+  checkProjectDeps,
+  printDepsReport,
+  installProjectDeps,
+  installPythonDeps
+} from '../utils/deps.js';
+import {
+  getAvailableSkills,
+  getInstalledSkills,
+  copySkillsToProject
+} from '../utils/skills.js';
+import {
+  setupSettings,
+  setupHooks,
+  setupClaudeMd,
+  updateGitignore
+} from '../utils/config.js';
+
+export async function init(options) {
+  const projectPath = process.cwd();
+
+  console.log(chalk.bold('\n🚀 Claude Skills Initialization\n'));
+  console.log(chalk.gray(`Project: ${projectPath}\n`));
+
+  // Step 1: Check global dependencies
+  if (!options.noDeps) {
+    const spinner = ora('Checking system dependencies...').start();
+    const globalDeps = await checkGlobalDeps();
+    spinner.stop();
+
+    printDepsReport(globalDeps);
+
+    if (globalDeps.hasErrors) {
+      console.log(chalk.red('\n❌ Required dependencies missing. Please install them first.\n'));
+      process.exit(1);
+    }
+
+    if (globalDeps.hasWarnings && !options.yes) {
+      const { proceed } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'proceed',
+        message: 'Some recommended dependencies are missing. Continue anyway?',
+        default: true
+      }]);
+
+      if (!proceed) {
+        console.log(chalk.yellow('Initialization cancelled.'));
+        process.exit(0);
+      }
+    }
+
+    // Offer to install missing Python packages
+    const missingPython = globalDeps.python?.filter(p => !p.installed) || [];
+    if (missingPython.length > 0 && !options.yes) {
+      const { installPython } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'installPython',
+        message: `Install missing Python packages (${missingPython.map(p => p.name).join(', ')})?`,
+        default: true
+      }]);
+
+      if (installPython) {
+        await installPythonDeps(missingPython);
+      }
+    }
+  }
+
+  // Step 2: Check if already initialized
+  const installed = await getInstalledSkills(projectPath);
+  if (installed.length > 0 && !options.yes) {
+    console.log(chalk.yellow(`\n⚠️  Skills already installed (${installed.length} found)`));
+
+    const { action } = await inquirer.prompt([{
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices: [
+        { name: 'Update to latest version', value: 'update' },
+        { name: 'Reinstall (overwrite)', value: 'reinstall' },
+        { name: 'Cancel', value: 'cancel' }
+      ]
+    }]);
+
+    if (action === 'cancel') {
+      console.log(chalk.yellow('Initialization cancelled.'));
+      process.exit(0);
+    }
+
+    if (action === 'update') {
+      // TODO: Implement update logic
+      console.log(chalk.cyan('Updating skills...'));
+    }
+  }
+
+  // Step 3: Select skills to install
+  const available = await getAvailableSkills();
+  const skillsOnly = available.filter(s => s.type !== 'config');
+
+  let skillsToInstall = null; // null means all
+
+  if (options.skills) {
+    skillsToInstall = options.skills.split(',').map(s => s.trim());
+    console.log(chalk.cyan(`\nInstalling selected skills: ${skillsToInstall.join(', ')}`));
+  } else if (!options.all && !options.yes) {
+    const { selectSkills } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'selectSkills',
+      message: 'Install all skills? (No to select specific ones)',
+      default: true
+    }]);
+
+    if (!selectSkills) {
+      const { selected } = await inquirer.prompt([{
+        type: 'checkbox',
+        name: 'selected',
+        message: 'Select skills to install:',
+        choices: skillsOnly.map(s => ({
+          name: `${s.name} - ${s.description || 'No description'}`,
+          value: s.name,
+          checked: true
+        }))
+      }]);
+
+      skillsToInstall = selected;
+    }
+  }
+
+  // Step 4: Copy skills
+  const spinner = ora('Installing skills...').start();
+
+  try {
+    const { copied, errors } = await copySkillsToProject(projectPath, skillsToInstall);
+
+    if (errors.length > 0) {
+      spinner.warn(`Installed ${copied.length} skills with ${errors.length} errors`);
+      for (const err of errors) {
+        console.log(chalk.red(`  ✗ ${err.name}: ${err.error}`));
+      }
+    } else {
+      spinner.succeed(`Installed ${copied.length} skills`);
+    }
+  } catch (e) {
+    spinner.fail('Failed to install skills');
+    console.error(chalk.red(e.message));
+    process.exit(1);
+  }
+
+  // Step 5: Set up settings
+  const settingsSpinner = ora('Setting up Claude Code configuration...').start();
+
+  try {
+    await setupSettings(projectPath);
+    settingsSpinner.succeed('Claude Code settings configured');
+  } catch (e) {
+    settingsSpinner.warn('Failed to set up settings');
+  }
+
+  // Step 6: Set up hooks
+  if (!options.noHooks) {
+    const hooksSpinner = ora('Setting up hooks...').start();
+
+    try {
+      const result = await setupHooks(projectPath);
+      if (result) {
+        hooksSpinner.succeed('Hooks configured');
+      } else {
+        hooksSpinner.info('Hooks skipped');
+      }
+    } catch (e) {
+      hooksSpinner.warn('Failed to set up hooks');
+    }
+  }
+
+  // Step 7: Set up CLAUDE.md
+  const claudeSpinner = ora('Setting up CLAUDE.md...').start();
+
+  try {
+    const result = await setupClaudeMd(projectPath);
+    claudeSpinner.succeed(`CLAUDE.md ${result.action}`);
+  } catch (e) {
+    claudeSpinner.warn('Failed to set up CLAUDE.md');
+  }
+
+  // Step 8: Update .gitignore
+  const gitSpinner = ora('Updating .gitignore...').start();
+
+  try {
+    const result = await updateGitignore(projectPath);
+    gitSpinner.succeed(`.gitignore ${result.action}`);
+  } catch (e) {
+    gitSpinner.warn('Failed to update .gitignore');
+  }
+
+  // Step 9: Check project dependencies
+  if (!options.noDeps) {
+    console.log('');
+    const projectSpinner = ora('Checking project dependencies...').start();
+    const projectDeps = await checkProjectDeps(projectPath);
+    projectSpinner.stop();
+
+    if (projectDeps.missing.length > 0) {
+      console.log(chalk.yellow('\n⚠️  Some optional dependencies are missing:\n'));
+
+      for (const dep of projectDeps.missing) {
+        const cmd = dep.type === 'pip'
+          ? chalk.cyan(`pip install ${dep.name}`)
+          : chalk.cyan(`npm install -D ${dep.name}`);
+        console.log(`  ${dep.name} - ${dep.purpose}`);
+        console.log(`    ${cmd}\n`);
+      }
+
+      if (!options.yes) {
+        const { install } = await inquirer.prompt([{
+          type: 'confirm',
+          name: 'install',
+          message: 'Install missing dependencies now?',
+          default: false
+        }]);
+
+        if (install) {
+          await installProjectDeps(projectPath, projectDeps.missing);
+        }
+      }
+    }
+  }
+
+  // Done!
+  console.log(chalk.green('\n✅ Claude Skills initialized successfully!\n'));
+
+  console.log(chalk.bold('Next steps:'));
+  console.log('');
+  console.log('  1. Start Claude Code in this project');
+  console.log('  2. Try a skill: ' + chalk.cyan('/debrief "your project idea"'));
+  console.log('  3. See all skills: ' + chalk.cyan('/help'));
+  console.log('');
+  console.log(chalk.gray('Docs: .claude/skills/_registry.md'));
+  console.log('');
+}

package/src/commands/list.js

@@ -0,0 +1,88 @@
+/**
+ * list command
+ *
+ * List available and installed skills.
+ */
+
+import chalk from 'chalk';
+
+import { getAvailableSkills, getInstalledSkills } from '../utils/skills.js';
+
+export async function list(options) {
+  const projectPath = process.cwd();
+
+  console.log(chalk.bold('\n📋 Claude Skills\n'));
+
+  const available = await getAvailableSkills();
+  const installed = await getInstalledSkills(projectPath);
+
+  const installedNames = new Set(installed.map(s => s.name));
+
+  if (options.installed) {
+    // Show only installed
+    console.log(chalk.cyan('Installed Skills:\n'));
+
+    if (installed.length === 0) {
+      console.log(chalk.gray('  No skills installed. Run `claude-skills init` to install.\n'));
+      return;
+    }
+
+    for (const skill of installed) {
+      if (skill.type === 'config') continue;
+
+      console.log(`  ${chalk.green('●')} ${skill.name}`);
+      console.log(chalk.gray(`    v${skill.version || 'unknown'} - ${skill.description || ''}`));
+    }
+  } else {
+    // Show all available with install status
+    console.log(chalk.cyan('Available Skills:\n'));
+
+    // Group by category
+    const mainSkills = available.filter(s => !s.category && s.type !== 'config');
+    const utilSkills = available.filter(s => s.category === 'utils');
+    const configFiles = available.filter(s => s.type === 'config');
+
+    // Main skills
+    console.log(chalk.bold('  Main Skills:'));
+    for (const skill of mainSkills) {
+      const isInstalled = installedNames.has(skill.name);
+      const icon = isInstalled ? chalk.green('●') : chalk.gray('○');
+      const status = isInstalled ? chalk.green(' (installed)') : '';
+
+      console.log(`    ${icon} /${skill.name}${status}`);
+      console.log(chalk.gray(`      v${skill.version || '?'} - ${skill.description || ''}`));
+    }
+
+    // Utility skills
+    if (utilSkills.length > 0) {
+      console.log('');
+      console.log(chalk.bold('  Utility Skills:'));
+      for (const skill of utilSkills) {
+        const isInstalled = installedNames.has(skill.name);
+        const icon = isInstalled ? chalk.green('●') : chalk.gray('○');
+        const status = isInstalled ? chalk.green(' (installed)') : '';
+
+        console.log(`    ${icon} /${skill.name}${status}`);
+        console.log(chalk.gray(`      v${skill.version || '?'} - ${skill.description || ''}`));
+      }
+    }
+
+    // Config files
+    console.log('');
+    console.log(chalk.bold('  Config Files:'));
+    for (const file of configFiles) {
+      const isInstalled = installedNames.has(file.name);
+      const icon = isInstalled ? chalk.green('●') : chalk.gray('○');
+      console.log(`    ${icon} ${file.name}`);
+    }
+  }
+
+  console.log('');
+
+  // Summary
+  const skillCount = available.filter(s => s.type !== 'config').length;
+  const installedCount = installed.filter(s => s.type !== 'config').length;
+
+  console.log(chalk.gray(`${installedCount}/${skillCount} skills installed`));
+  console.log('');
+}

package/src/commands/remove.js

@@ -0,0 +1,60 @@
+/**
+ * remove command
+ *
+ * Remove a skill from the project.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+
+import { getInstalledSkills, removeSkillFromProject } from '../utils/skills.js';
+
+export async function remove(skillName) {
+  const projectPath = process.cwd();
+
+  console.log(chalk.bold(`\n➖ Removing skill: ${skillName}\n`));
+
+  // Check if skill is installed
+  const installed = await getInstalledSkills(projectPath);
+  const skill = installed.find(s => s.name === skillName);
+
+  if (!skill) {
+    console.log(chalk.yellow(`⚠️  Skill not installed: ${skillName}\n`));
+    process.exit(0);
+  }
+
+  // Confirm removal
+  const { confirm } = await inquirer.prompt([{
+    type: 'confirm',
+    name: 'confirm',
+    message: `Remove ${skillName}?`,
+    default: false
+  }]);
+
+  if (!confirm) {
+    console.log(chalk.yellow('Removal cancelled.\n'));
+    process.exit(0);
+  }
+
+  // Remove the skill
+  const spinner = ora(`Removing ${skillName}...`).start();
+
+  try {
+    const result = await removeSkillFromProject(projectPath, skillName);
+
+    if (!result.success) {
+      spinner.fail(`Failed to remove ${skillName}`);
+      console.log(chalk.red(result.error));
+      process.exit(1);
+    }
+
+    spinner.succeed(`Removed ${skillName}`);
+  } catch (e) {
+    spinner.fail('Removal failed');
+    console.error(chalk.red(e.message));
+    process.exit(1);
+  }
+
+  console.log(chalk.green(`\n✅ ${skillName} removed.\n`));
+}

package/src/commands/update.js

@@ -0,0 +1,72 @@
+/**
+ * update command
+ *
+ * Update installed skills to latest version.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+
+import { checkForUpdates, copySkillsToProject, getInstalledSkills } from '../utils/skills.js';
+
+export async function update(options) {
+  const projectPath = process.cwd();
+
+  console.log(chalk.bold('\n📦 Claude Skills Update\n'));
+
+  // Check for installed skills
+  const installed = await getInstalledSkills(projectPath);
+
+  if (installed.length === 0) {
+    console.log(chalk.yellow('No skills installed. Run `claude-skills init` first.\n'));
+    process.exit(0);
+  }
+
+  console.log(chalk.gray(`Found ${installed.length} installed skills\n`));
+
+  // Check for updates
+  const spinner = ora('Checking for updates...').start();
+  const updates = await checkForUpdates(projectPath);
+  spinner.stop();
+
+  if (updates.length === 0) {
+    console.log(chalk.green('✅ All skills are up to date!\n'));
+    process.exit(0);
+  }
+
+  console.log(chalk.cyan(`Found ${updates.length} update(s) available:\n`));
+
+  for (const update of updates) {
+    console.log(`  ${update.name}`);
+    console.log(chalk.gray(`    ${update.current} → ${update.available}`));
+    console.log('');
+  }
+
+  if (options.check) {
+    console.log(chalk.gray('Run `claude-skills update` to install updates.\n'));
+    process.exit(0);
+  }
+
+  // Apply updates
+  const updateSpinner = ora('Updating skills...').start();
+
+  try {
+    const skillNames = updates.map(u => u.name);
+    const { copied, errors } = await copySkillsToProject(projectPath, skillNames);
+
+    if (errors.length > 0) {
+      updateSpinner.warn(`Updated ${copied.length} skills with ${errors.length} errors`);
+      for (const err of errors) {
+        console.log(chalk.red(`  ✗ ${err.name}: ${err.error}`));
+      }
+    } else {
+      updateSpinner.succeed(`Updated ${copied.length} skills`);
+    }
+  } catch (e) {
+    updateSpinner.fail('Update failed');
+    console.error(chalk.red(e.message));
+    process.exit(1);
+  }
+
+  console.log(chalk.green('\n✅ Update complete!\n'));
+}

package/src/index.js

@@ -0,0 +1,26 @@
+/**
+ * Claude Skills
+ *
+ * Programmatic API for managing Claude Code skills.
+ */
+
+export {
+  checkGlobalDeps,
+  checkProjectDeps,
+  installProjectDeps
+} from './utils/deps.js';
+
+export {
+  getAvailableSkills,
+  getInstalledSkills,
+  copySkillsToProject,
+  removeSkillFromProject,
+  checkForUpdates
+} from './utils/skills.js';
+
+export {
+  setupSettings,
+  setupHooks,
+  setupClaudeMd,
+  updateGitignore
+} from './utils/config.js';