skill-creator 0.0.0 → 1.0.0

package/dist/cli.js

@@ -4,194 +4,139 @@
  */
 import { Command } from 'commander';
 import gradient from 'gradient-string';
-import inquirer from 'inquirer';
 import { SkillCreator } from './core/skillCreator.js';
 import { PackageUtils } from './utils/package.js';
 const program = new Command();
+/**
+ * Helper function to create a skill for a package with interactive confirmation
+ */
+async function createSkillForPackage(skillDirName, skillDisplayName, scope, force = false) {
+    const creator = new SkillCreator();
+    // Extract package name from skillDirName if it's in format "package@version"
+    // Otherwise, use the skillDirName as is
+    const lastAtSignIndex = skillDirName.lastIndexOf('@');
+    const packageName = lastAtSignIndex > 0 ? skillDirName.substring(0, lastAtSignIndex) : skillDirName;
+    const createOptions = {
+        packageName: packageName, // Extract package name from skillDirName
+        path: scope === 'user' ? undefined : '.claude/skills',
+        storage: scope,
+        noInitDocs: true, // Docs are downloaded in a separate step in the new flow
+        force: force, // Pass force option to SkillCreator
+    };
+    console.log(gradient('cyan', 'magenta')('\n🚀 Creating skill...'));
+    const result = await creator.createSkill(createOptions);
+    if (result.created) {
+        console.log(gradient('green', 'cyan')(`\n✅ ${result.message}`));
+        console.log(gradient('blue', 'cyan')(`📍 Skill Path: ${result.skillPath}`));
+        console.log('\n🎉 Skill created successfully!');
+        console.log('\nNext steps:');
+        console.log(`1. Add content: skill-creator add-skill --pwd "${result.skillPath}" --title "My Note" --content "Your content"`);
+        console.log(`2. Search skill: skill-creator search-skill --pwd "${result.skillPath}" "query"`);
+        console.log(`3. Download docs: skill-creator download-context7 --pwd "${result.skillPath}" <context7_library_id>`);
+        return result.skillPath;
+    }
+    else {
+        throw new Error(result.message || 'Failed to create skill');
+    }
+}
 program
     .name('skill-creator')
     .description('Create claude-code-skills with documentation management')
     .version('2.0.0');
+// Add create-cc-skill command
 program
