@hivehub/rulebook 1.2.0 → 2.0.0

package/README.md

@@ -48,7 +48,25 @@ npx @hivehub/rulebook@latest update
 
 ## What's New
 
-### v1.1.5 (Latest)
+### v2.0.0 (Latest)
+
+- 🧩 **Skills System**: New modular skills architecture for AI-assisted development
+  - Skills are YAML-frontmatter Markdown files with enable/disable functionality
+  - 10 skill categories: languages, frameworks, modules, services, workflows, ides, core, cli, git, hooks
+  - Auto-detection of skills based on project configuration
+  - CLI commands: `rulebook skill list|add|remove|show|search`
+  - MCP functions: `rulebook_skill_list|show|enable|disable|search|validate`
+- 🤖 **AI CLI Configuration Files**: Auto-generated files for AI CLI tools
+  - `CLAUDE.md` - Claude Code CLI configuration
+  - `CODEX.md` - OpenAI Codex CLI configuration
+  - `GEMINI.md` - Google Gemini CLI configuration
+  - `gemini-extension.json` - Gemini CLI extension manifest
+- 🔌 **Claude Code Plugin**: `marketplace.json` + `.claude-plugin/` structure for marketplace distribution
+  - `marketplace.json` - Marketplace manifest for plugin discovery
+  - Plugin manifest, MCP configuration, slash commands, and skills
+- 🪟 **Windows Test Suite Fix**: Tests no longer hang on Windows (705 tests passing, 11x faster)
+
+### v1.1.5
 
 - 🗄️ **Service Integration Templates**: Added comprehensive service integration templates
   - 20 service templates: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite, MongoDB, Cassandra, DynamoDB, Redis, Memcached, Elasticsearch, Neo4j, InfluxDB, RabbitMQ, Kafka, S3, Azure Blob, GCS, MinIO
@@ -237,6 +255,15 @@ npx @hivehub/rulebook@latest task archive <task-id>    # Archive completed task
 npx @hivehub/rulebook@latest task archive --skip-validation <task-id>  # Archive without validation
 npx @hivehub/rulebook@latest tasks [options]           # Legacy command (DEPRECATED - use 'task' commands)
 
+# Skills Management (v2.0)
+npx @hivehub/rulebook@latest skill list                 # List all available skills
+npx @hivehub/rulebook@latest skill list --category languages  # Filter by category
+npx @hivehub/rulebook@latest skill list --enabled       # Show only enabled skills
+npx @hivehub/rulebook@latest skill add <skill-id>       # Enable a skill
+npx @hivehub/rulebook@latest skill remove <skill-id>    # Disable a skill
+npx @hivehub/rulebook@latest skill show <skill-id>      # Show skill details
+npx @hivehub/rulebook@latest skill search <query>       # Search for skills
+
 # Configuration
 npx @hivehub/rulebook@latest config --show     # Show current config
 npx @hivehub/rulebook@latest config --set key=value  # Set config value
@@ -328,6 +355,94 @@ This command:
 
 **Total: 7 MCP functions** for complete task lifecycle management.
 
