@swarmify/agents-cli 1.12.0 → 1.13.1

package/dist/commands/skills.js

@@ -3,258 +3,98 @@ import ora from 'ora';
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
-import { select, checkbox } from '@inquirer/prompts';
-import { AGENTS, SKILLS_CAPABLE_AGENTS, resolveAgentName, getAllCliStates, formatAgentError, agentLabel, } from '../lib/agents.js';
+import { select, checkbox, confirm } from '@inquirer/prompts';
+import { SKILLS_CAPABLE_AGENTS, resolveAgentName, formatAgentError, agentLabel, } from '../lib/agents.js';
 import { cloneRepo } from '../lib/git.js';
-import { discoverSkillsFromRepo, installSkillCentrally, uninstallSkill, listInstalledSkills, listInstalledSkillsWithScope, getSkillInfo, getSkillRules, tryParseSkillMetadata, } from '../lib/skills.js';
-import { listInstalledVersions, getGlobalDefault, syncResourcesToVersion, promptAgentVersionSelection, getVersionHomePath, resolveAgentVersionTargets, } from '../lib/versions.js';
+import { discoverSkillsFromRepo, installSkillCentrally, uninstallSkill, listInstalledSkills, listInstalledSkillsWithScope, getSkillInfo, getSkillRules, getSkillsDir, countSkillFiles, tryParseSkillMetadata, diffVersionSkills, installSkillToVersion, removeSkillFromVersion, iterSkillsCapableVersions, } from '../lib/skills.js';
+import { getGlobalDefault, syncResourcesToVersion, promptAgentVersionSelection, resolveAgentVersionTargets, } from '../lib/versions.js';
 import { recordVersionResources } from '../lib/state.js';
 import { isPromptCancelled, isInteractiveTerminal, parseCommaSeparatedList, printWithPager, requireInteractiveSelection, } from './utils.js';
