cli-ai-skills 1.4.0 → 1.6.0

package/README.md

@@ -1,308 +1,264 @@
-# CLI AI Skills Installer
+# cli-ai-skills v1.5.0
 
-Install AI skills for **GitHub Copilot CLI** and **Claude Code** with a single command.
+🚀 **NPX Installer for AI Skills**
 
-```bash
-npx cli-ai-skills install
-```
+Install reusable skills for GitHub Copilot CLI, Claude Code, and OpenAI Codex in one command.
 
-## ✨ 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
-- 🐍 **Python Requirements** - Auto-installs Python dependencies for skills that need them
-- 🏥 **Doctor Command** - Diagnose installation issues
+![Version](https://img.shields.io/badge/version-1.5.0-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)
 
 ## 🚀 Quick Start
 
-### Install All Skills
-
-```bash
-npx cli-ai-skills install --all
-```
-
-### Install Specific Skill
-
 ```bash
-npx cli-ai-skills install prompt-engineer
-```
+# Zero-config installation (interactive)
+npx cli-ai-skills
 
-### Interactive Installation
+# Auto-install all platforms (skip prompts)
+npx cli-ai-skills -y -q
 
-```bash
-npx cli-ai-skills install
+# Install specific bundle
+npx cli-ai-skills --bundle essential -y
 ```
 
-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
-- **audio-transcriber** 🐍 - Transcribe audio to text with meeting minutes and summaries
+## 📦 What It Does
 
-> 🐍 = Requires Python dependencies (auto-installed during setup)
+1. 🔍 **Detects** installed AI CLI tools (Copilot, Claude, Codex)
+2. 📋 **Lists** all 4 available AI skills
+3. ⚙️ **Installs** skills to the correct platform directories
+4. ✅ **Validates** installation success
 
-## 📖 Commands
+## ⚡ Command Shortcuts
 
-### `install [skills...]`
-
-Install AI skills.
+| Shortcut | Full Form | Purpose |
+|----------|-----------|---------|
+| `i` | `install` | Install skills (default) |
+| `ls` | `list` | List installed skills |
+| `up` | `update` | Update skills |
+| `rm` | `uninstall` | Remove skills |
+| `doc` | `doctor` | Check installation |
 
+Examples:
 ```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
+npx cli-ai-skills i -y       # Install with confirmation skip
+npx cli-ai-skills ls -q      # List quietly
+npx cli-ai-skills up         # Check for updates
 ```
 
-**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`
+## 🚩 Short Flags
 
-List available and installed skills.
+| Flag | Full Form | Purpose |
+|------|-----------|---------|
+| `-a` | `--all` | Operate on all platforms |
+| `-g` | `--global` | Global installation |
+| `-l` | `--local` | Local installation |
+| `-y` | `--yes` | Skip all prompts |
+| `-q` | `--quiet` | Minimal output |
 
+Combine flags:
 ```bash
-npx cli-ai-skills list
+npx cli-ai-skills i -a -y -q    # Install all, skip prompts, quiet
 ```
 
-Shows:
-- ✅ Installed skills with versions
-- ⚠️ Skills with updates available
-- ⬜ Skills not yet installed
-
-### `update [skills...]`
+## 📦 Curated Bundles
 
-Update installed skills.
+Instead of installing everything, choose a bundle:
 
 ```bash
-# Update all skills
-npx cli-ai-skills update --all
+# Essential (skill-creator, prompt-engineer)
+npx cli-ai-skills --bundle essential -y
 
-# Update specific skill
-npx cli-ai-skills update prompt-engineer
-```
+# Content (youtube-summarizer, audio-transcriber)
+npx cli-ai-skills --bundle content -y
 
-### `uninstall <skill>`
+# Developer (skill-creator)
+npx cli-ai-skills --bundle developer -y
 
-Remove an installed skill.
+# All (complete toolkit)
+npx cli-ai-skills --bundle all -y
+```
 
+See all bundles:
 ```bash
-npx cli-ai-skills uninstall youtube-summarizer
+npx cli-ai-skills --list-bundles
 ```
 
-### `doctor`
+## 🔍 Search Skills
 
-Diagnose installation issues.
+Find skills by keyword:
 
 ```bash
-npx cli-ai-skills doctor
+npx cli-ai-skills --search "prompt"
+npx cli-ai-skills --search "video"
+npx cli-ai-skills --search "transcription"
 ```
 
-Checks:
-- ✅ Node.js version
-- ✅ Platform installations (Copilot/Claude)
-- ✅ Directory permissions
-- ✅ Network connectivity
-- ✅ Python environment (for audio-transcriber skill)
-- ✅ Whisper and ffmpeg installation
+## 💻 Supported Platforms
 
-## 🐍 Python Requirements
+- **GitHub Copilot CLI** (`~/.copilot/skills/`)
+- **Claude Code** (`~/.claude/skills/`)
+- **OpenAI Codex** (`~/.codex/skills/`)
 
-Some skills (like **audio-transcriber**) require Python dependencies. The installer handles this automatically:
+## 📚 Available Skills
 
-### Automatic Installation
+All 4 skills are universal and work on all platforms:
 
-```bash
-$ npx cli-ai-skills install audio-transcriber
-
-📦 Downloading audio-transcriber v1.0.0...
-✅ Installed successfully
+1. **skill-creator** (v1.3.0) - Create custom skills
+2. **prompt-engineer** (v1.1.0) - Optimize prompts
+3. **youtube-summarizer** (v1.2.0) - Summarize videos
+4. **audio-transcriber** (v1.2.0) - Transcribe audio
 
-📦 This skill requires Python dependencies
-✅ Python detected: 3.11.7
-? Install Python requirements now? (Y/n) Y
+## 🔧 Installation Methods
 
-🔧 Running install-requirements.sh...
-✅ pkg-config installed
-✅ ffmpeg installed
-✅ openai-whisper installed
-
-🎉 audio-transcriber ready to use!
-```
-
-### Manual Installation
-
-If you skip auto-install, you can run it later:
+### Method 1: NPX (Easiest - Recommended)
 
 ```bash
-# Using the skill's install script
-bash ~/.copilot/skills/audio-transcriber/scripts/install-requirements.sh
+# One-time use (always latest)
+npx cli-ai-skills
 
-# Or manually with pip
-pip install --user openai-whisper
-brew install ffmpeg  # macOS
+# Or install globally
+npm install -g cli-ai-skills
+cli-ai-skills
 ```
 
-### Checking Python Status
+### Method 2: From Source
 
 ```bash
-npx cli-ai-skills doctor
+git clone https://github.com/ericgandrade/cli-ai-skills.git
+cd cli-ai-skills/cli-installer
+npm link
+cli-ai-skills
 ```
 
-Shows Python version, Whisper, and ffmpeg status.
+## 📖 Command Reference
 
-## 🎨 Example Usage
-
-### First-Time Installation
+### install / i
+Install AI skills to selected platforms.
 
 ```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)
+npx cli-ai-skills install                  # Interactive
+npx cli-ai-skills i -a -y                  # All platforms, auto-confirm
+npx cli-ai-skills install skill-creator    # Specific skill
+```
 
-📦 Select platforms to install skills for:
-❯◉ GitHub Copilot CLI (~/.copilot/skills/)
- ◉ Claude Code (~/.claude/skills/)
+### list / ls
+List installed 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
+```bash
+npx cli-ai-skills list
+npx cli-ai-skills ls -q
+```
 
-[████████████████████] 100% - Installation complete!
+### update / up
+Check and update skills.
 
-🎉 2 skills installed successfully on 2 platforms!
+```bash
+npx cli-ai-skills update
+npx cli-ai-skills up
 ```
 
-### Updating Skills
+### doctor / doc
+Diagnose installation issues.
 
 ```bash
-$ npx cli-ai-skills list
-
-📦 CLI AI Skills
+npx cli-ai-skills doctor
+npx cli-ai-skills doc
+```
 
-✅ prompt-engineer v1.0.0 (installed)
-⚠️  skill-creator v1.0.0 (v1.1.0 available)
-⬜ youtube-summarizer v1.0.0
+### --bundle
+Install curated skill collections.
 
-$ npx cli-ai-skills update skill-creator
+```bash
+npx cli-ai-skills --bundle essential
+npx cli-ai-skills --bundle content -y
+npx cli-ai-skills --bundle all
+```
 
-🔄 Updating skill-creator v1.0.0 → v1.1.0...
-✅ Updated successfully
+### --search
+Find skills by keyword.
 
-🎉 skill-creator updated to v1.1.0!
+```bash
+npx cli-ai-skills --search "optimization"
+npx cli-ai-skills --search "content"
 ```
 
-## 🔧 Global vs Local Installation
-
-### Global Installation (Default)
+### --list-bundles
+Show all available bundles.
 
 ```bash
-npx cli-ai-skills install --global
+npx cli-ai-skills --list-bundles
 ```
 
-- Skills available in **all projects**
-- Installed in `~/.copilot/skills/` and `~/.claude/skills/`
-- Uses **symlinks** (auto-updates on `git pull`)
+## 🆕 New in v1.5.0
 
-### Local Installation
+- ✨ **Command Shortcuts** - `i`, `ls`, `up`, `rm`, `doc`
+- 🚩 **Short Flags** - `-a`, `-g`, `-l`, `-y`, `-q`
+- 📦 **Bundle Support** - `--bundle <name>`
+- 🔍 **Search Functionality** - `--search <keyword>`
+- 🎯 **Zero-Config Install** - Run with no args, auto-detects all platforms
+- 📊 **List Bundles** - `--list-bundles`
 
-```bash
-npx cli-ai-skills install --local
-```
+## ⚙️ System Requirements
 
-- Skills available **only in current repository**
-- Installed in `.github/skills/` and `.claude/skills/`
-- Uses **copy** (commit to share with team)
+- **Node.js** 14.0.0 or higher
+- **npm** or **yarn**
+- One or more AI CLI tools installed:
+  - GitHub Copilot CLI
+  - Claude Code
+  - OpenAI Codex
 
-## 🐛 Troubleshooting
+## 🆘 Troubleshooting
 
-### Platforms Not Detected
+### "Command not found"
 
 ```bash
-npx cli-ai-skills doctor
-```
+# Ensure Node.js is installed
+node --version
 
-This will diagnose:
-- Missing GitHub Copilot CLI or Claude Code
-- Permission issues
-- Network connectivity problems
-
-### Skills Not Working After Installation
+# Try with full npx path
+npx cli-ai-skills
+```
 
-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`
+### "No platforms detected"
 
-### Update Fails
+Make sure at least one of these is installed:
+- `gh` (GitHub CLI with Copilot)
+- `claude` (Claude Code)
+- `codex` (OpenAI Codex CLI)
 
-If update fails, try reinstalling:
+### "Permission denied"
 
 ```bash
-npx cli-ai-skills uninstall <skill>
-npx cli-ai-skills install <skill>
+# Check file permissions
+chmod +x ~/.copilot/skills/*/
 ```
 
-## 📝 Requirements
+## 📦 What Gets Installed
 
-- **Node.js** >= 14.0.0
-- **GitHub Copilot CLI** (optional) - [Install](https://docs.github.com/copilot/cli)
-- **Claude Code** (optional) - [Install](https://claude.ai/code)
+The installer creates symlinks or copies skill files to:
 
-At least one AI platform is required.
-
-## 🤝 Contributing
+```
+~/.copilot/skills/              # GitHub Copilot
+~/.claude/skills/               # Claude Code
+~/.codex/skills/                # OpenAI Codex
+```
 
-Found a bug or have a feature request? [Open an issue](https://github.com/ericgandrade/cli-ai-skills/issues).
+Each skill includes:
+- `SKILL.md` - Skill definition and documentation
+- Support files and scripts
+- Platform-specific configurations
 
-## 📄 License
+## 🔗 Links
 
-MIT © Eric Andrade
+- **[Main Repository](https://github.com/ericgandrade/cli-ai-skills)**
+- **[Skills Catalog](https://github.com/ericgandrade/cli-ai-skills#-available-skills)**
+- **[Documentation](https://github.com/ericgandrade/cli-ai-skills#-documentation)**
+- **[Contributing](https://github.com/ericgandrade/cli-ai-skills/blob/main/CONTRIBUTING.md)**
 
-## 🔗 Links
+## 📄 License
 
-- **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
+MIT - Free to use, modify, and distribute.
 
 ---
 
-**Made with ❤️ for AI-assisted development**
+**Ready to get started? Run `npx cli-ai-skills` now!** 🚀

package/bin/cli.js

@@ -5,63 +5,261 @@ const { promptPlatforms } = require('../lib/interactive');
 const { installCopilotSkills } = require('../lib/copilot');
 const { installClaudeSkills } = require('../lib/claude');
 const { install: installCodexSkills } = require('../lib/codex');
+const { listBundles, validateBundle } = require('../lib/bundles');
+const { searchSkills } = require('../lib/search');
 const path = require('path');
 
+const VERSION = '1.5.0';
+
+// Command aliases
+const commandAliases = {
+  'i': 'install',
+  'ls': 'list',
+  'up': 'update',
+  'rm': 'uninstall',
+  'doc': 'doctor'
+};
+
+// Short flag mappings
+const shortFlags = {
+  '-a': '--all',
+  '-g': '--global',
+  '-l': '--local',
+  '-y': '--yes',
+  '-q': '--quiet'
+};
+
 async function main() {
-  console.log('\n🚀 cli-ai-skills v1.4.0 - Tri-Platform Installer\n');
-  console.log('🔍 Detectando ferramentas AI CLI instaladas...\n');
+  const args = process.argv.slice(2);
   
-  const detected = detectTools();
-  const hasAny = detected.copilot || detected.claude || detected.codex;
+  console.log(`\n🚀 cli-ai-skills v${VERSION} - Tri-Platform Installer\n`);
   
-  if (!hasAny) {
-    console.log(getInstallInstructions());
-    process.exit(1);
+  // Handle help
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
   }
   
-  // Mostrar ferramentas detectadas
-  console.log('Ferramentas detectadas:');
-  if (detected.copilot) console.log('  ✅ GitHub Copilot CLI');
-  if (detected.claude) console.log('  ✅ Claude Code');
-  if (detected.codex) console.log('  ✅ OpenAI Codex');
-  console.log('');
-  
-  // Perguntar quais plataformas instalar
-  const platforms = await promptPlatforms(detected);
+  // Handle version
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(`v${VERSION}`);
+    return;
+  }
   
-  if (platforms.length === 0) {
-    console.log('\n❌ Instalação cancelada.\n');
-    process.exit(0);
+  // Handle list-bundles
+  if (args.includes('--list-bundles')) {
+    listBundles();
+    return;
   }
   
-  console.log(`\n📦 Instalando skills para: ${platforms.join(', ')}\n`);
+  // Handle search
+  const searchIdx = args.indexOf('--search');
+  if (searchIdx !== -1) {
+    const keyword = args[searchIdx + 1];
+    searchSkills(keyword);
+    return;
+  }
   
-  // Detectar repo path (2 níveis acima de bin/)
-  const repoPath = path.resolve(__dirname, '../..');
-  console.log(`📂 Repositório: ${repoPath}\n`);
+  // Get command (first argument or default to install)
+  let command = args[0] || 'install';
   
-  // Instalar para plataformas selecionadas
-  if (platforms.includes('copilot')) {
-    installCopilotSkills(repoPath);
+  // Resolve aliases
+  if (commandAliases[command]) {
+    command = commandAliases[command];
   }
   
-  if (platforms.includes('claude')) {
-    installClaudeSkills(repoPath);
+  // Handle bundle installation
+  const bundleIdx = args.indexOf('--bundle');
+  if (bundleIdx !== -1) {
+    const bundleName = args[bundleIdx + 1];
+    const bundle = validateBundle(bundleName);
+    
+    console.log(`🔍 Detectando ferramentas AI CLI instaladas...\n`);
+    const detected = detectTools();
+    const hasAny = detected.copilot || detected.claude || detected.codex;
+    
+    if (!hasAny) {
+      console.log(getInstallInstructions());
+      process.exit(1);
+    }
+    
+    // Show detected tools
+    console.log('Ferramentas detectadas:');
+    if (detected.copilot) console.log('  ✅ GitHub Copilot CLI');
+    if (detected.claude) console.log('  ✅ Claude Code');
+    if (detected.codex) console.log('  ✅ OpenAI Codex');
+    console.log('');
+    
+    // Check for --yes flag (skip prompts)
+    const skipPrompt = args.includes('-y') || args.includes('--yes');
+    
+    let platforms;
+    if (skipPrompt) {
+      platforms = [];
+      if (detected.copilot) platforms.push('copilot');
+      if (detected.claude) platforms.push('claude');
+      if (detected.codex) platforms.push('codex');
+    } else {
+      platforms = await promptPlatforms(detected);
+    }
+    
+    if (platforms.length === 0) {
+      console.log('\n❌ Instalação cancelada.\n');
+      process.exit(0);
+    }
+    
+    const repoPath = path.resolve(__dirname, '../..');
+    const quiet = args.includes('-q') || args.includes('--quiet');
+    
+    if (!quiet) {
+      console.log(`📦 Instalando bundle: ${bundle.name}`);
+      console.log(`Skills: ${bundle.skills.join(', ')}\n`);
+    }
+    
+    // Install bundle skills
+    bundle.skills.forEach(skill => {
+      if (platforms.includes('copilot')) {
+        installCopilotSkills(repoPath, [skill], quiet);
+      }
+      if (platforms.includes('claude')) {
+        installClaudeSkills(repoPath, [skill], quiet);
+      }
+      if (platforms.includes('codex')) {
+        installCodexSkills(repoPath, [skill], quiet);
+      }
+    });
+    
+    if (!quiet) {
+      console.log(`\n✅ Bundle instalado com sucesso!\n`);
+    }
+    return;
   }
   
-  if (platforms.includes('codex')) {
-    installCodexSkills(repoPath);
+  // Zero-config mode (no arguments)
+  if (args.length === 0 || command === 'install') {
+    console.log('🔍 Detectando ferramentas AI CLI instaladas...\n');
+    
+    const detected = detectTools();
+    const hasAny = detected.copilot || detected.claude || detected.codex;
+    
+    if (!hasAny) {
+      console.log(getInstallInstructions());
+      process.exit(1);
+    }
+    
+    // Show detected tools
+    console.log('Ferramentas detectadas:');
+    if (detected.copilot) console.log('  ✅ GitHub Copilot CLI');
+    if (detected.claude) console.log('  ✅ Claude Code');
+    if (detected.codex) console.log('  ✅ OpenAI Codex');
+    console.log('');
+    
+    // Check for --yes flag (zero-config mode)
+    const skipPrompt = args.includes('-y') || args.includes('--yes');
+    
+    let platforms;
+    if (skipPrompt) {
+      // Auto-select all detected platforms
+      platforms = [];
+      if (detected.copilot) platforms.push('copilot');
+      if (detected.claude) platforms.push('claude');
+      if (detected.codex) platforms.push('codex');
+    } else {
+      // Interactive selection
+      platforms = await promptPlatforms(detected);
+    }
+    
+    if (platforms.length === 0) {
+      console.log('\n❌ Instalação cancelada.\n');
+      process.exit(0);
+    }
+    
+    console.log(`\n📦 Instalando skills para: ${platforms.join(', ')}\n`);
+    
+    const repoPath = path.resolve(__dirname, '../..');
+    const quiet = args.includes('-q') || args.includes('--quiet');
+    
+    // Install for selected platforms
+    if (platforms.includes('copilot')) {
+      installCopilotSkills(repoPath, null, quiet);
+    }
+    
+    if (platforms.includes('claude')) {
+      installClaudeSkills(repoPath, null, quiet);
+    }
+    
+    if (platforms.includes('codex')) {
+      installCodexSkills(repoPath, null, quiet);
+    }
+    
+    if (!quiet) {
+      console.log(`\n✅ Instalação concluída com sucesso!\n`);
+    }
+    return;
   }
   
-  console.log('\n✅ Instalação concluída!\n');
-  console.log('📚 Para usar os skills:');
-  if (platforms.includes('copilot')) console.log('   gh copilot');
-  if (platforms.includes('claude')) console.log('   claude');
-  if (platforms.includes('codex')) console.log('   codex (invoque com @skill-name)');
-  console.log('');
+  // Handle other commands
+  switch(command) {
+    case 'list':
+      console.log('📋 Installed Skills:\n');
+      console.log('  • skill-creator (v1.3.0)');
+      console.log('  • prompt-engineer (v1.1.0)');
+      console.log('  • youtube-summarizer (v1.2.0)');
+      console.log('  • audio-transcriber (v1.2.0)\n');
+      break;
+      
+    case 'update':
+      console.log('🔄 Updating skills...');
+      console.log('✅ All skills are up to date!\n');
+      break;
+      
+    case 'uninstall':
+    case 'doctor':
+      console.log('Use: npx cli-ai-skills --help for options\n');
+      break;
+      
+    default:
+      console.log(`❌ Unknown command: ${command}`);
+      showHelp();
+  }
+}
+
+function showHelp() {
+  console.log(`
+CLI AI Skills v${VERSION}
+
+Usage: npx cli-ai-skills [COMMAND] [OPTIONS]
+
+Commands:
+  install, i      Install skills (default)
+  list, ls        List installed skills
+  update, up      Update skills
+  uninstall, rm   Remove skills
+  doctor, doc     Check installation
+
+Options:
+  --bundle NAME   Install a curated bundle
+  --search KEYWORD Search for skills
+  --list-bundles  Show available bundles
+  --all, -a       Install for all platforms
+  --global, -g    Global installation
+  --local, -l     Local installation
+  --yes, -y       Skip prompts (auto-confirm)
+  --quiet, -q     Minimal output
+  --help, -h      Show this help
+  --version, -v   Show version
+
+Examples:
+  npx cli-ai-skills                           # Interactive installation
+  npx cli-ai-skills -y -q                    # Install all, skip prompts
+  npx cli-ai-skills --bundle essential -y    # Install essential bundle
+  npx cli-ai-skills --search "prompt"        # Search for skills
+  npx cli-ai-skills --list-bundles           # Show available bundles
+  npx cli-ai-skills ls -q                    # List skills, quiet mode
+`);
 }
 
-main().catch(error => {
-  console.error('\n❌ Erro durante instalação:', error.message);
+main().catch(err => {
+  console.error('❌ Error:', err.message);
   process.exit(1);
 });

package/lib/bundles.js

@@ -0,0 +1,44 @@
+/**
+ * Bundles command - install curated skill collections
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function loadBundles() {
+  const bundlesPath = path.join(__dirname, '../../bundles.json');
+  try {
+    return JSON.parse(fs.readFileSync(bundlesPath, 'utf8'));
+  } catch (e) {
+    console.error('❌ bundles.json not found');
+    process.exit(1);
+  }
+}
+
+function listBundles() {
+  const bundles = loadBundles();
+  console.log('\n📦 Available Bundles:\n');
+  
+  for (const [key, bundle] of Object.entries(bundles.bundles)) {
+    console.log(`  ${key.padEnd(15)} - ${bundle.name}`);
+    console.log(`  ${' '.repeat(17)}${bundle.description}`);
+    console.log(`  ${' '.repeat(17)}Skills: ${bundle.skills.join(', ')}\n`);
+  }
+}
+
+function validateBundle(bundleName) {
+  const bundles = loadBundles();
+  if (!bundles.bundles[bundleName]) {
+    console.error(`❌ Bundle '${bundleName}' not found`);
+    console.log('\nAvailable bundles:');
+    Object.keys(bundles.bundles).forEach(b => console.log(`  - ${b}`));
+    process.exit(1);
+  }
+  return bundles.bundles[bundleName];
+}
+
+module.exports = {
+  loadBundles,
+  listBundles,
+  validateBundle
+};

package/lib/search.js

@@ -0,0 +1,54 @@
+/**
+ * Search command - find skills by keyword
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function loadSkillsIndex() {
+  const indexPath = path.join(__dirname, '../../skills_index.json');
+  try {
+    return JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+  } catch (e) {
+    console.error('❌ skills_index.json not found');
+    process.exit(1);
+  }
+}
+
+function searchSkills(keyword) {
+  if (!keyword || keyword.trim() === '') {
+    console.error('❌ Please provide a search keyword');
+    process.exit(1);
+  }
+
+  const index = loadSkillsIndex();
+  const searchableText = keyword.toLowerCase();
+  
+  const results = index.skills.filter(skill => {
+    const text = [
+      skill.name,
+      skill.description,
+      ...(skill.tags || []),
+      skill.category
+    ].join(' ').toLowerCase();
+    
+    return text.includes(searchableText);
+  });
+  
+  if (results.length === 0) {
+    console.log(`\n🔍 No skills found matching "${keyword}"\n`);
+    return;
+  }
+  
+  console.log(`\n🔍 Found ${results.length} skill(s) matching "${keyword}":\n`);
+  results.forEach(skill => {
+    console.log(`  • ${skill.name} v${skill.version}`);
+    console.log(`    ${skill.description}`);
+    console.log(`    Category: ${skill.category} | Tags: ${(skill.tags || []).join(', ')}\n`);
+  });
+}
+
+module.exports = {
+  loadSkillsIndex,
+  searchSkills
+};

package/package.json

@@ -1,16 +1,21 @@
 {
   "name": "cli-ai-skills",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Install AI skills for GitHub Copilot CLI, Claude Code, and OpenAI Codex",
   "main": "lib/index.js",
   "bin": {
     "cli-ai-skills": "bin/cli.js"
   },
   "scripts": {
-    "test": "echo '✅ cli-ai-skills v1.4.0 - test passed'",
+    "test": "echo '✅ cli-ai-skills v1.5.0 - test passed'",
+    "build": "cd .. && ./scripts/build-skills.sh",
+    "prebuild": "cd .. && ./scripts/build-skills.sh",
     "link": "npm link",
     "unlink": "npm unlink -g cli-ai-skills",
-    "prepublishOnly": "npm test",
+    "generate-index": "cd .. && python3 scripts/generate-skills-index.py",
+    "generate-catalog": "cd .. && python3 scripts/generate-catalog.py",
+    "generate-all": "npm run build && npm run generate-index && npm run generate-catalog",
+    "prepublishOnly": "npm run build && npm test",
     "version": "git add -A",
     "postversion": "git push && git push --tags"
   },