+**Skills MCP Functions (v2.0):**
+
+- `rulebook_skill_list` - List available skills with optional category filter
+- `rulebook_skill_show` - Show detailed skill information
+- `rulebook_skill_enable` - Enable a skill for the project
+- `rulebook_skill_disable` - Disable a skill
+- `rulebook_skill_search` - Search skills by name, description, or tags
+- `rulebook_skill_validate` - Validate skills configuration
+
+**Total: 13 MCP functions** (7 task + 6 skills).
+
+## Skills System (v2.0)
+
+Rulebook v2.0 introduces a modular skills system for AI-assisted development. Skills are pluggable capabilities that can be enabled or disabled per project.
+
+### What are Skills?
+
+Skills are YAML-frontmatter Markdown files that define specific capabilities or rules for AI assistants. Each skill has:
+
+- **Metadata**: Name, description, version, category, tags, dependencies
+- **Content**: Markdown content with rules, patterns, and examples
+
+### Skill Categories
+
+Skills are organized into 10 categories:
+
+| Category | Description | Examples |
+|----------|-------------|----------|
+| `languages` | Language-specific rules | TypeScript, Rust, Python |
+| `frameworks` | Framework conventions | NestJS, React, Django |
+| `modules` | MCP module integration | Vectorizer, Context7 |
+| `services` | Service integration | PostgreSQL, Redis |
+| `workflows` | CI/CD patterns | GitHub Actions |
+| `ides` | IDE configuration | Cursor, VS Code |
+| `core` | Core rulebook standards | Quality gates |
+| `cli` | AI CLI configuration | Claude Code, Codex |
+| `git` | Git workflow rules | Branching, commits |
+| `hooks` | Git hooks configuration | Pre-commit, pre-push |
+
+### Using Skills
+
+```bash
+# List all available skills
+rulebook skill list
+
+# Filter by category
+rulebook skill list --category languages
+
+# Enable a skill
+rulebook skill add languages/typescript
+
+# Disable a skill
+rulebook skill remove languages/typescript
+
+# Show skill details
+rulebook skill show languages/typescript
+
+# Search for skills
+rulebook skill search "testing"
+```
+
+### Auto-Detection
+
+During `rulebook init` and `rulebook update`, skills are automatically detected and enabled based on your project's:
+
+- Detected languages (e.g., TypeScript → `languages/typescript`)
+- Detected frameworks (e.g., NestJS → `frameworks/nestjs`)
+- Detected modules (e.g., Vectorizer → `modules/vectorizer`)
+- Detected services (e.g., PostgreSQL → `services/postgresql`)
+
+### Creating Custom Skills
+
+Create a `SKILL.md` file in `templates/skills/<category>/<skill-name>/`:
+
+```markdown
+---
+name: My Custom Skill
+description: Description of what this skill does
+version: 1.0.0
+category: core
+tags: ["custom", "example"]
+---
+
+# My Custom Skill
+
+Add your rules and patterns here.
+```
+
 ## Service Integration Templates (20)
 
 Rulebook provides comprehensive integration templates for popular backend services, including databases, caches, message queues, and object storage.

package/dist/cli/commands.d.ts

@@ -1,5 +1,6 @@
 export declare function initCommand(options: {
     yes?: boolean;
+    quick?: boolean;
     minimal?: boolean;
     light?: boolean;
 }): Promise<void>;
@@ -54,4 +55,27 @@ export declare function updateCommand(options: {
     minimal?: boolean;
     light?: boolean;
 }): Promise<void>;
+/**
+ * List all available skills
+ */
+export declare function skillListCommand(options: {
+    category?: string;
+    enabled?: boolean;
+}): Promise<void>;
+/**
+ * Add (enable) a skill
+ */
+export declare function skillAddCommand(skillId: string): Promise<void>;
+/**
+ * Remove (disable) a skill
+ */
+export declare function skillRemoveCommand(skillId: string): Promise<void>;
+/**
+ * Show skill details
+ */
+export declare function skillShowCommand(skillId: string): Promise<void>;
+/**
+ * Search for skills
+ */
+export declare function skillSearchCommand(query: string): Promise<void>;
 //# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -1,10 +1,10 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import { detectProject } from '../core/detector.js';
-import { promptProjectConfig, promptMergeStrategy } from './prompts.js';
+import { promptProjectConfig, promptSimplifiedConfig, promptMergeStrategy } from './prompts.js';
 import { generateFullAgents } from '../core/generator.js';
 import { mergeFullAgents } from '../core/merger.js';
-import { generateWorkflows, generateIDEFiles } from '../core/workflow-generator.js';
+import { generateWorkflows, generateIDEFiles, generateAICLIFiles, } from '../core/workflow-generator.js';
 import { writeFile, createBackup, readFile, fileExists } from '../utils/file-system.js';
 import { existsSync } from 'fs';
 import { parseRulesIgnore } from '../utils/rulesignore.js';
@@ -13,6 +13,7 @@ import { scaffoldMinimalProject } from '../core/minimal-scaffolder.js';
 import path from 'path';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