+import { showResourceList, buildTargetsSection, } from './resource-view.js';
+/** Register the `agents skills` command tree (list, add, remove, sync, prune, view). */
 export function registerSkillsCommands(program) {
     const skillsCmd = program
         .command('skills')
-        .description('Manage skills (SKILL.md + rules/)');
+        .description('Add domain-specific capabilities to agents via packaged SKILL.md files')
+        .addHelpText('after', `
+Skills are structured bundles (SKILL.md + rules/) that teach agents specialized domains: API conventions, testing patterns, code review checklists. Each skill can ship with its own rules that only apply when the skill is invoked.
+
+Examples:
+  # See what skills are installed
+  agents skills list
+
+  # Check skills for a specific agent version
+  agents skills list claude@2.1.112
+
+  # Install a skill from GitHub
+  agents skills add gh:anthropics/skills --agents codex,claude
+
+  # Interactive: pick from ~/.agents/skills/
+  agents skills add
+
+  # Install a specific skill by name
+  agents skills add --names api-testing --agents codex@0.116.0
+
+When to use:
+  - Onboarding: 'agents skills add gh:team/skills' to share expertise across the team
+  - Specialization: install domain skills (rush-product-knowledge, rdev) per project
+  - Version isolation: install different skills to different versions for experimentation
+`);
     skillsCmd
         .command('list [agent]')
-        .description('List installed skills. Use agent@version for specific version, agent@default for default only.')
-        .option('-a, --agent <agent>', 'Filter by agent')
-        .option('-s, --scope <scope>', 'Filter by scope: user, project, or all', 'all')
+        .description('Show which skills are installed and which agent versions they are synced to')
+        .option('-a, --agent <agent>', 'Filter to a specific agent (alternative to positional arg)')
         .action(async (agentArg, options) => {
         const spinner = ora({ text: 'Loading...', isSilent: !process.stdout.isTTY }).start();
-        const cwd = process.cwd();
-        // Parse agent input - handle agent@version syntax
         const agentInput = agentArg || options.agent;
-        let agentId = null;
-        let requestedVersion = null; // null = all versions, 'default' = default only, 'x.y.z' = specific
+        let filterAgent;
+        let filterVersion;
         if (agentInput) {
             const parts = agentInput.split('@');
-            const agentName = parts[0];
-            requestedVersion = parts[1] || null; // null means show all versions
-            agentId = resolveAgentName(agentName);
-            if (!agentId) {
+            const resolved = resolveAgentName(parts[0]);
+            if (!resolved) {
                 spinner.stop();
-                console.log(chalk.red(formatAgentError(agentName, SKILLS_CAPABLE_AGENTS)));
+                console.log(chalk.red(formatAgentError(parts[0], SKILLS_CAPABLE_AGENTS)));
                 process.exit(1);
             }
+            filterAgent = resolved;
+            filterVersion = parts[1] || undefined;
         }
-        const showPaths = !!agentInput;
-        // Get CLI states to determine managed vs unmanaged
-        const cliStates = await getAllCliStates();
-        // Helper to render skills for a specific version
-        const renderVersionSkills = (agentId, version, isDefault, home) => {
-            const agent = AGENTS[agentId];
-            const errors = [];
-            const skills = listInstalledSkillsWithScope(agentId, cwd, { home, errors }).filter((s) => options.scope === 'all' || s.scope === options.scope);
-            const defaultLabel = isDefault ? ' default' : '';
-            const versionStr = chalk.gray(` (${version}${defaultLabel})`);
-            if (skills.length === 0) {
-                console.log(`  ${chalk.bold(agentLabel(agent.id))}${versionStr}: ${chalk.gray('none')}`);
-            }
-            else {
-                console.log(`  ${chalk.bold(agentLabel(agent.id))}${versionStr}:`);
-                const userSkills = skills.filter((s) => s.scope === 'user');
-                const projectSkills = skills.filter((s) => s.scope === 'project');
-                if (userSkills.length > 0 && (options.scope === 'all' || options.scope === 'user')) {
-                    console.log(`    ${chalk.gray('User:')}`);
-                    for (const skill of userSkills) {
-                        const desc = skill.metadata.description ? ` ${chalk.gray(skill.metadata.description)}` : '';
-                        const ruleInfo = skill.ruleCount > 0 ? chalk.gray(` (${skill.ruleCount} rules)`) : '';
-                        console.log(`      ${chalk.cyan(skill.name.padEnd(20))}${desc}${ruleInfo}`);
-                        if (showPaths)
-                            console.log(chalk.gray(`        ${skill.path}`));
-                    }
-                }
-                if (projectSkills.length > 0 && (options.scope === 'all' || options.scope === 'project')) {
-                    console.log(`    ${chalk.gray('Project:')}`);
-                    for (const skill of projectSkills) {
-                        const desc = skill.metadata.description ? ` ${chalk.gray(skill.metadata.description)}` : '';
-                        const ruleInfo = skill.ruleCount > 0 ? chalk.gray(` (${skill.ruleCount} rules)`) : '';
-                        console.log(`      ${chalk.yellow(skill.name.padEnd(20))}${desc}${ruleInfo}`);
-                        if (showPaths)
-                            console.log(chalk.gray(`        ${skill.path}`));
-                    }
-                }
-            }
-            // Show skills with parse errors
-            if (errors.length > 0) {
-                console.log(`    ${chalk.red('Errors:')}`);
-                for (const err of errors) {
-                    console.log(`      ${chalk.red(err.name.padEnd(20))} ${chalk.gray(err.error)}`);
-                    if (showPaths)
-                        console.log(chalk.gray(`        ${err.path}`));
-                }
-            }
-            console.log();
-        };
-        // Helper to render skills for an agent (default version only, for multi-agent view)
-        const renderAgentSkillsDefault = (agentId) => {
-            const agent = AGENTS[agentId];
-            if (!agent.capabilities.skills) {
-                console.log(`  ${chalk.bold(agentLabel(agent.id))}: ${chalk.gray('skills not supported')}`);
-                console.log();
-                return;
-            }
-            const defaultVer = getGlobalDefault(agentId);
-            if (defaultVer) {
-                const home = getVersionHomePath(agentId, defaultVer);
-                renderVersionSkills(agentId, defaultVer, true, home);
-            }
-            else {
-                // No default set, show from effective home
-                const errors = [];
-                const skills = listInstalledSkillsWithScope(agentId, cwd, { errors }).filter((s) => options.scope === 'all' || s.scope === options.scope);
-                if (skills.length === 0 && errors.length === 0) {
-                    console.log(`  ${chalk.bold(agentLabel(agent.id))}: ${chalk.gray('none')}`);
-                }
-                else {
-                    console.log(`  ${chalk.bold(agentLabel(agent.id))}:`);
-                    const userSkills = skills.filter((s) => s.scope === 'user');
-                    if (userSkills.length > 0) {
-                        console.log(`    ${chalk.gray('User:')}`);
-                        for (const skill of userSkills) {
-                            const desc = skill.metadata.description ? ` ${chalk.gray(skill.metadata.description)}` : '';
-                            const ruleInfo = skill.ruleCount > 0 ? chalk.gray(` (${skill.ruleCount} rules)`) : '';
-                            console.log(`      ${chalk.cyan(skill.name.padEnd(20))}${desc}${ruleInfo}`);
-                        }
-                    }
-                    if (errors.length > 0) {
-                        console.log(`    ${chalk.red('Errors:')}`);
-                        for (const err of errors) {
-                            console.log(`      ${chalk.red(err.name.padEnd(20))} ${chalk.gray(err.error)}`);
-                        }
-                    }
-                }
-                console.log();
-            }
-        };
+        const rows = await buildSkillRows({ filterAgent, filterVersion });
         spinner.stop();
-        // Single agent specified - show versions based on requestedVersion
-        if (agentId) {
-            const agent = AGENTS[agentId];
-            if (!agent.capabilities.skills) {
-                console.log(`  ${chalk.bold(agentLabel(agent.id))}: ${chalk.gray('skills not supported')}`);
-                return;
-            }
-            const installedVersions = listInstalledVersions(agentId);
-            const defaultVer = getGlobalDefault(agentId);
-            if (installedVersions.length === 0) {
-                // Not version-managed, check if globally installed
-                const cliState = cliStates[agentId];
-                if (cliState?.installed) {
-                    console.log(chalk.bold('Not Managed by Agents CLI\n'));
-                    const skills = listInstalledSkillsWithScope(agentId, cwd).filter((s) => options.scope === 'all' || s.scope === options.scope);
-                    if (skills.length === 0) {
-                        console.log(`  ${chalk.bold(agentLabel(agent.id))}: ${chalk.gray('none')}`);
-                    }
-                    else {
-                        console.log(`  ${chalk.bold(agentLabel(agent.id))}:`);
-                        const userSkills = skills.filter((s) => s.scope === 'user');
-                        if (userSkills.length > 0) {
-                            console.log(`    ${chalk.gray('User:')}`);
-                            for (const skill of userSkills) {
-                                const desc = skill.metadata.description ? ` - ${chalk.gray(skill.metadata.description)}` : '';
-                                const ruleInfo = skill.ruleCount > 0 ? chalk.gray(` (${skill.ruleCount} rules)`) : '';
-                                console.log(`      ${chalk.cyan(skill.name)}${desc}${ruleInfo}`);
-                                if (showPaths)
-                                    console.log(chalk.gray(`        ${skill.path}`));
-                            }
-                        }
-                    }
-                }
-                else {
-                    console.log(chalk.gray(`  ${agentLabel(agent.id)} is not installed.`));
-                }
-                return;
-            }
-            console.log(chalk.bold(`Installed Agent Skills for ${agentLabel(agent.id)}\n`));
-            // Determine which versions to show
-            let versionsToShow;
-            if (requestedVersion === 'default') {
-                // Show only default version
-                if (!defaultVer) {
-                    console.log(chalk.yellow(`  No default version set for ${agentLabel(agent.id)}. Run: agents use ${agentId}@<version>`));
-                    return;
-                }
-                versionsToShow = [defaultVer];
-            }
-            else if (requestedVersion) {
-                // Show specific version
-                if (!installedVersions.includes(requestedVersion)) {
-                    console.log(chalk.red(`  Version ${requestedVersion} not installed for ${agentLabel(agent.id)}.`));
-                    console.log(chalk.gray(`  Installed versions: ${installedVersions.join(', ')}`));
-                    return;
-                }
-                versionsToShow = [requestedVersion];
-            }
-            else {
-                // Show all versions, default first
-                versionsToShow = [...installedVersions].sort((a, b) => {
-                    if (a === defaultVer)
-                        return -1;
-                    if (b === defaultVer)
-                        return 1;
-                    return 0;
-                });
-            }
-            for (const version of versionsToShow) {
-                const home = getVersionHomePath(agentId, version);
-                renderVersionSkills(agentId, version, version === defaultVer, home);
-            }
-            return;
-        }
-        // No agent specified - show default version for each agent
-        const versionManaged = [];
-        const globallyInstalled = [];
-        for (const aid of SKILLS_CAPABLE_AGENTS) {
-            const versions = listInstalledVersions(aid);
-            const cliState = cliStates[aid];
-            if (versions.length > 0) {
-                versionManaged.push(aid);
-            }
-            else if (cliState?.installed) {
-                globallyInstalled.push(aid);
-            }
-        }
-        if (versionManaged.length > 0) {
-            console.log(chalk.bold('Installed Agent Skills\n'));
-            for (const aid of versionManaged) {
-                renderAgentSkillsDefault(aid);
-            }
-        }
-        if (globallyInstalled.length > 0) {
-            console.log(chalk.bold('Not Managed by Agents CLI\n'));
-            for (const aid of globallyInstalled) {
-                const agent = AGENTS[aid];
-                const skills = listInstalledSkillsWithScope(aid, cwd).filter((s) => options.scope === 'all' || s.scope === options.scope);
-                if (skills.length === 0) {
-                    console.log(`  ${chalk.bold(agentLabel(aid))}: ${chalk.gray('none')}`);
-                }
-                else {
-                    console.log(`  ${chalk.bold(agentLabel(aid))}:`);
-                    const userSkills = skills.filter((s) => s.scope === 'user');
-                    if (userSkills.length > 0) {
-                        console.log(`    ${chalk.gray('User:')}`);
-                        for (const skill of userSkills) {
-                            const desc = skill.metadata.description ? ` ${chalk.gray(skill.metadata.description)}` : '';
-                            const ruleInfo = skill.ruleCount > 0 ? chalk.gray(` (${skill.ruleCount} rules)`) : '';
-                            console.log(`      ${chalk.cyan(skill.name.padEnd(20))}${desc}${ruleInfo}`);
-                        }
-                    }
-                }
-                console.log();
-            }
-        }
-        if (versionManaged.length === 0 && globallyInstalled.length === 0) {
-            console.log(chalk.gray('  No agents with skills installed.'));
-            console.log();
-        }
+        await showResourceList({
+            resourcePlural: 'skills',
+            resourceSingular: 'skill',
+            extraLabel: 'Files',
+            rows,
+            emptyMessage: filterAgent
+                ? `No skills in central storage for ${agentLabel(filterAgent)}.`
+                : 'No skills in ~/.agents/skills/. Add one with: agents skills add gh:user/repo',
+            centralPath: getSkillsDir(),
+            filterAgent,
+            filterVersion,
+        });
     });
     skillsCmd
         .command('add [source]')
-        .description('Install skills from a repo or local path')
-        .option('-a, --agents <list>', 'Comma-separated agent or agent@version targets to install to')
-        .option('--names <list>', 'Comma-separated skill names from ~/.agents/skills/')
-        .option('-y, --yes', 'Skip prompts and use defaults')
+        .description('Install skills from a source (GitHub, local) or pick from central storage')
+        .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or gemini@default')
+        .option('--names <list>', 'Skill names from ~/.agents/skills/ (comma-separated)')
+        .option('-y, --yes', 'Skip all prompts')
+        .addHelpText('after', `
+Examples:
+  # Interactive picker from ~/.agents/skills/
+  agents skills add
+
+  # Install a specific skill to one version
+  agents skills add --names api-testing --agents codex@0.116.0
+
+  # Clone and install skills from GitHub
+  agents skills add gh:anthropics/skills --agents claude,codex
+
+  # Add a local skill directory (must contain SKILL.md)
+  agents skills add ~/my-skill --agents claude@default
+`)
         .action(async (source, options) => {
         try {
             let skills;
@@ -444,7 +284,15 @@ export function registerSkillsCommands(program) {
     });
     skillsCmd
         .command('remove [name]')
-        .description('Remove a skill')
+        .description('Delete a skill from central storage (interactive picker if no name given)')
+        .addHelpText('after', `
+Examples:
+  # Remove a skill by name
+  agents skills remove api-testing
+
+  # Interactive: pick skills to remove
+  agents skills remove
+`)
         .action(async (name) => {
         let skillsToRemove;
         if (name) {
@@ -497,9 +345,193 @@ export function registerSkillsCommands(program) {
             }
         }
     });
+    skillsCmd
+        .command('sync')
+        .description('Reconcile version-home skills against central ~/.agents/skills/ (add + update, never delete)')
+        .option('-a, --agent <agent>', 'Scope to a specific agent or agent@version')
+        .option('-m, --method <method>', 'Install method: copy (default) or symlink', 'copy')
+        .addHelpText('after', `
+Examples:
+  # Sync every installed version of every skills-capable agent
+  agents skills sync
+
+  # Scope to one agent
+  agents skills sync --agent claude
+
+  # Scope to one version
+  agents skills sync --agent claude@2.1.113
+
+  # Symlink into version homes (central updates propagate automatically)
+  agents skills sync --method symlink
+
+Sync is additive: it installs missing skills and refreshes changed ones. To
+remove orphans (skills in a version home but not in central), use 'agents
+skills prune'.
+`)
+        .action(async (options) => {
+        const method = (options.method === 'symlink' ? 'symlink' : 'copy');
+        let filter;
+        if (options.agent) {
+            const [name, version] = String(options.agent).split('@');
+            const agentId = resolveAgentName(name);
+            if (!agentId) {
+                console.log(chalk.red(formatAgentError(name, SKILLS_CAPABLE_AGENTS)));
+                process.exit(1);
+            }
+            filter = { agent: agentId, version: version || undefined };
+        }
+        const pairs = iterSkillsCapableVersions(filter);
+        if (pairs.length === 0) {
+            console.log(chalk.gray('No matching installed versions.'));
+            return;
+        }
+        const diffs = pairs.map(({ agent, version }) => diffVersionSkills(agent, version));
+        const plan = diffs.filter((d) => d.toAdd.length > 0 || d.toUpdate.length > 0);
+        if (plan.length === 0) {
+            console.log(chalk.green('All version homes are up to date with central.'));
+            if (diffs.some((d) => d.orphans.length > 0)) {
+                console.log(chalk.gray('Orphan skills present. Run \'agents skills prune --dry-run\' to review.'));
+            }
+            return;
+        }
+        console.log(chalk.bold(`Syncing skills (method: ${method})\n`));
+        let adds = 0, updates = 0, failures = 0;
+        for (const diff of plan) {
+            const label = `${diff.agent}@${diff.version}`;
+            if (diff.toAdd.length > 0) {
+                console.log(`  ${chalk.cyan(label)} ${chalk.gray('add:')} ${diff.toAdd.join(', ')}`);
+                for (const name of diff.toAdd) {
+                    const r = installSkillToVersion(diff.agent, diff.version, name, method);
+                    if (r.success)
+                        adds++;
+                    else {
+                        failures++;
+                        console.log(chalk.red(`    ! ${name}: ${r.error}`));
+                    }
+                }
+            }
+            if (diff.toUpdate.length > 0) {
+                console.log(`  ${chalk.cyan(label)} ${chalk.gray('update:')} ${diff.toUpdate.join(', ')}`);
+                for (const name of diff.toUpdate) {
+                    const r = installSkillToVersion(diff.agent, diff.version, name, method);
+                    if (r.success)
+                        updates++;
+                    else {
+                        failures++;
+                        console.log(chalk.red(`    ! ${name}: ${r.error}`));
+                    }
+                }
+            }
+        }
+        console.log();
+        console.log(chalk.green(`Synced: ${adds} added, ${updates} updated${failures > 0 ? chalk.red(`, ${failures} failed`) : ''}.`));
+        const totalOrphans = diffs.reduce((n, d) => n + d.orphans.length, 0);
+        if (totalOrphans > 0) {
+            console.log(chalk.gray(`${totalOrphans} orphan(s) remain. Run 'agents skills prune --dry-run' to review.`));
+        }
+    });
+    skillsCmd
+        .command('prune')
+        .description('Remove orphan skills from version homes (skills present locally but not in central)')
+        .option('-a, --agent <agent>', 'Scope to a specific agent or agent@version')
+        .option('--dry-run', 'Show orphans without deleting')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .addHelpText('after', `
+Examples:
+  # See what would be pruned
+  agents skills prune --dry-run
+
+  # Prune across every installed version (prompts for confirmation)
+  agents skills prune
+
+  # Scope to one agent or version
+  agents skills prune --agent claude@2.0.65
+
+  # Skip confirmation (for scripts)
+  agents skills prune -y
+
+Orphans are skills that exist inside a version home but are missing from the
+central ~/.agents/skills/ source of truth. Usually they are leftovers from a
+skill that was deleted centrally but never removed from the version install.
+`)
+        .action(async (options) => {
+        let filter;
+        if (options.agent) {
+            const [name, version] = String(options.agent).split('@');
+            const agentId = resolveAgentName(name);
+            if (!agentId) {
+                console.log(chalk.red(formatAgentError(name, SKILLS_CAPABLE_AGENTS)));
+                process.exit(1);
+            }
+            filter = { agent: agentId, version: version || undefined };
+        }
+        const pairs = iterSkillsCapableVersions(filter);
+        const diffs = pairs
+            .map(({ agent, version }) => diffVersionSkills(agent, version))
+            .filter((d) => d.orphans.length > 0);
+        if (diffs.length === 0) {
+            console.log(chalk.green('No orphan skills.'));
+            return;
+        }
+        const total = diffs.reduce((n, d) => n + d.orphans.length, 0);
+        console.log(chalk.bold(`Orphans (in version home, not in central)\n`));
+        for (const d of diffs) {
+            console.log(`  ${chalk.cyan(`${d.agent}@${d.version}`)}  ${d.orphans.join(', ')}`);
+        }
+        console.log();
+        if (options.dryRun) {
+            console.log(chalk.gray(`${total} orphan(s). Run without --dry-run to delete.`));
+            return;
+        }
+        if (!options.yes) {
+            if (!isInteractiveTerminal()) {
+                console.log(chalk.yellow('Non-interactive shell: pass -y to confirm, or --dry-run to preview.'));
+                process.exit(1);
+            }
+            let ok = false;
+            try {
+                ok = await confirm({
+                    message: `Delete ${total} orphan skill director${total === 1 ? 'y' : 'ies'}?`,
+                    default: false,
+                });
+            }
+            catch (err) {
+                if (isPromptCancelled(err)) {
+                    console.log(chalk.gray('Cancelled'));
+                    return;
+                }
+                throw err;
+            }
+            if (!ok) {
+                console.log(chalk.gray('Cancelled'));
+                return;
+            }
+        }
+        let removed = 0, failures = 0;
+        for (const d of diffs) {
+            for (const name of d.orphans) {
+                const r = removeSkillFromVersion(d.agent, d.version, name);
+                if (r.success)
+                    removed++;
+                else {
+                    failures++;
+                    console.log(chalk.red(`  ! ${d.agent}@${d.version} ${name}: ${r.error}`));
+                }
+            }
+        }
+        console.log(chalk.green(`Pruned ${removed} orphan(s)${failures > 0 ? chalk.red(`, ${failures} failed`) : ''}.`));
+    });
     skillsCmd
         .command('view [name]')
-        .description('Show skill details')
+        .description('Read skill metadata (name, description, rules count)')
+        .addHelpText('after', `
+Examples:
+  # View details for a specific skill
+  agents skills view api-testing
+
+  # Interactive picker
+  agents skills view
+`)
         .action(async (name) => {
         // If no name provided, show interactive select
         if (!name) {
@@ -592,4 +624,94 @@ export function registerSkillsCommands(program) {
         await skillsCmd.commands.find((c) => c.name() === 'view')?.parseAsync(['view', ...(name ? [name] : [])], { from: 'user' });
     });
 }
+/**
+ * Build the row data for `agents skills list`. Each row = one central skill
+ * with a sync-status target per (agent, version) in scope.
+ */
+async function buildSkillRows(opts) {
+    const central = listInstalledSkills(); // Map<name, DiscoveredSkill>
+    if (central.size === 0)
+        return [];
+    const targetPairs = iterSkillsCapableVersions({
+        agent: opts.filterAgent,
+        version: opts.filterVersion,
+    });
+    // Precompute per-(agent, version) diffs so we can look up each skill's
+    // status without re-diffing 16 times per skill.
+    const diffByTarget = new Map();
+    const defaultByAgent = new Map();
+    for (const { agent, version } of targetPairs) {
+        if (!defaultByAgent.has(agent))
+            defaultByAgent.set(agent, getGlobalDefault(agent));
+        diffByTarget.set(`${agent}@${version}`, diffVersionSkills(agent, version));
+    }
+    const rows = [];
+    for (const [name, skill] of central) {
+        const targets = [];
+        for (const { agent, version } of targetPairs) {
+            const diff = diffByTarget.get(`${agent}@${version}`);
+            let status;
+            if (diff.matched.includes(name))
+                status = 'synced';
+            else if (diff.toUpdate.includes(name))
+                status = 'stale';
+            else
+                status = 'missing';
+            targets.push({
+                agent,
+                version,
+                isDefault: defaultByAgent.get(agent) === version,
+                status,
+            });
+        }
+        const fileCount = countSkillFiles(skill.path);
+        rows.push({
+            name,
+            description: skill.metadata.description,
+            extra: fileCount > 0 ? `${fileCount}` : '-',
+            targets,
+            buildDetail: () => formatSkillDetail(name, skill, targets, fileCount),
+        });
+    }
+    // Sort: fully-synced first, then partial, then missing — stable by name within each tier.
+    rows.sort((a, b) => {
+        const aSynced = a.targets.filter((t) => t.status === 'synced').length;
+        const bSynced = b.targets.filter((t) => t.status === 'synced').length;
+        if (aSynced !== bSynced)
+            return bSynced - aSynced;
+        return a.name.localeCompare(b.name);
+    });
+    return rows;
+}
+function formatSkillDetail(name, skill, targets, fileCount) {
+    const lines = [];
+    lines.push(chalk.bold.cyan(name));
+    if (skill.metadata.description) {
+        lines.push(chalk.gray(skill.metadata.description));
+    }
+    lines.push('');
+    const meta = [];
+    if (skill.metadata.author)
+        meta.push(`author ${chalk.white(skill.metadata.author)}`);
+    if (skill.metadata.version)
+        meta.push(`v${chalk.white(skill.metadata.version)}`);
+    if (skill.metadata.license)
+        meta.push(`license ${chalk.white(skill.metadata.license)}`);
+    meta.push(`${chalk.white(fileCount)} file${fileCount === 1 ? '' : 's'}`);
+    if (skill.ruleCount > 0) {
+        meta.push(`${chalk.white(skill.ruleCount)} rule${skill.ruleCount === 1 ? '' : 's'}`);
+    }
+    lines.push('  ' + meta.join(chalk.gray(' · ')));
+    lines.push('  ' + chalk.gray(skill.path));
+    const rules = getSkillRules(name);
+    if (rules.length > 0) {
+        lines.push('');
+        lines.push(chalk.bold('  Rules'));
+        lines.push('  ' + rules.map((r) => chalk.gray(r)).join(', '));
+    }
+    lines.push('');
+    lines.push(chalk.bold('  Synced to'));
+    lines.push(buildTargetsSection(targets));
+    return lines.join('\n');
+}
 //# sourceMappingURL=skills.js.map