cli-ai-skills 1.0.0

package/README.md

@@ -0,0 +1,257 @@
+# CLI AI Skills Installer
+
+Install AI skills for **GitHub Copilot CLI** and **Claude Code** with a single command.
+
+```bash
+npx cli-ai-skills install
+```
+
+## ✨ Features
+
+- 🎯 **Interactive Installation** - Choose skills, platforms, and scope
+- 🔍 **Smart Version Detection** - Automatically detects outdated skills
+- 📦 **Multi-Platform Support** - GitHub Copilot CLI and Claude Code
+- 🌍 **Global or Local** - Install globally or per-repository
+- 🔗 **Symlink Support** - Auto-updates with repository changes
+- 📊 **Progress Gauge** - Visual progress tracking
+- 🏥 **Doctor Command** - Diagnose installation issues
+
+## 🚀 Quick Start
+
+### Install All Skills
+
+```bash
+npx cli-ai-skills install --all
+```
+
+### Install Specific Skill
+
+```bash
+npx cli-ai-skills install prompt-engineer
+```
+
+### Interactive Installation
+
+```bash
+npx cli-ai-skills install
+```
+
+You'll be prompted to select:
+- **Scope**: Global or Local
+- **Platforms**: GitHub Copilot CLI, Claude Code, or both
+- **Skills**: Which skills to install
+
+## 📦 Available Skills
+
+- **prompt-engineer** - Transform prompts using 11 established frameworks
+- **skill-creator** - Create new skills interactively
+- **youtube-summarizer** - Extract and summarize YouTube videos
+
+## 📖 Commands
+
+### `install [skills...]`
+
+Install AI skills.
+
+```bash
+# Install all skills
+npx cli-ai-skills install --all
+
+# Install specific skills
+npx cli-ai-skills install prompt-engineer skill-creator
+
+# Install for specific platform
+npx cli-ai-skills install --copilot
+npx cli-ai-skills install --claude
+
+# Install locally (in current repository)
+npx cli-ai-skills install --local
+
+# Silent installation (skip prompts)
+npx cli-ai-skills install --all --yes
+```
+
+**Options:**
+- `-a, --all` - Install all available skills
+- `-g, --global` - Install globally (default)
+- `-l, --local` - Install in current repository
+- `--copilot` - Install only for GitHub Copilot CLI
+- `--claude` - Install only for Claude Code
+- `-y, --yes` - Skip confirmations
+- `--copy` - Copy files instead of symlinks
+
+### `list`
+
+List available and installed skills.
+
+```bash
+npx cli-ai-skills list
+```
+
+Shows:
+- ✅ Installed skills with versions
+- ⚠️ Skills with updates available
+- ⬜ Skills not yet installed
+
+### `update [skills...]`
+
+Update installed skills.
+
+```bash
+# Update all skills
+npx cli-ai-skills update --all
+
+# Update specific skill
+npx cli-ai-skills update prompt-engineer
+```
+
+### `uninstall <skill>`
+
+Remove an installed skill.
+
+```bash
+npx cli-ai-skills uninstall youtube-summarizer
+```
+
+### `doctor`
+
+Diagnose installation issues.
+
+```bash
+npx cli-ai-skills doctor
+```
+
+Checks:
+- ✅ Node.js version
+- ✅ Platform installations (Copilot/Claude)
+- ✅ Directory permissions
+- ✅ Network connectivity
+
+## 🎨 Example Usage
+
+### First-Time Installation
+
+```bash
+$ npx cli-ai-skills install
+
+🤖 CLI AI Skills Installer v1.0.0
+
+[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Detecting platforms
+🔍 Platform Detection:
+  ✅ GitHub Copilot CLI found (gh version 2.50.0)
+  ✅ Claude Code detected (~/.claude/)
+
+📍 Where do you want to install skills?
+❯ Global (available for all projects)
+  Local (current repository only)
+
+📦 Select platforms to install skills for:
+❯◉ GitHub Copilot CLI (~/.copilot/skills/)
+ ◉ Claude Code (~/.claude/skills/)
+
+🎯 Which skills do you want to install?
+❯◉ prompt-engineer v1.0.0 - Transform prompts
+ ◉ skill-creator v1.1.0 - Create new skills
+ ◯ youtube-summarizer v1.0.0 - Summarize videos
+ ◯ All skills
+
+[████████████████████] 100% - Installation complete!
+
+🎉 2 skills installed successfully on 2 platforms!
+```
+
+### Updating Skills
+
+```bash
+$ npx cli-ai-skills list
+
+📦 CLI AI Skills
+
+✅ prompt-engineer v1.0.0 (installed)
+⚠️  skill-creator v1.0.0 (v1.1.0 available)
+⬜ youtube-summarizer v1.0.0
+
+$ npx cli-ai-skills update skill-creator
+
+🔄 Updating skill-creator v1.0.0 → v1.1.0...
+✅ Updated successfully
+
+🎉 skill-creator updated to v1.1.0!
+```
+
+## 🔧 Global vs Local Installation
+
+### Global Installation (Default)
+
+```bash
+npx cli-ai-skills install --global
+```
+
+- Skills available in **all projects**
+- Installed in `~/.copilot/skills/` and `~/.claude/skills/`
+- Uses **symlinks** (auto-updates on `git pull`)
+
+### Local Installation
+
+```bash
+npx cli-ai-skills install --local
+```
+
+- Skills available **only in current repository**
+- Installed in `.github/skills/` and `.claude/skills/`
+- Uses **copy** (commit to share with team)
+
+## 🐛 Troubleshooting
+
+### Platforms Not Detected
+
+```bash
+npx cli-ai-skills doctor
+```
+
+This will diagnose:
+- Missing GitHub Copilot CLI or Claude Code
+- Permission issues
+- Network connectivity problems
+
+### Skills Not Working After Installation
+
+1. **Open a new terminal** (environment needs to refresh)
+2. Verify installation: `npx cli-ai-skills list`
+3. Check permissions: `npx cli-ai-skills doctor`
+
+### Update Fails
+
+If update fails, try reinstalling:
+
+```bash
+npx cli-ai-skills uninstall <skill>
+npx cli-ai-skills install <skill>
+```
+
+## 📝 Requirements
+
+- **Node.js** >= 14.0.0
+- **GitHub Copilot CLI** (optional) - [Install](https://docs.github.com/copilot/cli)
+- **Claude Code** (optional) - [Install](https://claude.ai/code)
+
+At least one AI platform is required.
+
+## 🤝 Contributing
+
+Found a bug or have a feature request? [Open an issue](https://github.com/ericgandrade/cli-ai-skills/issues).
+
+## 📄 License
+
+MIT © Eric Andrade
+
+## 🔗 Links
+
+- **Repository**: https://github.com/ericgandrade/cli-ai-skills
+- **Skills Documentation**: https://github.com/ericgandrade/cli-ai-skills#readme
+- **GitHub Copilot**: https://docs.github.com/copilot/cli
+- **Claude Code**: https://claude.ai/code
+
+---
+
+**Made with ❤️ for AI-assisted development**

package/bin/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const chalk = require('chalk');
+const packageJson = require('../package.json');
+
+const program = new Command();
+
+program
+  .name('cli-ai-skills')
+  .description(chalk.cyan('🤖 Install AI skills for GitHub Copilot CLI and Claude Code'))
+  .version(packageJson.version, '-v, --version', 'Output the current version');
+
+// Command: install
+program
+  .command('install [skills...]')
+  .description('Install AI skills')
+  .option('-a, --all', 'Install all available skills')
+  .option('-g, --global', 'Install globally (default)')
+  .option('-l, --local', 'Install in current repository')
+  .option('--copilot', 'Install only for GitHub Copilot CLI')
+  .option('--claude', 'Install only for Claude Code')
+  .option('-y, --yes', 'Skip confirmations')
+  .option('--copy', 'Copy files instead of symlinks')
+  .action(async (skillNames, options) => {
+    try {
+      const installCommand = require('../lib/commands/install');
+      await installCommand(skillNames, options);
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Command: uninstall
+program
+  .command('uninstall <skill>')
+  .description('Uninstall a skill')
+  .option('-g, --global', 'Uninstall from global location')
+  .option('-l, --local', 'Uninstall from local repository')
+  .action(async (skill, options) => {
+    try {
+      const uninstallCommand = require('../lib/commands/uninstall');
+      await uninstallCommand(skill, options);
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Command: list
+program
+  .command('list')
+  .alias('ls')
+  .description('List available and installed skills')
+  .option('-i, --installed', 'Show only installed skills')
+  .option('-a, --available', 'Show only available skills')
+  .action(async (options) => {
+    try {
+      const listCommand = require('../lib/commands/list');
+      await listCommand(options);
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Command: update
+program
+  .command('update [skills...]')
+  .description('Update installed skills')
+  .option('-a, --all', 'Update all skills')
+  .option('-y, --yes', 'Skip confirmations')
+  .action(async (skillNames, options) => {
+    try {
+      const updateCommand = require('../lib/commands/update');
+      await updateCommand(skillNames, options);
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Command: doctor
+program
+  .command('doctor')
+  .description('Diagnose installation issues')
+  .action(async () => {
+    try {
+      const doctorCommand = require('../lib/commands/doctor');
+      await doctorCommand();
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  });
+
+// Error handling
+program.configureOutput({
+  writeErr: (str) => process.stderr.write(chalk.red(str))
+});
+
+program.parse(process.argv);
+
+// Show help if no command
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}

package/lib/commands/doctor.js

@@ -0,0 +1,119 @@
+const chalk = require('chalk');
+const PlatformDetector = require('../core/detector');
+const { execSync } = require('child_process');
+
+async function doctorCommand() {
+  console.log(chalk.cyan.bold('\n🔍 CLI AI Skills Doctor\n'));
+  console.log('Running diagnostics...\n');
+
+  const detector = new PlatformDetector();
+  let issues = 0;
+  let warnings = 0;
+
+  console.log(chalk.cyan('━'.repeat(60)));
+  console.log(chalk.bold('\nSystem Environment:\n'));
+
+  // Check Node.js version
+  console.log(chalk.bold('Node.js:'));
+  const nodeVersion = process.version;
+  const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0]);
+  if (nodeMajor >= 14) {
+    console.log(chalk.green(`  ✅ ${nodeVersion}`));
+  } else {
+    console.log(chalk.red(`  ❌ ${nodeVersion} (require >= 14.0.0)`));
+    console.log(chalk.dim(`     Update Node.js: https://nodejs.org/`));
+    issues++;
+  }
+
+  // Check OS
+  console.log(chalk.bold('\nOperating System:'));
+  const platform = process.platform;
+  const osMap = {
+    'darwin': 'macOS',
+    'linux': 'Linux',
+    'win32': 'Windows'
+  };
+  console.log(chalk.green(`  ✅ ${osMap[platform] || platform}`));
+
+  console.log(chalk.cyan('\n' + '━'.repeat(60)));
+  console.log(chalk.bold('\nAI Platforms:\n'));
+
+  // Check GitHub Copilot
+  console.log(chalk.bold('GitHub Copilot CLI:'));
+  const copilotInfo = await detector.detectCopilot();
+  if (copilotInfo.cliInstalled) {
+    console.log(chalk.green(`  ✅ Installed (${copilotInfo.version})`));
+    console.log(chalk.dim(`     Skills directory: ${copilotInfo.globalPath}`));
+    
+    const writable = await detector.isWritable(copilotInfo.globalPath);
+    if (writable) {
+      console.log(chalk.green(`     ✅ Directory writable`));
+    } else {
+      console.log(chalk.yellow(`     ⚠️  Directory not writable`));
+      warnings++;
+    }
+  } else if (copilotInfo.installed) {
+    console.log(chalk.yellow('  ⚠️  Directory exists but CLI not installed'));
+    console.log(chalk.dim(`     Install: https://docs.github.com/copilot/cli`));
+    warnings++;
+  } else {
+    console.log(chalk.yellow('  ⚠️  Not installed'));
+    console.log(chalk.dim(`     Install: https://docs.github.com/copilot/cli`));
+  }
+
+  // Check Claude Code
+  console.log(chalk.bold('\nClaude Code:'));
+  const claudeInfo = await detector.detectClaude();
+  if (claudeInfo.installed) {
+    console.log(chalk.green('  ✅ Detected'));
+    console.log(chalk.dim(`     Skills directory: ${claudeInfo.globalPath}`));
+    
+    const writable = await detector.isWritable(claudeInfo.globalPath);
+    if (writable) {
+      console.log(chalk.green(`     ✅ Directory writable`));
+    } else {
+      console.log(chalk.yellow(`     ⚠️  Directory not writable`));
+      warnings++;
+    }
+  } else {
+    console.log(chalk.yellow('  ⚠️  Not detected'));
+    console.log(chalk.dim(`     Install: https://claude.ai/code`));
+  }
+
+  console.log(chalk.cyan('\n' + '━'.repeat(60)));
+  console.log(chalk.bold('\nNetwork Connectivity:\n'));
+
+  // Check GitHub access
+  console.log(chalk.bold('GitHub API:'));
+  try {
+    execSync('ping -c 1 api.github.com', { stdio: 'ignore' });
+    console.log(chalk.green('  ✅ Reachable (https://api.github.com)'));
+  } catch (error) {
+    console.log(chalk.red('  ❌ Cannot reach GitHub API'));
+    console.log(chalk.dim('     Check your internet connection'));
+    issues++;
+  }
+
+  console.log(chalk.cyan('\n' + '━'.repeat(60)));
+
+  // Summary
+  console.log();
+  if (issues === 0 && warnings === 0) {
+    console.log(chalk.green.bold('✨ Everything looks good!\n'));
+  } else if (issues === 0) {
+    console.log(chalk.yellow.bold(`⚠️  Found ${warnings} warning(s)\n`));
+  } else {
+    console.log(chalk.red.bold(`❌ Found ${issues} error(s) and ${warnings} warning(s)\n`));
+  }
+
+  console.log(chalk.cyan('📊 Diagnostics Summary:'));
+  const checks = 3 + (copilotInfo.cliInstalled ? 1 : 0) + (claudeInfo.installed ? 1 : 0);
+  const passed = checks - issues - warnings;
+  console.log(chalk.dim(`  ✅ ${passed} checks passed`));
+  if (warnings > 0) console.log(chalk.dim(`  ⚠️  ${warnings} warnings`));
+  if (issues > 0) console.log(chalk.dim(`  ❌ ${issues} errors`));
+
+  console.log();
+}
+
+module.exports = doctorCommand;