-    .argument('<package_name>', 'Package name to create documentation skill for (e.g., tanstack-router)')
-    .option('-p, --path <path>', 'Output path (default: current directory)', '.')
-    .option('-d, --description <description>', 'Description of the skill')
-    .option('-c, --context7-id <id>', 'Context7 library ID (e.g., /tanstack/router/docs)')
-    .option('--no-init-docs', 'Skip initial documentation download')
-    .option('-s, --storage <storage>', 'Where to store the skill', 'project')
-    .option('--package-version <version>', 'Specific version to use')
-    .option('--no-interactive', 'Skip interactive prompts')
-    .option('--search', 'Enable interactive package search')
-    .action(async (packageName, options, _command) => {
-    // Validate package name
-    if (!packageName || packageName.trim().length === 0) {
-        console.error('❌ Error: Package name is required');
-        process.exit(1);
-    }
-    console.log(gradient('cyan', 'magenta')('\n🔍 Searching for package:'));
-    console.log(gradient('yellow', 'orange')(packageName));
-    console.log(gradient('cyan', 'magenta')('='.repeat(50)));
-    let selectedPackage = { name: packageName, version: options.packageVersion };
-    // If not a valid package name or search is enabled, search for suggestions
-    if (!PackageUtils.validatePackageName(packageName) || options.search) {
-        const suggestions = await PackageUtils.suggestPackages(packageName, { limit: 10 });
-        if (suggestions.length === 0) {
-            console.error(`❌ No packages found for "${packageName}"`);
-            process.exit(1);
-        }
-        if (suggestions.length > 1 && !options.noInteractive) {
-            console.log(`\n📦 Found ${suggestions.length} package(s):`);
-            const choices = suggestions.map((pkg) => ({
-                name: `${pkg.name} (${pkg.version}) - ${pkg.description.slice(0, 80)}${pkg.description.length > 80 ? '...' : ''}`,
-                value: pkg.name,
-                short: pkg.name,
-            }));
-            const { selectedPkg } = await inquirer.prompt([
+    .command('create-cc-skill')
+    .requiredOption('--scope <scope>', 'Storage scope (project or user)')
+    .option('--interactive', 'Enable interactive confirmation prompts')
+    .option('--force', 'Force overwrite existing files in the skill directory')
+    .argument('<skill_dir_name>', 'The name of the skill directory to create')
+    .action(async (skillDirName, options) => {
+    try {
+        const { scope, interactive, force } = options;
+        // Import inquirer for interactive prompts
+        const { default: inquirer } = await import('inquirer');
+        let finalSkillName = skillDirName;
+        if (interactive) {
+            // 1. 确认存储位置
+            console.log('Skill Creation Configuration:');
+            console.log(`- Skill directory name: ${skillDirName}`);
+            console.log(`- Storage scope: ${scope}`);
+            const { confirmLocation } = await inquirer.prompt([
                 {
-                    type: 'list',
-                    name: 'selectedPkg',
-                    message: 'Select a package:',
-                    choices,
-                    pageSize: 10,
+                    type: 'confirm',
+                    name: 'confirmLocation',
+                    message: `Create skill in ${scope === 'project' ? './.claude/skills/' : '~/.claude/skills/'}?`,
+                    default: true,
                 },
             ]);
-            selectedPackage.name = selectedPkg;
-            selectedPackage.version = await PackageUtils.getPackageVersion(selectedPkg) || suggestions.find(s => s.name === selectedPkg)?.version;
-        }
-        else {
-            selectedPackage.name = suggestions[0].name;
-            selectedPackage.version = suggestions[0].version;
-        }
-    }
-    // Get version if not specified
-    if (!selectedPackage.version) {
-        selectedPackage.version = await PackageUtils.getPackageVersion(selectedPackage.name);
-    }
-    if (!selectedPackage.version) {
-        console.warn(`⚠️  Could not determine version for ${selectedPackage.name}`);
-    }
-    console.log(gradient('green', 'cyan')(`\n✅ Selected package: ${selectedPackage.name}@${selectedPackage.version || 'latest'}`));
-    // Ask for storage location if not specified
-    let storage = options.storage;
-    let path = options.path;
-    if (!options.noInteractive && !options.storage) {
-        const { storageLocation } = await inquirer.prompt([
-            {
-                type: 'list',
-                name: 'storageLocation',
-                message: 'Where would you like to store this skill?',
-                choices: [
-                    {
-                        name: '📁 Current project (./.claude/skills/)',
-                        value: 'project',
-                    },
-                    {
-                        name: '🏠 User directory (~/.claude/skills/)',
-                        value: 'user',
-                    },
-                ],
-                default: 'project',
-            },
-        ]);
-        storage = storageLocation;
-        if (storage === 'project' && path === '.') {
-            const { useDefaultPath } = await inquirer.prompt([
+            if (!confirmLocation) {
+                console.log('Skill creation cancelled.');
+                process.exit(0);
+            }
+            // 2. 询问技能命名
+            const { skillNameConfirmed } = await inquirer.prompt([
                 {
                     type: 'confirm',
-                    name: 'useDefaultPath',
-                    message: 'Use current directory for skill storage?',
+                    name: 'skillNameConfirmed',
+                    message: `Use '${skillDirName}' as the skill name?`,
                     default: true,
                 },
             ]);
-            if (!useDefaultPath) {
-                const { customPath } = await inquirer.prompt([
+            if (!skillNameConfirmed) {
+                const { customSkillName } = await inquirer.prompt([
                     {
                         type: 'input',
-                        name: 'customPath',
-                        message: 'Enter custom path:',
-                        default: './',
+                        name: 'customSkillName',
+                        message: 'Enter a new skill name:',
+                        validate: (input) => input.trim() !== '' || 'Skill name cannot be empty',
                     },
                 ]);
-                path = customPath;
+                finalSkillName = customSkillName.trim();
+            }
+            // 3. 确认最终配置
+            console.log('\nFinal Configuration:');
+            console.log(`- Skill directory name: ${skillDirName}`);
+            console.log(`- Skill display name: ${finalSkillName}`);
+            console.log(`- Storage location: ${scope === 'project' ? './.claude/skills/' : '~/.claude/skills/'}`);
+            const { confirmFinal } = await inquirer.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirmFinal',
+                    message: 'Proceed with skill creation?',
+                    default: true,
+                },
+            ]);
+            if (!confirmFinal) {
+                console.log('Skill creation cancelled.');
+                process.exit(0);
             }
         }
+        // Create the skill with confirmed configuration
+        const skillPath = await createSkillForPackage(skillDirName, finalSkillName, scope, force);
+        console.log(`Skill created successfully at: ${skillPath}`);
     }
-    console.log(gradient('cyan', 'magenta')('\n📝 Creating skill...'));
-    console.log(gradient('cyan', 'magenta')('='.repeat(50)));
-    const creator = new SkillCreator();
-    // Create skill folder name
-    const skillName = PackageUtils.createSkillFolderName(selectedPackage.name, selectedPackage.version ?? '1.0.0');
-    console.log(`\n📁 Skill folder name: ${skillName}`);
-    // Create skill
-    const createOptions = {
-        packageName: selectedPackage.name,
-        path,
-        description: options.description,
-        context7Id: options.context7Id,
-        noInitDocs: options.noInitDocs,
-        storage,
-        version: selectedPackage.version,
-    };
-    const result = await creator.createSkill(createOptions);
-    // Print result
-    if (result.created) {
-        console.log(gradient('green', 'cyan')(`\n✅ ${result.message}`));
-        if (result.docsInitialized) {
-            console.log(`✅ Documentation downloaded and indexed`);
-        }
-        console.log(`\n📋 Next steps:`);
-        console.log(`1. cd ${result.skillPath}`);
-        console.log(`2. npm install`);
-        if (!result.docsInitialized) {
-            console.log(`\n📚 To initialize documentation:`);
-            console.log(`   Option A: Use Context7 (requires MCP)`);
-            console.log(`   - First, resolve library ID with AI help or Context7 search`);
-            console.log(`   - Update config.json with the correct context7_library_id`);
-            console.log(`   - Run: npm run update-context7`);
-            console.log(`\n   Option B: Add documentation manually`);
-            console.log(`   - Run: npm run add -- --title 'Topic' --content 'Your content'`);
-        }
-        console.log(`\n3. npm run build-index`);
-        console.log(`4. npm run search -- --query 'test query'`);
-        if (options.context7Id) {
-            console.log(`\n💡 Note: Context7 library ID set to: ${options.context7Id}`);
-            console.log(`   If this is incorrect, edit config.json and update context7_library_id`);
-        }
-    }
-    else {
-        console.error(`❌ ${result.message}`);
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : String(error));
         process.exit(1);
     }
 });
-// Add init command to install subagents
+// Add interactive init command
 program
     .command('init')
+    .description('Install skill-creator as subagent (interactive mode)')
+    .action(async () => {
+    const { runScript } = await import('./core/runScript.js');
+    await runScript('init', []);
+});
+// Add init command to install subagents (non-interactive version)
+program
+    .command('init-cc')
     .description('Install skill-creator as subagent in ~/.claude/agents/')
     .action(async () => {
-    const { homedir } = await import('node:os');
-    const { join } = await import('node:path');
-    const { mkdirSync, writeFileSync } = await import('node:fs');
-    const agentsDir = join(homedir(), '.claude', 'agents');
-    const skillCreatorDir = join(agentsDir, 'skill-creator');
-    // Create directories
-    mkdirSync(agentsDir, { recursive: true });
-    mkdirSync(skillCreatorDir, { recursive: true });
-    // Create subagent manifest
-    const manifest = {
-        name: 'skill-creator',
-        version: '2.0.0',
-        description: 'Claude Code skill creation agent',
-        main: process.cwd(),
-        commands: [
-            'search',
-            'get-name',
-            'download-context7',
-            'addSkill'
-        ]
-    };
-    writeFileSync(join(skillCreatorDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
-    console.log(gradient('green', 'cyan')('\n✅ Skill-creator subagent installed successfully!'));
-    console.log(`📍 Location: ${skillCreatorDir}`);
+    const { runScript } = await import('./core/runScript.js');
+    // For init-cc, we want the non-interactive version that installs to user directory
+    // Use --scope=user for consistency with other CLI commands
+    await runScript('init', ['--scope', 'user']);
 });
 // Add search command for package searching
 program
@@ -199,148 +144,205 @@ program
     .argument('<keywords>', 'Search keywords for npm packages')
     .option('-l, --limit <limit>', 'Number of results to show', '10')
     .action(async (keywords, options) => {
-    // Handle multiple keywords by splitting
     const query = keywords;
-    console.log(gradient('cyan', 'magenta')('\n🔍 Searching npm packages...'));
-    console.log(gradient('yellow', 'orange')(query));
-    console.log(gradient('cyan', 'magenta')('='.repeat(50)));
     const suggestions = await PackageUtils.suggestPackages(query, {
-        limit: parseInt(options.limit)
-    });
-    if (suggestions.length === 0) {
-        console.error(`❌ No packages found for "${query}"`);
-        return;
-    }
-    console.log(`\n📦 Found ${suggestions.length} package(s):`);
-    suggestions.forEach((pkg, index) => {
-        console.log(`\n${index + 1}. ${gradient('green', 'cyan')(pkg.name)} (${pkg.version})`);
-        console.log(`   ${pkg.description.slice(0, 100)}${pkg.description.length > 100 ? '...' : ''}`);
-        console.log(`   👤 ${pkg.publisher} | ⭐ ${pkg.score.toFixed(2)}`);
+        limit: parseInt(options.limit),
     });
+    console.log(JSON.stringify(suggestions, null, 2));
 });
-// Add get-name command to generate skill name
+// Add get-info command for package information
 program
-    .command('get-name')
-    .argument('<package_name>', 'Package name')
-    .option('-v, --version <version>', 'Specific version')
-    .action(async (packageName, options) => {
-    const version = options.version || await PackageUtils.getPackageVersion(packageName);
-    if (!version) {
-        console.error(`❌ Could not determine version for ${packageName}`);
+    .command('get-info')
+    .argument('<package_name>', 'The npm package name to get information for')
+    .action(async (packageName) => {
+    const packageInfo = await PackageUtils.getPackageInfo(packageName);
+    if (!packageInfo) {
+        console.error(`❌ Package "${packageName}" not found or API error occurred.`);
         process.exit(1);
     }
-    const skillName = PackageUtils.createSkillFolderName(packageName, version);
-    console.log(gradient('green', 'cyan')(`\n✅ Skill name: ${skillName}`));
-    console.log(`   Package: ${packageName}@${version}`);
+    const version = packageInfo.version;
+    const skillDirName = PackageUtils.createSkillFolderName(packageName, version);
+    const result = {
+        skill_dir_name: skillDirName,
+        name: packageInfo.name,
+        version: version,
+        description: packageInfo.description || '',
+        keywords: packageInfo.keywords || [],
+        license: packageInfo.license || '',
+        author: packageInfo.author || '',
+        maintainers: packageInfo.maintainers || [],
+        homepage: packageInfo.homepage || '',
+        repository: {
+            url: packageInfo.repository?.url || '',
+            type: packageInfo.repository?.type || '',
+        },
+        bugs: {
+            url: packageInfo.bugs?.url || '',
+        },
+        funding: packageInfo.funding || '',
+        scripts: packageInfo.scripts || {},
+        engines: packageInfo.engines || {},
+        types: packageInfo.types || '',
+        dependencies: packageInfo.dependencies || {},
+        devDependencies: packageInfo.devDependencies || {},
+        time: {
+            created: packageInfo.time?.created || '',
+            modified: packageInfo.time?.modified || '',
+        },
+    };
+    console.log(JSON.stringify(result, null, 2));
 });
-// Add download-context7 command
+// Add search-skill command
 program
-    .command('download-context7')
-    .argument('<package_name>', 'Package name')
-    .argument('<context7_id>', 'Context7 library ID')
-    .option('-f, --force', 'Force update even if up to date')
-    .option('-s, --storage <storage>', 'Storage location (project|user)', 'project')
-    .action(async (packageName, context7Id, options) => {
-    console.log(gradient('cyan', 'magenta')('\n📥 Downloading Context7 documentation...'));
-    console.log(`Package: ${packageName}`);
-    console.log(`Context7 ID: ${context7Id}`);
-    // Find existing skill
-    const { join } = await import('node:path');
-    const { homedir } = await import('node:os');
-    const baseDir = options.storage === 'user'
-        ? join(homedir(), '.claude', 'skills')
-        : join(process.cwd(), '.claude', 'skills');
-    // Find skill directory
-    const { readdirSync } = await import('node:fs');
-    const dirs = readdirSync(baseDir, { withFileTypes: true })
-        .filter(dirent => dirent.isDirectory())
-        .map(dirent => dirent.name)
-        .filter(name => name.includes(packageName.replace(/[^a-z0-9]/gi, '')));
-    if (dirs.length === 0) {
-        console.error(`❌ No skill found for package ${packageName}`);
-        console.log(`💡 Create a skill first with: skill-creator ${packageName}`);
+    .command('search-skill')
+    .argument('<query>', 'Search query')
+    .option('--pwd <path>', 'Path to the skill directory')
+    .option('--package <name>', 'Package name to find skill directory for')
+    .option('--mode <mode>', 'Search mode: auto, fuzzy, or chroma', 'auto')
+    .option('--list', 'Show simplified list view (basic info only)', false)
+    .action(async (query, options) => {
+    let skillDir;
+    if (options.pwd) {
+        skillDir = options.pwd;
+    }
+    else if (options.package) {
+        const { join } = await import('node:path');
+        const { homedir } = await import('node:os');
+        const { readdirSync, existsSync } = await import('node:fs');
+        const findDir = (base) => {
+            if (!existsSync(base))
+                return undefined;
+            const dirs = readdirSync(base, { withFileTypes: true })
+                .filter((dirent) => dirent.isDirectory())
+                .map((dirent) => dirent.name)
+                .filter((name) => name.includes(options.package.replace(/[^a-z0-9]/gi, '')));
+            return dirs.length > 0 ? join(base, dirs[0]) : undefined;
+        };
+        skillDir =
+            findDir(join(process.cwd(), '.claude', 'skills')) ||
+                findDir(join(homedir(), '.claude', 'skills'));
+    }
+    if (!skillDir) {
+        console.error('❌ Could not find skill directory. Please provide --pwd or a valid --package.');
         process.exit(1);
     }
-    const skillDir = join(baseDir, dirs[0]);
-    // Change to skill directory and run update script
+    console.log(gradient('cyan', 'magenta')('\n🔍 Searching in skill...'));
+    console.log(`Skill Path: ${skillDir}`);
+    console.log(`Query: ${query}`);
     const { chdir } = await import('node:process');
     const originalCwd = process.cwd();
     chdir(skillDir);
     try {
         const { runScript } = await import('./core/runScript.js');
-        const args = ['--force'];
-        await runScript('update-context7', args);
+        const args = ['--query', query];
+        if (options.mode !== 'auto')
+            args.push('--mode', options.mode);
+        if (options.list)
+            args.push('--list');
+        // Enhanced search is now enabled by default, no need for --enhanced flag
+        await runScript('search-skill', args);
     }
     finally {
         chdir(originalCwd);
     }
-    console.log(gradient('green', 'cyan')('\n✅ Documentation downloaded and sliced!'));
 });
-// Add search-in-skill command
+// Add download-context7 command
 program
-    .command('search-in-skill')
-    .argument('<package_name>', 'Package name')
-    .argument('<query>', 'Search query')
-    .action(async (packageName, query) => {
-    console.log(gradient('cyan', 'magenta')('\n🔍 Searching in skill...'));
-    console.log(`Package: ${packageName}`);
-    console.log(`Query: ${query}`);
-    // Find skill directory
-    const { join, dirname } = await import('node:path');
-    const { homedir } = await import('node:os');
-    const { readdirSync } = await import('node:fs');
-    const baseDir = join(process.cwd(), '.claude', 'skills');
-    const dirs = readdirSync(baseDir, { withFileTypes: true })
-        .filter(dirent => dirent.isDirectory())
-        .map(dirent => dirent.name)
-        .filter(name => name.includes(packageName.replace(/[^a-z0-9]/gi, '')));
-    if (dirs.length === 0) {
-        console.error(`❌ No skill found for package ${packageName}`);
+    .command('download-context7')
+    .argument('<project_id>', 'Context7 library ID')
+    .option('--pwd <path>', 'Path to the skill directory')
+    .option('--package <name>', 'Package name to find skill directory for')
+    .option('-f, --force', 'Force update even if up to date')
+    .option('--skip-chroma-indexing', 'Skip automatic ChromaDB index building after download')
+    .action(async (projectId, options) => {
+    let skillDir;
+    if (options.pwd) {
+        skillDir = options.pwd;
+    }
+    else if (options.package) {
+        const { join } = await import('node:path');
+        const { homedir } = await import('node:os');
+        const { readdirSync, existsSync } = await import('node:fs');
+        const findDir = (base) => {
+            if (!existsSync(base))
+                return undefined;
+            const dirs = readdirSync(base, { withFileTypes: true })
+                .filter((dirent) => dirent.isDirectory())
+                .map((dirent) => dirent.name)
+                .filter((name) => name.includes(options.package.replace(/[^a-z0-9]/gi, '')));
+            return dirs.length > 0 ? join(base, dirs[0]) : undefined;
+        };
+        skillDir =
+            findDir(join(process.cwd(), '.claude', 'skills')) ||
+                findDir(join(homedir(), '.claude', 'skills'));
+    }
+    if (!skillDir) {
+        console.error('❌ Could not find skill directory. Please provide --pwd or a valid --package.');
         process.exit(1);
     }
-    const skillDir = join(baseDir, dirs[0]);
-    // Change to skill directory and run search script
+    console.log(gradient('cyan', 'magenta')('\n📥 Downloading Context7 documentation...'));
+    console.log(`Skill Path: ${skillDir}`);
+    console.log(`Context7 ID: ${projectId}`);
     const { chdir } = await import('node:process');
     const originalCwd = process.cwd();
     chdir(skillDir);
     try {
         const { runScript } = await import('./core/runScript.js');
-        const args = ['--query', query];
-        await runScript('search', args);
+        const args = [];
+        if (options.force)
+            args.push('--force');
+        if (options['skip-chroma-indexing'])
+            args.push('--skip-chroma-indexing');
+        args.push('--project-id', projectId);
+        await runScript('download-context7', args);
     }
     finally {
         chdir(originalCwd);
     }
+    console.log(gradient('green', 'cyan')('\n✅ Documentation downloaded and sliced!'));
 });
-// Add add-skill-content command
+// Add add-skill command
 program
-    .command('addSkill')
-    .argument('<package_name>', 'Package name')
+    .command('add-skill')
+    .option('--pwd <path>', 'Path to the skill directory')
+    .option('--package <name>', 'Package name to find skill directory for')
     .option('-t, --title <title>', 'Content title')
     .option('-c, --content <content>', 'Content text')
     .option('-f, --file <file>', 'Read content from file')
-    .action(async (packageName, options) => {
+    .option('--force', 'Force overwrite existing content')
+    .option('--force-append', 'Append content to existing file instead of creating new file')
+    .action(async (options) => {
     if (!options.title && !options.file) {
         console.error('❌ Please provide either --title or --file');
         process.exit(1);
     }
-    console.log(gradient('cyan', 'magenta')('\n📝 Adding content to skill...'));
-    console.log(`Package: ${packageName}`);
-    // Find skill directory
-    const { join, dirname } = await import('node:path');
-    const { homedir } = await import('node:os');
-    const { readdirSync } = await import('node:fs');
-    const baseDir = join(process.cwd(), '.claude', 'skills');
-    const dirs = readdirSync(baseDir, { withFileTypes: true })
-        .filter(dirent => dirent.isDirectory())
-        .map(dirent => dirent.name)
-        .filter(name => name.includes(packageName.replace(/[^a-z0-9]/gi, '')));
-    if (dirs.length === 0) {
-        console.error(`❌ No skill found for package ${packageName}`);
+    let skillDir;
+    if (options.pwd) {
+        skillDir = options.pwd;
+    }
+    else if (options.package) {
+        const { join } = await import('node:path');
+        const { homedir } = await import('node:os');
+        const { readdirSync, existsSync } = await import('node:fs');
+        const findDir = (base) => {
+            if (!existsSync(base))
+                return undefined;
+            const dirs = readdirSync(base, { withFileTypes: true })
+                .filter((dirent) => dirent.isDirectory())
+                .map((dirent) => dirent.name)
+                .filter((name) => name.includes(options.package.replace(/[^a-z0-9]/gi, '')));
+            return dirs.length > 0 ? join(base, dirs[0]) : undefined;
+        };
+        skillDir =
+            findDir(join(process.cwd(), '.claude', 'skills')) ||
+                findDir(join(homedir(), '.claude', 'skills'));
+    }
+    if (!skillDir) {
+        console.error('❌ Could not find skill directory. Please provide --pwd or a valid --package.');
         process.exit(1);
     }
-    const skillDir = join(baseDir, dirs[0]);
-    // Change to skill directory and run add script
+    console.log(gradient('cyan', 'magenta')('\n📝 Adding content to skill...'));
+    console.log(`Skill Path: ${skillDir}`);
     const { chdir } = await import('node:process');
     const originalCwd = process.cwd();
     chdir(skillDir);
@@ -353,6 +355,10 @@ program
             args.push('--content', options.content);
         if (options.file)
             args.push('--file', options.file);
+        if (options.force)
+            args.push('--force');
+        if (options.forceAppend)
+            args.push('--force-append');
         await runScript('add', args);
     }
     finally {
@@ -363,7 +369,7 @@ program
 // Add sub-commands for script execution
 program
     .command('run-script')
-    .argument('<script>', 'Script to run (search, add, update-context7, build-index, list-content)')
+    .argument('<script>', 'Script to run (search, add, download-context7, build-index, list-content)')
     .allowUnknownOption(true)
     .action(async (script) => {
     const { runScript } = await import('./core/runScript.js');
@@ -372,7 +378,6 @@ program
 // Export for testing
 export { program };
 // Run CLI if this file is executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-    program.parse();
-}
+// Always parse for now since we're using this as the main CLI entry point
+program.parse();
 //# sourceMappingURL=cli.js.map