+import { SkillsManager, getDefaultTemplatesPath } from '../core/skills-manager.js';
 const FRAMEWORK_LABELS = {
     nestjs: 'NestJS',
     spring: 'Spring Boot',
@@ -86,7 +87,9 @@ export async function initCommand(options) {
         let config;
         const cliMinimal = Boolean(options.minimal);
         const cliLight = Boolean(options.light);
+        const cliQuick = Boolean(options.quick);
         if (options.yes) {
+            // Full auto mode - no prompts at all
             config = {
                 languages: detection.languages.map((l) => l.language),
                 modules: cliMinimal ? [] : detection.modules.filter((m) => m.detected).map((m) => m.module),
@@ -105,7 +108,14 @@ export async function initCommand(options) {
             };
             console.log(chalk.blue('\nUsing detected defaults...'));
         }
+        else if (cliQuick) {
+            // Quick mode - minimal prompts (language, MCP, hooks only)
+            config = await promptSimplifiedConfig(detection);
+            config.lightMode = cliLight;
+            config.minimal = cliMinimal;
+        }
         else {
+            // Full interactive mode
             console.log('');
             config = await promptProjectConfig(detection, {
                 defaultMode: cliMinimal ? 'minimal' : 'full',
@@ -169,6 +179,29 @@ export async function initCommand(options) {
         // Save project configuration to .rulebook
         const { createConfigManager } = await import('../core/config-manager.js');
         const configManager = createConfigManager(cwd);
+        // Auto-detect and enable skills based on project detection (v2.0)
+        let enabledSkills = [];
+        try {
+            const { SkillsManager, getDefaultTemplatesPath } = await import('../core/skills-manager.js');
+            const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+            // Build a RulebookConfig-like object for skill detection
+            const rulebookConfigForSkills = {
+                languages: config.languages,
+                frameworks: config.frameworks,
+                modules: config.modules,
+                services: config.services,
+            };
+            enabledSkills = await skillsManager.autoDetectSkills(rulebookConfigForSkills);
+            if (enabledSkills.length > 0) {
+                console.log(chalk.green('\n✓ Auto-detected skills:'));
+                for (const skillId of enabledSkills) {
+                    console.log(chalk.gray(`  - ${skillId}`));
+                }
+            }
+        }
+        catch {
+            // Skills system not available or error - continue without skills
+        }
         await configManager.updateConfig({
             languages: config.languages,
             frameworks: config.frameworks,
@@ -176,6 +209,7 @@ export async function initCommand(options) {
             services: config.services,
             modular: config.modular ?? true,
             rulebookDir: config.rulebookDir || 'rulebook',
+            skills: enabledSkills.length > 0 ? { enabled: enabledSkills } : undefined,
         });
         // Generate or merge AGENTS.md
         const agentsPath = path.join(cwd, 'AGENTS.md');
@@ -244,6 +278,20 @@ export async function initCommand(options) {
                 ideSpinner.info('IDE files already exist (skipped)');
             }
         }
+        // Generate AI CLI configuration files (CLAUDE.md, CODEX.md, GEMINI.md)
+        if (!minimalMode) {
+            const cliSpinner = ora('Generating AI CLI configuration files...').start();
+            const cliFiles = await generateAICLIFiles(config, cwd);
+            if (cliFiles.length > 0) {
+                cliSpinner.succeed(`Generated ${cliFiles.length} AI CLI configuration files`);
+                for (const file of cliFiles) {
+                    console.log(chalk.gray(`  - ${path.relative(cwd, file)}`));
+                }
+            }
+            else {
+                cliSpinner.info('AI CLI files already exist (skipped)');
+            }
+        }
         if (minimalMode && minimalArtifacts.length > 0) {
             console.log(chalk.green('\n✅ Essentials created:'));
             for (const artifact of minimalArtifacts) {
@@ -1262,6 +1310,39 @@ export async function updateCommand(options) {
         // Save project configuration to .rulebook
         const { createConfigManager } = await import('../core/config-manager.js');
         const configManager = createConfigManager(cwd);
+        // Load existing config to preserve skills
+        const existingConfig = await configManager.loadConfig();
+        const existingSkills = existingConfig.skills?.enabled || [];
+        // Auto-detect skills based on project detection (v2.0)
+        let detectedSkills = [];
+        try {
+            const { SkillsManager, getDefaultTemplatesPath } = await import('../core/skills-manager.js');
+            const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+            // Build a RulebookConfig-like object for skill detection
+            const rulebookConfigForSkills = {
+                languages: config.languages,
+                frameworks: config.frameworks,
+                modules: config.modules,
+                services: config.services,
+            };
+            detectedSkills = await skillsManager.autoDetectSkills(rulebookConfigForSkills);
+            // Merge with existing skills (keep existing, add new detected)
+            const mergedSkills = [...new Set([...existingSkills, ...detectedSkills])];
+            if (detectedSkills.length > existingSkills.length) {
+                const newSkills = detectedSkills.filter((s) => !existingSkills.includes(s));
+                if (newSkills.length > 0) {
+                    console.log(chalk.green('\n✓ New skills detected:'));
+                    for (const skillId of newSkills) {
+                        console.log(chalk.gray(`  - ${skillId}`));
+                    }
+                }
+            }
+            detectedSkills = mergedSkills;
+        }
+        catch {
+            // Skills system not available or error - preserve existing skills
+            detectedSkills = existingSkills;
+        }
         await configManager.updateConfig({
             languages: config.languages,
             frameworks: config.frameworks,
@@ -1269,6 +1350,7 @@ export async function updateCommand(options) {
             services: config.services,
             modular: config.modular ?? true,
             rulebookDir: config.rulebookDir || 'rulebook',
+            skills: detectedSkills.length > 0 ? { enabled: detectedSkills } : undefined,
         });
         // Merge with existing AGENTS.md (with migration support)
         const mergeSpinner = ora('Updating AGENTS.md with latest templates...').start();
@@ -1367,4 +1449,283 @@ export async function updateCommand(options) {
         process.exit(1);
     }
 }
+// ============================================
+// Skills Commands (v2.0)
+// ============================================
+/**
+ * List all available skills
+ */
+export async function skillListCommand(options) {
+    try {
+        const cwd = process.cwd();
+        const spinner = ora('Discovering skills...').start();
+        const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+        const { createConfigManager } = await import('../core/config-manager.js');
+        const configManager = createConfigManager(cwd);
+        let skills;
+        if (options.category) {
+            skills = await skillsManager.getSkillsByCategory(options.category);
+        }
+        else {
+            skills = await skillsManager.getSkills();
+        }
+        // Get enabled status from config
+        let enabledIds = new Set();
+        try {
+            const config = await configManager.loadConfig();
+            enabledIds = new Set(config.skills?.enabled || []);
+        }
+        catch {
+            // No config file, all skills disabled
+        }
+        // Filter by enabled status if requested
+        if (options.enabled) {
+            skills = skills.filter((s) => enabledIds.has(s.id));
+        }
+        spinner.succeed(`Found ${skills.length} skill(s)`);
+        if (skills.length === 0) {
+            console.log(chalk.yellow('\nNo skills found matching criteria.'));
+            return;
+        }
+        // Group by category
+        const byCategory = new Map();
+        for (const skill of skills) {
+            const cat = skill.category;
+            if (!byCategory.has(cat)) {
+                byCategory.set(cat, []);
+            }
+            byCategory.get(cat).push(skill);
+        }
+        console.log(chalk.bold.blue('\n📦 Available Skills\n'));
+        for (const [category, categorySkills] of byCategory) {
+            console.log(chalk.bold.white(`${category.toUpperCase()}`));
+            for (const skill of categorySkills) {
+                const enabled = enabledIds.has(skill.id);
+                const status = enabled ? chalk.green('✓') : chalk.gray('○');
+                const name = enabled ? chalk.green(skill.metadata.name) : chalk.white(skill.metadata.name);
+                console.log(`  ${status} ${name}`);
+                console.log(chalk.gray(`    ${skill.metadata.description}`));
+                console.log(chalk.gray(`    ID: ${skill.id}`));
+            }
+            console.log('');
+        }
+        console.log(chalk.gray('Use "rulebook skill add <skill-id>" to enable a skill'));
+        console.log(chalk.gray('Use "rulebook skill remove <skill-id>" to disable a skill'));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Failed to list skills:'), error);
+        process.exit(1);
+    }
+}
+/**
+ * Add (enable) a skill
+ */
+export async function skillAddCommand(skillId) {
+    try {
+        const cwd = process.cwd();
+        const spinner = ora(`Adding skill: ${skillId}...`).start();
+        const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+        const { createConfigManager } = await import('../core/config-manager.js');
+        const configManager = createConfigManager(cwd);
+        // Check if skill exists
+        const skill = await skillsManager.getSkillById(skillId);
+        if (!skill) {
+            spinner.fail(`Skill not found: ${skillId}`);
+            // Search for similar skills
+            const allSkills = await skillsManager.getSkills();
+            const similar = allSkills.filter((s) => s.id.includes(skillId.toLowerCase()) ||
+                s.metadata.name.toLowerCase().includes(skillId.toLowerCase()));
+            if (similar.length > 0) {
+                console.log(chalk.yellow('\nDid you mean one of these?'));
+                for (const s of similar.slice(0, 5)) {
+                    console.log(chalk.gray(`  - ${s.id} (${s.metadata.name})`));
+                }
+            }
+            console.log(chalk.gray('\nUse "rulebook skill list" to see all available skills'));
+            process.exit(1);
+        }
+        // Load config and enable skill
+        let config = await configManager.loadConfig();
+        config = await skillsManager.enableSkill(skillId, config);
+        // Validate for conflicts
+        const validation = await skillsManager.validateSkills(config);
+        if (validation.conflicts.length > 0) {
+            spinner.warn(`Skill enabled with conflicts`);
+            console.log(chalk.yellow('\n⚠️  Conflicts detected:'));
+            for (const conflict of validation.conflicts) {
+                console.log(chalk.yellow(`  - ${conflict.skillA} conflicts with ${conflict.skillB}`));
+                console.log(chalk.gray(`    ${conflict.reason}`));
+            }
+        }
+        else {
+            spinner.succeed(`Skill added: ${skill.metadata.name}`);
+        }
+        // Save config
+        await configManager.saveConfig(config);
+        console.log(chalk.green(`\n✓ Skill "${skill.metadata.name}" is now enabled`));
+        console.log(chalk.gray(`  Category: ${skill.category}`));
+        console.log(chalk.gray(`  Description: ${skill.metadata.description}`));
+        if (validation.warnings.length > 0) {
+            console.log(chalk.yellow('\n⚠️  Warnings:'));
+            for (const warning of validation.warnings) {
+                console.log(chalk.yellow(`  - ${warning}`));
+            }
+        }
+        console.log(chalk.gray('\nRun "rulebook update" to regenerate AGENTS.md with the new skill'));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Failed to add skill:'), error);
+        process.exit(1);
+    }
+}
+/**
+ * Remove (disable) a skill
+ */
+export async function skillRemoveCommand(skillId) {
+    try {
+        const cwd = process.cwd();
+        const spinner = ora(`Removing skill: ${skillId}...`).start();
+        const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+        const { createConfigManager } = await import('../core/config-manager.js');
+        const configManager = createConfigManager(cwd);
+        // Check if skill exists
+        const skill = await skillsManager.getSkillById(skillId);
+        if (!skill) {
+            spinner.fail(`Skill not found: ${skillId}`);
+            console.log(chalk.gray('Use "rulebook skill list" to see all available skills'));
+            process.exit(1);
+        }
+        // Load config
+        let config = await configManager.loadConfig();
+        // Check if skill is enabled
+        if (!config.skills?.enabled?.includes(skillId)) {
+            spinner.fail(`Skill "${skillId}" is not currently enabled`);
+            process.exit(1);
+        }
+        // Disable skill
+        config = await skillsManager.disableSkill(skillId, config);
+        await configManager.saveConfig(config);
+        spinner.succeed(`Skill removed: ${skill.metadata.name}`);
+        console.log(chalk.green(`\n✓ Skill "${skill.metadata.name}" is now disabled`));
+        console.log(chalk.gray('\nRun "rulebook update" to regenerate AGENTS.md without this skill'));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Failed to remove skill:'), error);
+        process.exit(1);
+    }
+}
+/**
+ * Show skill details
+ */
+export async function skillShowCommand(skillId) {
+    try {
+        const cwd = process.cwd();
+        const spinner = ora(`Loading skill: ${skillId}...`).start();
+        const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+        const { createConfigManager } = await import('../core/config-manager.js');
+        const configManager = createConfigManager(cwd);
+        const skill = await skillsManager.getSkillById(skillId);
+        if (!skill) {
+            spinner.fail(`Skill not found: ${skillId}`);
+            // Search for similar skills
+            const allSkills = await skillsManager.getSkills();
+            const similar = allSkills.filter((s) => s.id.includes(skillId.toLowerCase()) ||
+                s.metadata.name.toLowerCase().includes(skillId.toLowerCase()));
+            if (similar.length > 0) {
+                console.log(chalk.yellow('\nDid you mean one of these?'));
+                for (const s of similar.slice(0, 5)) {
+                    console.log(chalk.gray(`  - ${s.id} (${s.metadata.name})`));
+                }
+            }
+            process.exit(1);
+        }
+        spinner.stop();
+        // Check if enabled
+        let enabled = false;
+        try {
+            const config = await configManager.loadConfig();
+            enabled = config.skills?.enabled?.includes(skillId) || false;
+        }
+        catch {
+            // No config
+        }
+        console.log(chalk.bold.blue(`\n📦 ${skill.metadata.name}\n`));
+        console.log(chalk.white(`ID: ${skill.id}`));
+        console.log(chalk.white(`Category: ${skill.category}`));
+        console.log(chalk.white(`Status: ${enabled ? chalk.green('Enabled') : chalk.gray('Disabled')}`));
+        if (skill.metadata.version) {
+            console.log(chalk.white(`Version: ${skill.metadata.version}`));
+        }
+        if (skill.metadata.author) {
+            console.log(chalk.white(`Author: ${skill.metadata.author}`));
+        }
+        console.log(chalk.white(`\nDescription:`));
+        console.log(chalk.gray(`  ${skill.metadata.description}`));
+        if (skill.metadata.tags && skill.metadata.tags.length > 0) {
+            console.log(chalk.white(`\nTags: ${skill.metadata.tags.join(', ')}`));
+        }
+        if (skill.metadata.dependencies && skill.metadata.dependencies.length > 0) {
+            console.log(chalk.white(`\nDependencies:`));
+            for (const dep of skill.metadata.dependencies) {
+                console.log(chalk.gray(`  - ${dep}`));
+            }
+        }
+        if (skill.metadata.conflicts && skill.metadata.conflicts.length > 0) {
+            console.log(chalk.yellow(`\nConflicts with:`));
+            for (const conflict of skill.metadata.conflicts) {
+                console.log(chalk.yellow(`  - ${conflict}`));
+            }
+        }
+        // Show preview of content
+        console.log(chalk.white(`\nContent Preview:`));
+        const preview = skill.content.slice(0, 500);
+        console.log(chalk.gray(preview + (skill.content.length > 500 ? '...' : '')));
+        console.log(chalk.gray(`\nPath: ${skill.path}`));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Failed to show skill:'), error);
+        process.exit(1);
+    }
+}
+/**
+ * Search for skills
+ */
+export async function skillSearchCommand(query) {
+    try {
+        const cwd = process.cwd();
+        const spinner = ora(`Searching for: ${query}...`).start();
+        const skillsManager = new SkillsManager(getDefaultTemplatesPath(), cwd);
+        const { createConfigManager } = await import('../core/config-manager.js');
+        const configManager = createConfigManager(cwd);
+        const skills = await skillsManager.searchSkills(query);
+        spinner.succeed(`Found ${skills.length} result(s)`);
+        if (skills.length === 0) {
+            console.log(chalk.yellow(`\nNo skills found matching "${query}"`));
+            console.log(chalk.gray('Try a different search term or use "rulebook skill list"'));
+            return;
+        }
+        // Get enabled status
+        let enabledIds = new Set();
+        try {
+            const config = await configManager.loadConfig();
+            enabledIds = new Set(config.skills?.enabled || []);
+        }
+        catch {
+            // No config
+        }
+        console.log(chalk.bold.blue(`\n🔍 Search Results for "${query}"\n`));
+        for (const skill of skills) {
+            const enabled = enabledIds.has(skill.id);
+            const status = enabled ? chalk.green('✓') : chalk.gray('○');
+            const name = enabled ? chalk.green(skill.metadata.name) : chalk.white(skill.metadata.name);
+            console.log(`${status} ${name} (${skill.category})`);
+            console.log(chalk.gray(`  ${skill.metadata.description}`));
+            console.log(chalk.gray(`  ID: ${skill.id}\n`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Search failed:'), error);
+        process.exit(1);
+    }
+}
 //# sourceMappingURL=commands.js.map