skillfish 1.0.0

package/dist/commands/list.js

@@ -0,0 +1,278 @@
+/**
+ * `skillfish list` command - List installed skills.
+ */
+import { Command } from 'commander';
+import { homedir } from 'os';
+import { join } from 'path';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { getDetectedAgents, getAgentSkillDir } from '../lib/agents.js';
+import { listInstalledSkillsInDir } from '../lib/installer.js';
+import { EXIT_CODES } from '../lib/constants.js';
+import { isInputTTY } from '../utils.js';
+export const listCommand = new Command('list')
+    .description('List installed skills across all detected agents')
+    .option('--project', 'List project-level skills only (./.claude)')
+    .option('--global', 'List global skills only (~/.claude)')
+    .option('--agent <name>', 'Filter to a specific agent')
+    .helpOption('-h, --help', 'Display help for command')
+    .addHelpText('after', `
+Examples:
+  $ skillfish list                        List all installed skills
+  $ skillfish list --agent "Claude Code"  List skills for a specific agent
+  $ skillfish list --project              List skills in current project
+  $ skillfish list --global               List global skills only`)
+    .action(async (options, command) => {
+    const jsonMode = command.parent?.opts().json ?? false;
+    const projectFlag = options.project ?? false;
+    const globalFlag = options.global ?? false;
+    const agentFilter = options.agent;
+    // JSON output state (typed as ListJsonOutput)
+    const jsonOutput = {
+        success: true,
+        errors: [],
+    };
+    function addError(message) {
+        jsonOutput.errors.push(message);
+        jsonOutput.success = false;
+    }
+    function outputJsonAndExit(exitCode, data = {}) {
+        const output = {
+            success: jsonOutput.success,
+            exit_code: exitCode,
+            errors: jsonOutput.errors,
+            installed: data.installed ?? [],
+            agents_detected: data.agents_detected ?? [],
+        };
+        console.log(JSON.stringify(output, null, 2));
+        process.exit(exitCode);
+    }
+    function exitWithError(message, exitCode, data = {}) {
+        if (jsonMode) {
+            addError(message);
+            outputJsonAndExit(exitCode, data);
+        }
+        p.log.error(message);
+        process.exit(exitCode);
+    }
+    // Determine which locations to check
+    // By default, check both global and project. Flags narrow it down.
+    const checkGlobal = !projectFlag; // Check global unless --project is set
+    const checkProject = !globalFlag; // Check project unless --global is set
+    // Detect agents
+    const detected = getDetectedAgents();
+    if (detected.length === 0) {
+        exitWithError('No agents detected. Install Claude Code, Cursor, or another supported agent first.', EXIT_CODES.GENERAL_ERROR, { installed: [], agents_detected: [] });
+    }
+    // Helper to collect skills for given agents
+    function collectSkills(agents) {
+        const installed = [];
+        const globalSkills = [];
+        const projectSkills = [];
+        const seenPaths = new Set();
+        for (const agent of agents) {
+            if (checkGlobal) {
+                const globalDir = getAgentSkillDir(agent, homedir());
+                const skills = listInstalledSkillsInDir(globalDir);
+                for (const skill of skills) {
+                    const skillPath = join(globalDir, skill);
+                    if (!seenPaths.has(skillPath)) {
+                        seenPaths.add(skillPath);
+                        const item = { agent: agent.name, skill, path: skillPath, location: 'global' };
+                        installed.push(item);
+                        globalSkills.push(item);
+                    }
+                }
+            }
+            if (checkProject) {
+                const projectDir = getAgentSkillDir(agent, process.cwd());
+                const skills = listInstalledSkillsInDir(projectDir);
+                for (const skill of skills) {
+                    const skillPath = join(projectDir, skill);
+                    // Skip if already seen (avoids duplicates when cwd is under home)
+                    if (!seenPaths.has(skillPath)) {
+                        seenPaths.add(skillPath);
+                        const item = { agent: agent.name, skill, path: skillPath, location: 'project' };
+                        installed.push(item);
+                        projectSkills.push(item);
+                    }
+                }
+            }
+        }
+        return { installed, globalSkills, projectSkills };
+    }
+    // Helper to display skills for a single location
+    function displaySkillsForLocation(skills, locationLabel) {
+        console.log();
+        console.log(pc.bold(pc.underline(locationLabel)));
+        for (const item of skills) {
+            console.log(`  ${pc.green('•')} ${item.skill}`);
+        }
+        console.log();
+        p.outro(`${pc.cyan(skills.length.toString())} skill${skills.length === 1 ? '' : 's'}`);
+    }
+    // Filter to specific agent if --agent flag provided
+    if (agentFilter) {
+        const found = detected.filter((a) => a.name.toLowerCase() === agentFilter.toLowerCase());
+        if (found.length === 0) {
+            exitWithError(`Agent "${agentFilter}" not found. Detected: ${detected.map((a) => a.name).join(', ')}`, EXIT_CODES.NOT_FOUND, { installed: [], agents_detected: detected.map((a) => a.name) });
+        }
+        const { installed, globalSkills, projectSkills } = collectSkills(found);
+        if (jsonMode) {
+            outputJsonAndExit(EXIT_CODES.SUCCESS, {
+                installed,
+                agents_detected: detected.map((a) => a.name),
+            });
+        }
+        // Display intro
+        console.log();
+        p.intro(`${pc.bgCyan(pc.black(' skillfish '))} ${pc.dim(`Skills for ${found[0].name}`)}`);
+        if (globalSkills.length === 0 && projectSkills.length === 0) {
+            p.outro(pc.dim('No skills installed'));
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // If both locations have skills, show location selector (same as interactive)
+        const hasBothLocations = globalSkills.length > 0 && projectSkills.length > 0;
+        if (hasBothLocations && isInputTTY()) {
+            const locationOptions = [
+                { value: 'global', label: `Global (~/) ${pc.dim(`(${globalSkills.length})`)}` },
+                { value: 'project', label: `Project (./) ${pc.dim(`(${projectSkills.length})`)}` },
+            ];
+            const selectedLocation = await p.select({
+                message: 'Select location',
+                options: locationOptions,
+            });
+            if (p.isCancel(selectedLocation)) {
+                p.cancel('Cancelled');
+                process.exit(EXIT_CODES.SUCCESS);
+            }
+            const skillsToShow = selectedLocation === 'global' ? globalSkills : projectSkills;
+            const locationLabel = selectedLocation === 'global' ? 'Global (~/)' : 'Project (./)';
+            displaySkillsForLocation(skillsToShow, locationLabel);
+        }
+        else {
+            // Non-interactive or single location: show available skills
+            if (globalSkills.length > 0) {
+                displaySkillsForLocation(globalSkills, 'Global (~/)');
+            }
+            else {
+                displaySkillsForLocation(projectSkills, 'Project (./)');
+            }
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    // JSON mode without agent filter: return all skills
+    if (jsonMode) {
+        const { installed } = collectSkills(detected);
+        outputJsonAndExit(EXIT_CODES.SUCCESS, {
+            installed,
+            agents_detected: detected.map((a) => a.name),
+        });
+    }
+    // Interactive mode: show agent selector
+    if (isInputTTY()) {
+        console.log();
+        p.intro(`${pc.bgCyan(pc.black(' skillfish '))} ${pc.dim('Installed skills')}`);
+        // Step 1: Build options with skill counts in label (always visible)
+        const agentOptions = detected.map((agent) => {
+            const { installed } = collectSkills([agent]);
+            const count = installed.length;
+            return {
+                value: agent.name,
+                label: `${agent.name} ${pc.dim(`(${count})`)}`,
+            };
+        });
+        const selected = await p.select({
+            message: 'Select an agent',
+            options: agentOptions,
+        });
+        if (p.isCancel(selected)) {
+            p.cancel('Cancelled');
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        const selectedAgent = detected.find((a) => a.name === selected);
+        if (!selectedAgent) {
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Step 2: Get skills for selected agent
+        const { globalSkills, projectSkills } = collectSkills([selectedAgent]);
+        const hasBothLocations = globalSkills.length > 0 && projectSkills.length > 0;
+        if (globalSkills.length === 0 && projectSkills.length === 0) {
+            p.log.info(`No skills installed for ${pc.cyan(selectedAgent.name)}`);
+            p.outro(pc.dim('Done'));
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Step 3: If both locations have skills, let user choose location
+        let skillsToShow;
+        let locationLabel;
+        if (hasBothLocations) {
+            const locationOptions = [
+                { value: 'global', label: `Global (~/) ${pc.dim(`(${globalSkills.length})`)}` },
+                { value: 'project', label: `Project (./) ${pc.dim(`(${projectSkills.length})`)}` },
+            ];
+            const selectedLocation = await p.select({
+                message: 'Select location',
+                options: locationOptions,
+            });
+            if (p.isCancel(selectedLocation)) {
+                p.cancel('Cancelled');
+                process.exit(EXIT_CODES.SUCCESS);
+            }
+            skillsToShow = selectedLocation === 'global' ? globalSkills : projectSkills;
+            locationLabel = selectedLocation === 'global' ? 'Global (~/)' : 'Project (./)';
+        }
+        else {
+            // Only one location has skills, use that
+            if (globalSkills.length > 0) {
+                skillsToShow = globalSkills;
+                locationLabel = 'Global (~/)';
+            }
+            else {
+                skillsToShow = projectSkills;
+                locationLabel = 'Project (./)';
+            }
+        }
+        // Step 4: Display skills for selected location
+        displaySkillsForLocation(skillsToShow, locationLabel);
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    // Non-interactive mode: display all agents with skills
+    const { installed, globalSkills, projectSkills } = collectSkills(detected);
+    console.log();
+    p.intro(`${pc.bgCyan(pc.black(' skillfish '))} ${pc.dim('Installed skills')}`);
+    console.log();
+    console.log(pc.bold('Detected Agents'));
+    console.log(`  ${detected.map((a) => a.name).join(', ')}`);
+    // Group by agent
+    function displayByAgent(skills, location) {
+        const byAgent = new Map();
+        for (const item of skills) {
+            const list = byAgent.get(item.agent) || [];
+            list.push(item.skill);
+            byAgent.set(item.agent, list);
+        }
+        if (byAgent.size === 0)
+            return false;
+        console.log();
+        console.log(pc.bold(pc.underline(location)));
+        for (const [agent, agentSkills] of byAgent) {
+            console.log(`  ${pc.cyan(agent)} ${pc.dim(`(${agentSkills.length})`)}`);
+            for (const skill of agentSkills) {
+                console.log(`    ${pc.green('•')} ${skill}`);
+            }
+        }
+        return true;
+    }
+    if (checkGlobal)
+        displayByAgent(globalSkills, 'Global (~/)');
+    if (checkProject)
+        displayByAgent(projectSkills, 'Project (./)');
+    console.log();
+    if (installed.length === 0) {
+        p.outro(pc.dim('No skills installed'));
+    }
+    else {
+        p.outro(`${pc.cyan(installed.length.toString())} skill${installed.length === 1 ? '' : 's'} total`);
+    }
+    process.exit(EXIT_CODES.SUCCESS);
+});

package/dist/commands/remove.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `skillfish remove` command - Remove installed skills.
+ */
+import { Command } from 'commander';
+export declare const removeCommand: Command;

package/dist/commands/remove.js

@@ -0,0 +1,336 @@
+/**
+ * `skillfish remove` command - Remove installed skills.
+ */
+import { Command } from 'commander';
+import { homedir } from 'os';
+import { join } from 'path';
+import { existsSync, rmSync } from 'fs';
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { getDetectedAgents, getAgentSkillDir } from '../lib/agents.js';
+import { listInstalledSkillsInDir } from '../lib/installer.js';
+import { isTTY, isInputTTY } from '../utils.js';
+import { EXIT_CODES } from '../lib/constants.js';
+// === Command Definition ===
+export const removeCommand = new Command('remove')
+    .description('Remove an installed skill from your agents')
+    .argument('[skill]', 'Name of the skill to remove')
+    .option('-y, --yes', 'Skip confirmation prompts')
+    .option('--all', 'Remove all installed skills')
+    .option('--project', 'Remove from current project only (./.claude)')
+    .option('--global', 'Remove from home directory only (~/.claude)')
+    .option('--agent <name>', 'Remove from a specific agent only')
+    .helpOption('-h, --help', 'Display help for command')
+    .addHelpText('after', `
+Examples:
+  $ skillfish remove                    Interactive skill picker
+  $ skillfish remove my-skill           Remove a skill by name
+  $ skillfish remove --all              Remove all installed skills
+  $ skillfish remove my-skill --project Remove from current project only
+  $ skillfish remove my-skill --agent "Claude Code"  Remove from specific agent`)
+    .action(async (skillArg, options, command) => {
+    const jsonMode = command.parent?.opts().json ?? false;
+    const version = command.parent?.opts().version ?? '0.0.0';
+    const result = {
+        success: true,
+        removed: [],
+        errors: [],
+    };
+    function addError(message) {
+        result.errors.push(message);
+        result.success = false;
+    }
+    function outputJsonAndExit(exitCode) {
+        result.exit_code = exitCode;
+        console.log(JSON.stringify(result, null, 2));
+        process.exit(exitCode);
+    }
+    /**
+     * Unified error handler that handles both JSON and TTY modes.
+     */
+    function exitWithError(message, exitCode, useClackLog = false) {
+        if (jsonMode) {
+            addError(message);
+            outputJsonAndExit(exitCode);
+        }
+        if (useClackLog) {
+            p.log.error(message);
+        }
+        else {
+            console.error(`Error: ${message}`);
+        }
+        process.exit(exitCode);
+    }
+    // Show banner (TTY only, not in JSON mode)
+    if (isTTY() && !jsonMode) {
+        console.log();
+        console.log(pc.cyan('     ≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋'));
+        console.log(`       ${pc.cyan('><>')}  ${pc.bold('SKILL FISH')}  ${pc.cyan('><>')}`);
+        console.log(pc.cyan('     ≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋≋'));
+        console.log();
+        p.intro(`${pc.bgCyan(pc.black(' skillfish '))} ${pc.dim(`v${version}`)}`);
+    }
+    const skipConfirm = options.yes ?? false;
+    const removeAll = options.all ?? false;
+    const projectFlag = options.project ?? false;
+    const globalFlag = options.global ?? false;
+    const targetAgentName = options.agent;
+    // Determine which locations to check
+    // By default, check both global and project. Flags narrow it down.
+    const checkGlobal = !projectFlag; // Check global unless --project is set
+    const checkProject = !globalFlag; // Check project unless --global is set
+    // Detect agents
+    const detected = getDetectedAgents();
+    if (detected.length === 0) {
+        exitWithError('No agents detected. Install Claude Code, Cursor, or another supported agent first.', EXIT_CODES.GENERAL_ERROR, true // useClackLog
+        );
+    }
+    // Filter to target agent if specified
+    let targetAgents = detected;
+    if (targetAgentName) {
+        const found = detected.filter((a) => a.name.toLowerCase() === targetAgentName.toLowerCase());
+        if (found.length === 0) {
+            exitWithError(`Agent "${targetAgentName}" not found. Detected agents: ${detected.map((a) => a.name).join(', ')}`, EXIT_CODES.NOT_FOUND, true // useClackLog
+            );
+        }
+        targetAgents = found;
+    }
+    // Helper to collect all installed skills across locations
+    function collectAllSkills() {
+        const skills = [];
+        const seenPaths = new Set();
+        for (const agent of targetAgents) {
+            if (checkGlobal) {
+                const globalDir = getAgentSkillDir(agent, homedir());
+                const installed = listInstalledSkillsInDir(globalDir);
+                for (const skill of installed) {
+                    const skillPath = join(globalDir, skill);
+                    if (!seenPaths.has(skillPath)) {
+                        seenPaths.add(skillPath);
+                        skills.push({ skill, agent, path: skillPath, location: 'global' });
+                    }
+                }
+            }
+            if (checkProject) {
+                const projectDir = getAgentSkillDir(agent, process.cwd());
+                const installed = listInstalledSkillsInDir(projectDir);
+                for (const skill of installed) {
+                    const skillPath = join(projectDir, skill);
+                    if (!seenPaths.has(skillPath)) {
+                        seenPaths.add(skillPath);
+                        skills.push({ skill, agent, path: skillPath, location: 'project' });
+                    }
+                }
+            }
+        }
+        return skills;
+    }
+    // Helper to perform the actual removal
+    async function performRemoval(skillsToRemove) {
+        for (const item of skillsToRemove) {
+            try {
+                if (existsSync(item.path)) {
+                    rmSync(item.path, { recursive: true });
+                    result.removed.push({
+                        skill: item.skill,
+                        agent: item.agent.name,
+                        path: item.path,
+                    });
+                    if (!jsonMode) {
+                        console.log(`  ${pc.green('✓')} Removed ${item.skill} ${pc.dim(`from ${item.agent.name}`)}`);
+                    }
+                }
+            }
+            catch (err) {
+                const errorMsg = `Failed to remove ${item.skill}: ${err instanceof Error ? err.message : String(err)}`;
+                addError(errorMsg);
+                if (!jsonMode) {
+                    console.log(`  ${pc.red('✗')} ${errorMsg}`);
+                }
+            }
+        }
+    }
+    // Helper to collect skills for a specific agent
+    function collectSkillsForAgent(agent) {
+        const skills = [];
+        const seenPaths = new Set();
+        if (checkGlobal) {
+            const globalDir = getAgentSkillDir(agent, homedir());
+            const installed = listInstalledSkillsInDir(globalDir);
+            for (const skill of installed) {
+                const skillPath = join(globalDir, skill);
+                if (!seenPaths.has(skillPath)) {
+                    seenPaths.add(skillPath);
+                    skills.push({ skill, agent, path: skillPath, location: 'global' });
+                }
+            }
+        }
+        if (checkProject) {
+            const projectDir = getAgentSkillDir(agent, process.cwd());
+            const installed = listInstalledSkillsInDir(projectDir);
+            for (const skill of installed) {
+                const skillPath = join(projectDir, skill);
+                if (!seenPaths.has(skillPath)) {
+                    seenPaths.add(skillPath);
+                    skills.push({ skill, agent, path: skillPath, location: 'project' });
+                }
+            }
+        }
+        return skills;
+    }
+    // Interactive mode: no skill name and no --all flag
+    if (!skillArg && !removeAll) {
+        // In non-interactive mode, require explicit skill name or --all
+        if (!isInputTTY() || jsonMode) {
+            exitWithError('Please specify a skill name or use --all to remove all skills (non-interactive mode)', EXIT_CODES.INVALID_ARGS);
+        }
+        // Step 1: Show agent selector with skill counts
+        const agentOptions = targetAgents.map((agent) => {
+            const skills = collectSkillsForAgent(agent);
+            const count = skills.length;
+            return {
+                value: agent.name,
+                label: `${agent.name} ${pc.dim(`(${count})`)}`,
+            };
+        });
+        const selectedAgentName = await p.select({
+            message: 'Select an agent',
+            options: agentOptions,
+        });
+        if (p.isCancel(selectedAgentName)) {
+            p.cancel('Cancelled');
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        const selectedAgent = targetAgents.find((a) => a.name === selectedAgentName);
+        if (!selectedAgent) {
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Step 2: Get skills for selected agent, split by location
+        const agentSkills = collectSkillsForAgent(selectedAgent);
+        const globalSkills = agentSkills.filter((s) => s.location === 'global');
+        const projectSkills = agentSkills.filter((s) => s.location === 'project');
+        if (agentSkills.length === 0) {
+            p.log.info(`No skills installed for ${pc.cyan(selectedAgent.name)}`);
+            p.outro(pc.dim('Done'));
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Step 3: If both locations have skills, let user choose location
+        let skillsToShow;
+        const hasBothLocations = globalSkills.length > 0 && projectSkills.length > 0;
+        if (hasBothLocations) {
+            const locationOptions = [
+                { value: 'global', label: `Global (~/) ${pc.dim(`(${globalSkills.length})`)}` },
+                { value: 'project', label: `Project (./) ${pc.dim(`(${projectSkills.length})`)}` },
+            ];
+            const selectedLocation = await p.select({
+                message: 'Select location',
+                options: locationOptions,
+            });
+            if (p.isCancel(selectedLocation)) {
+                p.cancel('Cancelled');
+                process.exit(EXIT_CODES.SUCCESS);
+            }
+            skillsToShow = selectedLocation === 'global' ? globalSkills : projectSkills;
+        }
+        else {
+            // Only one location has skills, use that
+            skillsToShow = globalSkills.length > 0 ? globalSkills : projectSkills;
+        }
+        // Step 4: Show skill selector for the chosen location
+        const skillOptions = skillsToShow.map((item) => ({
+            value: item.path,
+            label: item.skill,
+        }));
+        const toRemove = await p.multiselect({
+            message: `Select skills to remove ${pc.dim('(space to select, enter to confirm)')}`,
+            options: skillOptions,
+            required: false,
+        });
+        if (p.isCancel(toRemove)) {
+            p.cancel('Cancelled');
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        if (toRemove.length === 0) {
+            p.outro(pc.dim('No skills selected'));
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        const selectedSkills = skillsToShow.filter((s) => toRemove.includes(s.path));
+        // Confirm removal
+        console.log();
+        p.log.warn(pc.yellow('Skills to remove:'));
+        for (const item of selectedSkills) {
+            console.log(`  ${pc.red('•')} ${item.skill}`);
+        }
+        const confirm = await p.confirm({
+            message: `Remove ${selectedSkills.length} skill${selectedSkills.length === 1 ? '' : 's'}?`,
+            initialValue: false,
+        });
+        if (p.isCancel(confirm) || !confirm) {
+            p.cancel('Cancelled');
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+        // Perform removal
+        await performRemoval(selectedSkills);
+        // Output results
+        console.log();
+        if (result.removed.length > 0) {
+            p.outro(pc.green(`Done! Removed ${result.removed.length} skill${result.removed.length === 1 ? '' : 's'}`));
+        }
+        else {
+            p.outro(pc.yellow('No skills removed'));
+        }
+        process.exit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.GENERAL_ERROR);
+    }
+    // Non-interactive mode: find skills to remove based on skillArg or --all
+    const allSkills = collectAllSkills();
+    let skillsToRemove;
+    if (removeAll) {
+        skillsToRemove = allSkills;
+    }
+    else {
+        // Filter to matching skill name
+        skillsToRemove = allSkills.filter((s) => s.skill === skillArg);
+    }
+    if (skillsToRemove.length === 0) {
+        const errorMsg = removeAll
+            ? 'No skills installed to remove'
+            : `Skill "${skillArg}" not found`;
+        if (jsonMode) {
+            addError(errorMsg);
+            outputJsonAndExit(EXIT_CODES.NOT_FOUND);
+        }
+        p.log.warn(errorMsg);
+        process.exit(EXIT_CODES.NOT_FOUND);
+    }
+    // Confirmation prompt (unless --yes is used)
+    if (!skipConfirm && !jsonMode && isInputTTY()) {
+        console.log();
+        p.log.warn(pc.yellow('The following skills will be removed:'));
+        for (const item of skillsToRemove) {
+            console.log(`  ${pc.red('•')} ${item.skill} ${pc.dim(`(${item.agent.name}, ${item.location})`)}`);
+        }
+        console.log();
+        const proceed = await p.confirm({
+            message: `Remove ${skillsToRemove.length} skill${skillsToRemove.length === 1 ? '' : 's'}?`,
+            initialValue: false,
+        });
+        if (p.isCancel(proceed) || !proceed) {
+            p.cancel('Cancelled');
+            process.exit(EXIT_CODES.SUCCESS);
+        }
+    }
+    // Perform removal
+    await performRemoval(skillsToRemove);
+    // Output results
+    if (jsonMode) {
+        outputJsonAndExit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.GENERAL_ERROR);
+    }
+    console.log();
+    if (result.removed.length > 0) {
+        p.outro(pc.green(`Done! Removed ${result.removed.length} skill${result.removed.length === 1 ? '' : 's'}`));
+    }
+    else {
+        p.outro(pc.yellow('No skills removed'));
+    }
+    process.exit(result.success ? EXIT_CODES.SUCCESS : EXIT_CODES.GENERAL_ERROR);
+});

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * skillfish CLI - Install AI agent skills from GitHub
+ *
+ * Entry point that sets up Commander.js and imports commands.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+/**
+ * skillfish CLI - Install AI agent skills from GitHub
+ *
+ * Entry point that sets up Commander.js and imports commands.
+ */
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { addCommand } from './commands/add.js';
+import { listCommand } from './commands/list.js';
+import { removeCommand } from './commands/remove.js';
+// Read version from package.json (single source of truth)
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new Command()
+    .name('skillfish')
+    .description('Install and manage AI agent skills from GitHub repositories')
+    .version(pkg.version, '-v, --version', 'Show version number')
+    .option('--json', 'Output as JSON (for automation)')
+    .helpOption('-h, --help', 'Display help for command')
+    .helpCommand('help [command]', 'Display help for command')
+    .configureOutput({
+    // Write help to stdout so it can be piped
+    writeOut: (str) => process.stdout.write(str),
+    writeErr: (str) => process.stderr.write(str),
+})
+    .configureHelp({
+    sortSubcommands: true,
+})
+    .addHelpText('after', `
+Examples:
+  $ skillfish add owner/repo                 Install skills from a repository
+  $ skillfish add owner/repo/plugin/skill    Install a specific skill
+  $ skillfish list                           Show installed skills
+  $ skillfish remove my-skill                Remove a skill
+
+Documentation: https://skill.fish`);
+// Store version in options for commands to access
+program.hook('preAction', (thisCommand) => {
+    thisCommand.setOptionValue('version', pkg.version);
+});
+// Add subcommands
+program.addCommand(addCommand);
+program.addCommand(listCommand);
+program.addCommand(removeCommand);
+// Handle --json flag for help output
+program.on('option:json', () => {
+    // JSON mode is handled by commands
+});
+// Parse and run
+program.parseAsync(process.argv).catch((err) => {
+    console.error('Error:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});