skilld 1.3.0 → 1.5.0

package/dist/_chunks/uninstall.mjs

@@ -8,11 +8,13 @@ import { r as mapInsert, t as SHARED_SKILLS_DIR } from "./shared.mjs";
 import "./sources.mjs";
 import { a as targets } from "./detect.mjs";
 import "./prompts.mjs";
-import { c as isInteractive, g as sharedArgs, w as unregisterProject, y as getRegisteredProjects } from "./cli-helpers.mjs";
-import { s as readLock } from "./skills.mjs";
+import { C as getRegisteredProjects, O as unregisterProject, _ as sharedArgs, l as isInteractive } from "./cli-helpers.mjs";
+import { i as readLock } from "./lockfile.mjs";
+import "./skills.mjs";
 import "./formatting.mjs";
+import { i as SKILLD_MARKER_START, r as SKILLD_MARKER_END } from "./sync-shared2.mjs";
 import "./pool.mjs";
-import { n as SKILLD_MARKER_START, t as SKILLD_MARKER_END } from "./sync.mjs";
+import "./sync.mjs";
 import { join } from "pathe";
 import { existsSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import * as p from "@clack/prompts";

package/dist/_chunks/uninstall.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uninstall.mjs","names":["agents"],"sources":["../../src/commands/uninstall.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { join } from 'pathe'\nimport { agents } from '../agent/index.ts'\nimport { CACHE_DIR } from '../cache/index.ts'\nimport { isInteractive, sharedArgs } from '../cli-helpers.ts'\nimport { getRegisteredProjects, unregisterProject } from '../core/config.ts'\nimport { readLock } from '../core/lockfile.ts'\nimport { mapInsert, SHARED_SKILLS_DIR } from '../core/shared.ts'\nimport { SKILLD_MARKER_END, SKILLD_MARKER_START } from './sync.ts'\n\n/**\n * Remove the skilld marker block from an agent's instruction file.\n * For .mdc files (dedicated skilld files), delete the entire file.\n * Also cleans up legacy .cursorrules markers for backwards compat.\n */\nfunction removeAgentInstructions(agent: AgentType, projectPath: string): boolean {\n  const agentConfig = agents[agent]\n  if (!agentConfig.instructionFile)\n    return false\n\n  let removed = false\n\n  // Handle current instruction file\n  const filePath = join(projectPath, agentConfig.instructionFile)\n  if (agentConfig.instructionFile.endsWith('.mdc')) {\n    // MDC files are dedicated skilld files - just delete\n    if (existsSync(filePath)) {\n      rmSync(filePath)\n      removed = true\n    }\n    // Also clean up legacy .cursorrules markers (cursor-specific)\n    if (agent === 'cursor')\n      removed = removeMarkerBlock(join(projectPath, '.cursorrules')) || removed\n  }\n  else if (existsSync(filePath)) {\n    removed = removeMarkerBlock(filePath)\n  }\n\n  return removed\n}\n\nfunction removeMarkerBlock(filePath: string): boolean {\n  if (!existsSync(filePath))\n    return false\n\n  const content = readFileSync(filePath, 'utf-8')\n  const startIdx = content.indexOf(SKILLD_MARKER_START)\n  if (startIdx === -1)\n    return false\n\n  const endIdx = content.indexOf(SKILLD_MARKER_END, startIdx)\n  if (endIdx === -1)\n    return false\n\n  // Remove marker block plus surrounding blank lines\n  const before = content.slice(0, startIdx).replace(/\\n+$/, '')\n  const after = content.slice(endIdx + SKILLD_MARKER_END.length).replace(/^\\n+/, '')\n  const updated = before + (before && after ? '\\n' : '') + after\n\n  if (updated.trim() === '') {\n    rmSync(filePath)\n  }\n  else {\n    writeFileSync(filePath, updated.endsWith('\\n') ? updated : `${updated}\\n`)\n  }\n  return true\n}\n\nexport interface UninstallOptions {\n  scope?: 'project' | 'all'\n  agent?: AgentType\n  yes: boolean\n}\n\n/**\n * Uninstall skilld skills by scope:\n * - project: Remove project skills (cwd)\n * - all: All registered projects + global skills + cache\n */\nexport async function uninstallCommand(opts: UninstallOptions): Promise<void> {\n  let scope = opts.scope\n  const registeredProjects = getRegisteredProjects()\n\n  // Prompt for scope if not provided\n  if (!scope) {\n    if (!isInteractive()) {\n      scope = 'project'\n    }\n    else {\n      const allHint = registeredProjects.length > 0\n        ? `${registeredProjects.length} projects + global + cache`\n        : 'global skills + cache'\n\n      const selected = await p.select({\n        message: 'What do you want to uninstall?',\n        options: [\n          { label: 'This project', value: 'project', hint: 'current project only' },\n          { label: 'Everything', value: 'all', hint: allHint },\n        ],\n      })\n\n      if (p.isCancel(selected)) {\n        p.cancel('Cancelled')\n        return\n      }\n      scope = selected as 'project' | 'all'\n    }\n  }\n\n  interface RemoveItem { label: string, path: string, version?: string }\n  const toRemove: RemoveItem[] = []\n  const seenPaths = new Set<string>()\n  const projectsToUnregister: string[] = []\n  const agentFilter = opts.agent ? [opts.agent] : undefined\n\n  const addToRemove = (label: string, path: string, version?: string) => {\n    if (seenPaths.has(path))\n      return\n    seenPaths.add(path)\n    toRemove.push({ label, path, version })\n  }\n\n  // Helper to add skills from a lockfile\n  const addSkillsFromLock = (skillsDir: string, label: string): string[] => {\n    const trackedNames: string[] = []\n    const lock = readLock(skillsDir)\n\n    if (lock?.skills) {\n      for (const [skillName, info] of Object.entries(lock.skills)) {\n        trackedNames.push(skillName)\n        const skillDir = join(skillsDir, skillName)\n        if (existsSync(skillDir)) {\n          const version = info.version ? `${info.version.split('.').slice(0, 2).join('.')}.x` : undefined\n          addToRemove(`${label}: ${skillName}`, skillDir, version)\n        }\n      }\n\n      // Also add the lockfile itself\n      const lockPath = join(skillsDir, 'skilld-lock.yaml')\n      if (existsSync(lockPath)) {\n        addToRemove(`${label}: skilld-lock.yaml`, lockPath)\n      }\n    }\n\n    return trackedNames\n  }\n\n  // Helper to find untracked skills in a directory\n  const findUntrackedSkills = (skillsDir: string, trackedNames: string[]): string[] => {\n    if (!existsSync(skillsDir))\n      return []\n    const tracked = new Set(trackedNames)\n    return readdirSync(skillsDir)\n      .filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml' && !tracked.has(f))\n  }\n\n  // Track untracked skills per directory (dedupe by path)\n  const untrackedByDir = new Map<string, { label: string, skills: string[] }>()\n  const processedDirs = new Set<string>()\n\n  // Helper to process a skills directory (with deduping)\n  const processSkillsDir = (skillsDir: string, label: string) => {\n    if (processedDirs.has(skillsDir))\n      return\n    processedDirs.add(skillsDir)\n\n    const tracked = addSkillsFromLock(skillsDir, label)\n    const untracked = findUntrackedSkills(skillsDir, tracked)\n    if (untracked.length > 0) {\n      untrackedByDir.set(skillsDir, { label, skills: untracked })\n    }\n  }\n\n  // Project skills\n  if (scope === 'project') {\n    // Shared dir\n    const sharedDir = join(process.cwd(), SHARED_SKILLS_DIR)\n    if (existsSync(sharedDir))\n      processSkillsDir(sharedDir, 'project (.skills)')\n    for (const [name, agent] of Object.entries(agents)) {\n      if (agentFilter && !agentFilter.includes(name as AgentType))\n        continue\n      processSkillsDir(join(process.cwd(), agent.skillsDir), 'project')\n    }\n    projectsToUnregister.push(process.cwd())\n  }\n\n  // All registered projects + global\n  if (scope === 'all') {\n    const projectPaths = registeredProjects.length > 0 ? registeredProjects : [process.cwd()]\n\n    // Show which projects will be affected\n    if (registeredProjects.length > 0) {\n      p.log.info('Projects to uninstall from:')\n      for (const proj of projectPaths) {\n        p.log.message(`  ${proj}`)\n      }\n    }\n\n    // Project skills from lockfiles\n    for (const projectPath of projectPaths) {\n      if (!existsSync(projectPath))\n        continue\n\n      const shortPath = projectPath.replace(process.env.HOME || '', '~')\n\n      // Shared dir\n      const sharedDir = join(projectPath, SHARED_SKILLS_DIR)\n      if (existsSync(sharedDir))\n        processSkillsDir(sharedDir, `${shortPath} (.skills)`)\n\n      for (const [name, agent] of Object.entries(agents)) {\n        if (agentFilter && !agentFilter.includes(name as AgentType))\n          continue\n        processSkillsDir(join(projectPath, agent.skillsDir), shortPath)\n      }\n\n      projectsToUnregister.push(projectPath)\n    }\n\n    // Global skills from lockfiles\n    for (const [name, agent] of Object.entries(agents)) {\n      if (agentFilter && !agentFilter.includes(name as AgentType))\n        continue\n      if (!agent.globalSkillsDir)\n        continue\n      processSkillsDir(agent.globalSkillsDir, 'user')\n    }\n\n    // Cache directory\n    if (existsSync(CACHE_DIR)) {\n      addToRemove('~/.skilld cache', CACHE_DIR)\n    }\n  }\n\n  // Warn about untracked skills that will remain (grouped by label, deduped)\n  if (untrackedByDir.size > 0) {\n    const groupedUntracked = new Map<string, Set<string>>()\n    for (const [_dir, { label, skills }] of untrackedByDir) {\n      const set = mapInsert(groupedUntracked, label, () => new Set())\n      for (const s of skills) set.add(s)\n    }\n\n    const totalUntracked = [...groupedUntracked.values()].reduce((sum, s) => sum + s.size, 0)\n    p.log.warn(`${totalUntracked} untracked skill(s) will remain (not managed by skilld):`)\n    for (const [label, skills] of groupedUntracked) {\n      p.log.message(`  ${label}: ${[...skills].join(', ')}`)\n    }\n  }\n\n  if (toRemove.length === 0) {\n    p.log.info('Nothing to uninstall')\n    return\n  }\n\n  // Group by prefix for display\n  const groups = new Map<string, Array<{ name: string, version?: string }>>()\n  for (const item of toRemove) {\n    const [prefix, name] = item.label.includes(': ')\n      ? item.label.split(': ', 2)\n      : ['other', item.label]\n    mapInsert(groups, prefix, () => []).push({ name, version: item.version })\n  }\n\n  const formatGroup = (items: Array<{ name: string, version?: string }>) =>\n    items.map(i => i.version ? `${i.name}@${i.version}` : i.name).join(', ')\n\n  p.log.info(`Will remove ${toRemove.length} items:`)\n  for (const [prefix, items] of groups) {\n    p.log.message(`  ${prefix}: ${formatGroup(items)}`)\n  }\n\n  if (!opts.yes && isInteractive()) {\n    const confirmed = await p.confirm({\n      message: 'Proceed with uninstall?',\n    })\n\n    if (p.isCancel(confirmed) || !confirmed) {\n      p.cancel('Cancelled')\n      return\n    }\n  }\n\n  // Remove all items\n  for (const item of toRemove) {\n    rmSync(item.path, { recursive: true, force: true })\n  }\n\n  // Show grouped removal summary\n  for (const [prefix, items] of groups) {\n    p.log.success(`Removed ${prefix}: ${formatGroup(items)}`)\n  }\n\n  // Remove skilld instructions from agent instruction files\n  const agentTypes = agentFilter || (Object.keys(agents) as AgentType[])\n  for (const proj of projectsToUnregister) {\n    for (const agent of agentTypes) {\n      if (removeAgentInstructions(agent, proj)) {\n        const file = agents[agent].instructionFile!\n        p.log.success(`Cleaned ${file}`)\n      }\n    }\n  }\n\n  // Unregister projects from config (skip if cache dir was removed — config is gone)\n  if (scope !== 'all') {\n    for (const proj of projectsToUnregister) {\n      unregisterProject(proj)\n    }\n  }\n\n  p.outro('skilld uninstalled')\n}\n\nexport const uninstallCommandDef = defineCommand({\n  meta: { name: 'uninstall', description: 'Remove skilld data' },\n  args: {\n    ...sharedArgs,\n  },\n  async run({ args }) {\n    p.intro(`\\x1B[1m\\x1B[35mskilld\\x1B[0m uninstall`)\n    return uninstallCommand({\n      scope: args.global ? 'all' : undefined,\n      agent: args.agent as AgentType | undefined,\n      yes: args.yes,\n    })\n  },\n})\n"],"mappings":"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"}
+{"version":3,"file":"uninstall.mjs","names":["agents"],"sources":["../../src/commands/uninstall.ts"],"sourcesContent":["import type { AgentType } from '../agent/index.ts'\nimport { existsSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'\nimport * as p from '@clack/prompts'\nimport { defineCommand } from 'citty'\nimport { join } from 'pathe'\nimport { agents } from '../agent/index.ts'\nimport { CACHE_DIR } from '../cache/index.ts'\nimport { isInteractive, sharedArgs } from '../cli-helpers.ts'\nimport { getRegisteredProjects, unregisterProject } from '../core/config.ts'\nimport { readLock } from '../core/lockfile.ts'\nimport { mapInsert, SHARED_SKILLS_DIR } from '../core/shared.ts'\nimport { SKILLD_MARKER_END, SKILLD_MARKER_START } from './sync.ts'\n\n/**\n * Remove the skilld marker block from an agent's instruction file.\n * For .mdc files (dedicated skilld files), delete the entire file.\n * Also cleans up legacy .cursorrules markers for backwards compat.\n */\nfunction removeAgentInstructions(agent: AgentType, projectPath: string): boolean {\n  const agentConfig = agents[agent]\n  if (!agentConfig.instructionFile)\n    return false\n\n  let removed = false\n\n  // Handle current instruction file\n  const filePath = join(projectPath, agentConfig.instructionFile)\n  if (agentConfig.instructionFile.endsWith('.mdc')) {\n    // MDC files are dedicated skilld files - just delete\n    if (existsSync(filePath)) {\n      rmSync(filePath)\n      removed = true\n    }\n    // Also clean up legacy .cursorrules markers (cursor-specific)\n    if (agent === 'cursor')\n      removed = removeMarkerBlock(join(projectPath, '.cursorrules')) || removed\n  }\n  else if (existsSync(filePath)) {\n    removed = removeMarkerBlock(filePath)\n  }\n\n  return removed\n}\n\nfunction removeMarkerBlock(filePath: string): boolean {\n  if (!existsSync(filePath))\n    return false\n\n  const content = readFileSync(filePath, 'utf-8')\n  const startIdx = content.indexOf(SKILLD_MARKER_START)\n  if (startIdx === -1)\n    return false\n\n  const endIdx = content.indexOf(SKILLD_MARKER_END, startIdx)\n  if (endIdx === -1)\n    return false\n\n  // Remove marker block plus surrounding blank lines\n  const before = content.slice(0, startIdx).replace(/\\n+$/, '')\n  const after = content.slice(endIdx + SKILLD_MARKER_END.length).replace(/^\\n+/, '')\n  const updated = before + (before && after ? '\\n' : '') + after\n\n  if (updated.trim() === '') {\n    rmSync(filePath)\n  }\n  else {\n    writeFileSync(filePath, updated.endsWith('\\n') ? updated : `${updated}\\n`)\n  }\n  return true\n}\n\nexport interface UninstallOptions {\n  scope?: 'project' | 'all'\n  agent?: AgentType\n  yes: boolean\n}\n\n/**\n * Uninstall skilld skills by scope:\n * - project: Remove project skills (cwd)\n * - all: All registered projects + global skills + cache\n */\nexport async function uninstallCommand(opts: UninstallOptions): Promise<void> {\n  let scope = opts.scope\n  const registeredProjects = getRegisteredProjects()\n\n  // Prompt for scope if not provided\n  if (!scope) {\n    if (!isInteractive()) {\n      scope = 'project'\n    }\n    else {\n      const allHint = registeredProjects.length > 0\n        ? `${registeredProjects.length} projects + global + cache`\n        : 'global skills + cache'\n\n      const selected = await p.select({\n        message: 'What do you want to uninstall?',\n        options: [\n          { label: 'This project', value: 'project', hint: 'current project only' },\n          { label: 'Everything', value: 'all', hint: allHint },\n        ],\n      })\n\n      if (p.isCancel(selected)) {\n        p.cancel('Cancelled')\n        return\n      }\n      scope = selected as 'project' | 'all'\n    }\n  }\n\n  interface RemoveItem { label: string, path: string, version?: string }\n  const toRemove: RemoveItem[] = []\n  const seenPaths = new Set<string>()\n  const projectsToUnregister: string[] = []\n  const agentFilter = opts.agent ? [opts.agent] : undefined\n\n  const addToRemove = (label: string, path: string, version?: string) => {\n    if (seenPaths.has(path))\n      return\n    seenPaths.add(path)\n    toRemove.push({ label, path, version })\n  }\n\n  // Helper to add skills from a lockfile\n  const addSkillsFromLock = (skillsDir: string, label: string): string[] => {\n    const trackedNames: string[] = []\n    const lock = readLock(skillsDir)\n\n    if (lock?.skills) {\n      for (const [skillName, info] of Object.entries(lock.skills)) {\n        trackedNames.push(skillName)\n        const skillDir = join(skillsDir, skillName)\n        if (existsSync(skillDir)) {\n          const version = info.version ? `${info.version.split('.').slice(0, 2).join('.')}.x` : undefined\n          addToRemove(`${label}: ${skillName}`, skillDir, version)\n        }\n      }\n\n      // Also add the lockfile itself\n      const lockPath = join(skillsDir, 'skilld-lock.yaml')\n      if (existsSync(lockPath)) {\n        addToRemove(`${label}: skilld-lock.yaml`, lockPath)\n      }\n    }\n\n    return trackedNames\n  }\n\n  // Helper to find untracked skills in a directory\n  const findUntrackedSkills = (skillsDir: string, trackedNames: string[]): string[] => {\n    if (!existsSync(skillsDir))\n      return []\n    const tracked = new Set(trackedNames)\n    return readdirSync(skillsDir)\n      .filter(f => !f.startsWith('.') && f !== 'skilld-lock.yaml' && !tracked.has(f))\n  }\n\n  // Track untracked skills per directory (dedupe by path)\n  const untrackedByDir = new Map<string, { label: string, skills: string[] }>()\n  const processedDirs = new Set<string>()\n\n  // Helper to process a skills directory (with deduping)\n  const processSkillsDir = (skillsDir: string, label: string) => {\n    if (processedDirs.has(skillsDir))\n      return\n    processedDirs.add(skillsDir)\n\n    const tracked = addSkillsFromLock(skillsDir, label)\n    const untracked = findUntrackedSkills(skillsDir, tracked)\n    if (untracked.length > 0) {\n      untrackedByDir.set(skillsDir, { label, skills: untracked })\n    }\n  }\n\n  // Project skills\n  if (scope === 'project') {\n    // Shared dir\n    const sharedDir = join(process.cwd(), SHARED_SKILLS_DIR)\n    if (existsSync(sharedDir))\n      processSkillsDir(sharedDir, 'project (.skills)')\n    for (const [name, agent] of Object.entries(agents)) {\n      if (agentFilter && !agentFilter.includes(name as AgentType))\n        continue\n      processSkillsDir(join(process.cwd(), agent.skillsDir), 'project')\n    }\n    projectsToUnregister.push(process.cwd())\n  }\n\n  // All registered projects + global\n  if (scope === 'all') {\n    const projectPaths = registeredProjects.length > 0 ? registeredProjects : [process.cwd()]\n\n    // Show which projects will be affected\n    if (registeredProjects.length > 0) {\n      p.log.info('Projects to uninstall from:')\n      for (const proj of projectPaths) {\n        p.log.message(`  ${proj}`)\n      }\n    }\n\n    // Project skills from lockfiles\n    for (const projectPath of projectPaths) {\n      if (!existsSync(projectPath))\n        continue\n\n      const shortPath = projectPath.replace(process.env.HOME || '', '~')\n\n      // Shared dir\n      const sharedDir = join(projectPath, SHARED_SKILLS_DIR)\n      if (existsSync(sharedDir))\n        processSkillsDir(sharedDir, `${shortPath} (.skills)`)\n\n      for (const [name, agent] of Object.entries(agents)) {\n        if (agentFilter && !agentFilter.includes(name as AgentType))\n          continue\n        processSkillsDir(join(projectPath, agent.skillsDir), shortPath)\n      }\n\n      projectsToUnregister.push(projectPath)\n    }\n\n    // Global skills from lockfiles\n    for (const [name, agent] of Object.entries(agents)) {\n      if (agentFilter && !agentFilter.includes(name as AgentType))\n        continue\n      if (!agent.globalSkillsDir)\n        continue\n      processSkillsDir(agent.globalSkillsDir, 'user')\n    }\n\n    // Cache directory\n    if (existsSync(CACHE_DIR)) {\n      addToRemove('~/.skilld cache', CACHE_DIR)\n    }\n  }\n\n  // Warn about untracked skills that will remain (grouped by label, deduped)\n  if (untrackedByDir.size > 0) {\n    const groupedUntracked = new Map<string, Set<string>>()\n    for (const [_dir, { label, skills }] of untrackedByDir) {\n      const set = mapInsert(groupedUntracked, label, () => new Set())\n      for (const s of skills) set.add(s)\n    }\n\n    const totalUntracked = [...groupedUntracked.values()].reduce((sum, s) => sum + s.size, 0)\n    p.log.warn(`${totalUntracked} untracked skill(s) will remain (not managed by skilld):`)\n    for (const [label, skills] of groupedUntracked) {\n      p.log.message(`  ${label}: ${[...skills].join(', ')}`)\n    }\n  }\n\n  if (toRemove.length === 0) {\n    p.log.info('Nothing to uninstall')\n    return\n  }\n\n  // Group by prefix for display\n  const groups = new Map<string, Array<{ name: string, version?: string }>>()\n  for (const item of toRemove) {\n    const [prefix, name] = item.label.includes(': ')\n      ? item.label.split(': ', 2)\n      : ['other', item.label]\n    mapInsert(groups, prefix!, () => []).push({ name: name!, version: item.version })\n  }\n\n  const formatGroup = (items: Array<{ name: string, version?: string }>) =>\n    items.map(i => i.version ? `${i.name}@${i.version}` : i.name).join(', ')\n\n  p.log.info(`Will remove ${toRemove.length} items:`)\n  for (const [prefix, items] of groups) {\n    p.log.message(`  ${prefix}: ${formatGroup(items)}`)\n  }\n\n  if (!opts.yes && isInteractive()) {\n    const confirmed = await p.confirm({\n      message: 'Proceed with uninstall?',\n    })\n\n    if (p.isCancel(confirmed) || !confirmed) {\n      p.cancel('Cancelled')\n      return\n    }\n  }\n\n  // Remove all items\n  for (const item of toRemove) {\n    rmSync(item.path, { recursive: true, force: true })\n  }\n\n  // Show grouped removal summary\n  for (const [prefix, items] of groups) {\n    p.log.success(`Removed ${prefix}: ${formatGroup(items)}`)\n  }\n\n  // Remove skilld instructions from agent instruction files\n  const agentTypes = agentFilter || (Object.keys(agents) as AgentType[])\n  for (const proj of projectsToUnregister) {\n    for (const agent of agentTypes) {\n      if (removeAgentInstructions(agent, proj)) {\n        const file = agents[agent].instructionFile!\n        p.log.success(`Cleaned ${file}`)\n      }\n    }\n  }\n\n  // Unregister projects from config (skip if cache dir was removed — config is gone)\n  if (scope !== 'all') {\n    for (const proj of projectsToUnregister) {\n      unregisterProject(proj)\n    }\n  }\n\n  p.outro('skilld uninstalled')\n}\n\nexport const uninstallCommandDef = defineCommand({\n  meta: { name: 'uninstall', description: 'Remove skilld data' },\n  args: {\n    ...sharedArgs,\n  },\n  async run({ args }) {\n    p.intro(`\\x1B[1m\\x1B[35mskilld\\x1B[0m uninstall`)\n    return uninstallCommand({\n      scope: args.global ? 'all' : undefined,\n      agent: args.agent as AgentType | undefined,\n      yes: args.yes,\n    })\n  },\n})\n"],"mappings":"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"}

package/dist/agent/index.d.mts

@@ -56,6 +56,8 @@ interface BuildSkillPromptOptions {
   enabledSectionCount?: number;
   /** Key files from the package (e.g., dist/pkg.d.ts) — surfaced in prompt for tool hints */
   pkgFiles?: string[];
+  /** Lines consumed by SKILL.md overhead (frontmatter + header + search + footer) */
+  overheadLines?: number;
 }
 /**
  * Get the validate function for a section using default context (validators use fixed thresholds).
@@ -89,8 +91,6 @@ interface SkillOptions {
   name: string;
   version?: string;
   releasedAt?: string;
-  /** Production dependencies with version specifiers */
-  dependencies?: Record<string, string>;
   /** npm dist-tags with version and release date */
   distTags?: Record<string, {
     version: string;
@@ -186,6 +186,8 @@ interface OptimizeDocsOptions {
   features?: FeaturesConfig;
   /** Key files from the package (e.g., dist/pkg.d.ts) */
   pkgFiles?: string[];
+  /** Lines consumed by SKILL.md overhead (frontmatter + header + search + footer) */
+  overheadLines?: number;
 }
 interface OptimizeResult {
   optimized: string;

package/dist/agent/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/core/config.ts","../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect-imports.ts","../../src/agent/detect.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":";UAMiB,cAAA;EACf,MAAA;EACA,MAAA;EACA,WAAA;EACA,QAAA;AAAA;;;UCCe,wBAAA;EACf,OAAA;AAAA;AAAA,UA+Be,YAAA;EACf,OAAA;EACA,IAAA;AAAA;;;KClCU,YAAA;;cAGC,oBAAA,EAAsB,MAAA,CAAO,YAAA;;cAO7B,mBAAA,EAAqB,YAAA;;iBAGlB,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,OAAA;;iBAKnC,qBAAA,CAAsB,EAAA,WAAa,GAAA,CAAI,YAAA;EAAgB,KAAA;EAAe,GAAA;AAAA;AAAA,UAarE,uBAAA;EACf,WAAA;EDAe;ECEf,QAAA;;EAEA,OAAA;EDFI;ECIJ,SAAA;;EAEA,cAAA;EAxCU;EA0CV,WAAA;;EAEA,YAAA;EA5CsB;EA8CtB,QAAA;EAvCD;EAyCC,QAAA;EA7CiC;EA+CjC,cAAA;EAxCW;EA0CX,YAAA,GAAe,YAAA;;EAEf,QAAA,GAAW,cAAA;EA5CiC;EA8C5C,mBAAA;EA3CyB;EA6CzB,QAAA;AAAA;;;;;iBAuHc,mBAAA,CAAoB,OAAA,EAAS,YAAA,KAAiB,OAAA,aAAoB,wBAAA;AA/JlF;;;AAAA,iBA0KgB,kBAAA,CAAmB,IAAA,EAAM,uBAAA;EAA4B,OAAA,EAAS,YAAA;AAAA;;;;iBAkE9D,sBAAA,CAAuB,IAAA,EAAM,uBAAA;EAA4B,QAAA,EAAU,YAAA;AAAA,IAAmB,GAAA,CAAI,YAAA;;;;;;;;;iBAkB1F,iBAAA,CAAkB,MAAA,UAAgB,OAAA,GAAU,YAAA;;;UChR3C,YAAA;EACf,IAAA;EACA,OAAA;EACA,UAAA;EHJA;EGMA,YAAA,GAAe,MAAA;EHNP;EGQR,QAAA,GAAW,MAAA;IAAiB,OAAA;IAAiB,UAAA;EAAA;EAC7C,KAAA;EACA,WAAA;EFRA;EEUA,IAAA;EACA,aAAA;EACA,SAAA;EACA,cAAA;EACA,WAAA;EACA,YAAA;EACA,QAAA;EACA,cAAA;;EAEA,QAAA;EDpBsB;ECsBtB,WAAA;EDtBsB;ECwBtB,OAAA;EDrBW;ECuBX,QAAA,GAAW,KAAA;IAAQ,IAAA;EAAA;EDvBiC;ECyBpD,OAAA;EDlB4F;ECoB5F,QAAA,GAAW,cAAA;EDpBqB;ECsBhC,KAAA;AAAA;AAAA,iBAGc,eAAA,CAAgB,IAAA,EAAM,YAAA;;;;AHxCtC;;KIFY,SAAA;AAAA,UAcK,aAAA;EACf,IAAA;EACA,OAAA;EJXA;EIaA,UAAA;EACA,WAAA;AAAA;;;KCEU,aAAA;AAAA,UAYK,SAAA;EACf,EAAA,EAAI,aAAA;EACJ,IAAA;EACA,IAAA;EACA,WAAA;EACA,OAAA;EACA,SAAA;;EAEA,QAAA;EH/BoD;EGiCpD,YAAA;EH1B4F;EG4B5F,WAAA;AAAA;AAAA,UAGe,cAAA;EACf,KAAA;EACA,IAAA;EACA,IAAA;EACA,SAAA;EACA,OAAA,GAAU,YAAA;AAAA;AAAA,UAGK,mBAAA;EACf,WAAA;EACA,QAAA;EACA,KAAA,GAAQ,aAAA;EACR,OAAA;EACA,SAAA;EACA,WAAA;EACA,YAAA;EACA,QAAA;EACA,QAAA;EACA,cAAA;EACA,UAAA,IAAc,QAAA,EAAU,cAAA;EACxB,OAAA;EACA,OAAA;EACA,KAAA;EACA,OAAA;;EAEA,QAAA,GAAW,YAAA;EHlCX;EGoCA,YAAA,GAAe,YAAA;EHhCf;EGkCA,QAAA,GAAW,cAAA;EH9BX;EGgCA,QAAA;AAAA;AAAA,UAGe,cAAA;EACf,SAAA;EACA,YAAA;EACA,KAAA;EACA,QAAA;EACA,SAAA;EACA,YAAA;EACA,KAAA;IAAU,WAAA;IAAqB,YAAA;IAAsB,WAAA;EAAA;EACrD,IAAA;EACA,YAAA;AAAA;;;UC/CQ,eAAA;EACR,OAAA,GAAU,GAAA;AAAA;;iBAII,kBAAA,CAAmB,GAAA,EAAK,eAAA,IAAmB,QAAA,EAAU,cAAA;AAAA,iBAwHrD,YAAA,CAAa,EAAA,EAAI,aAAA;AAAA,iBAQjB,aAAA,CAAc,EAAA,EAAI,aAAA;AAAA,iBAYZ,kBAAA,CAAA,GAAsB,OAAA,CAAJ,SAAA;AAAA,iBAiXlB,YAAA,CAAa,IAAA,EAAM,mBAAA,GAAsB,OAAA,CAAQ,cAAA;;;;AN5iBvE;;;UOIiB,YAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,YAAA;EACf,QAAA,EAAU,YAAA;EACV,KAAA;AAAA;;ANPF;;;iBM+BsB,sBAAA,CAAuB,GAAA,YAA8B,OAAA,CAAQ,YAAA;;;;;;iBC9BnE,qBAAA,CAAA,GAAyB,SAAA;;;;;;;APDzC;;iBOegB,iBAAA,CAAA,GAAqB,SAAA;;;APiBrC;;iBOIgB,mBAAA,CAAA,GAAuB,SAAA;;;;iBAUvB,eAAA,CAAgB,SAAA,EAAW,SAAA;;;;;;iBC3C3B,YAAA,CAAa,IAAA;;;;;;;ARH7B;;;iBQoBgB,mBAAA,CAAoB,WAAA;;ARYpC;;;;iBQHgB,qBAAA,CACd,SAAA,UACA,YAAA,UACA,OAAA;EACE,MAAA;EACA,GAAA;EACA,MAAA,GAAS,SAAA,IPnCD;EOqCR,KAAA,GAAQ,MAAA;AAAA;EAEP,SAAA,EAAW,SAAA;EAAa,OAAA,EAAS,KAAA;IAAQ,KAAA,EAAO,SAAA;IAAW,MAAA;EAAA;EAAmB,KAAA;AAAA;AP7BnF;;;;;AAGA;AAHA,iBO4FgB,iBAAA,CAAkB,SAAA,UAAmB,SAAA,UAAmB,GAAA,UAAa,SAAA,GAAY,SAAA;;;;iBA4DjF,qBAAA,CAAsB,SAAA,UAAmB,GAAA,UAAa,SAAA,GAAY,SAAA;;;UCvKjE,gBAAA;EVCf;EUCA,IAAA;EVCA;EUCA,QAAA;;EAEA,WAAA;;EAEA,WAAA;AAAA;AAAA,UAGe,WAAA;ETNwB;ESQvC,KAAA,EAAO,SAAA;ETPP;ESSA,WAAA;ETsBe;ESjBf,eAAA;;EAEA,SAAA;ETiBI;ESfJ,aAAA,GAAgB,GAAA;;EAEhB,GAAA;ERrBU;EQuBV,eAAA;;EAKA,aAAA;ER5BsB;EQ8BtB,SAAA;ERvBD;EQyBC,eAAA;ER7BiC;EQ+BjC,oBAAA;ERxBW;EQ6BX,WAAA,EAAa,gBAAA;;EAEb,cAAA;ER/B4C;EQiC5C,WAAA;ER9ByB;EQmCzB,iBAAA;ERnC+C;EQqC/C,cAAA;ERrC0B;EQ0C1B,eAAA;;EAEA,UAAA;ERvCc;EQ4Cd,IAAA;;EAEA,KAAA;ER9CoC;EQgDpC,mBAAA;AAAA;;;cC1DW,OAAA,EAAS,MAAA,CAAO,SAAA,EAAW,WAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/core/config.ts","../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect-imports.ts","../../src/agent/detect.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":"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"}

package/dist/cli.mjs

@@ -9,8 +9,9 @@ import { n as getSharedSkillsDir, o as semverGt, r as mapInsert } from "./_chunk
 import { r as fetchNpmRegistryMeta, t as fetchLatestVersion } from "./_chunks/sources.mjs";
 import { a as targets, i as getAgentVersion, r as detectTargetAgent, t as detectInstalledAgents } from "./_chunks/detect.mjs";
 import { o as unlinkSkillFromAgents } from "./_chunks/prompts.mjs";
-import { S as readConfig, T as updateConfig, _ as version, a as getRepoHint, b as hasCompletedWizard, c as isInteractive, d as pickModel, f as promptForAgent, g as sharedArgs, h as resolveAgent, i as getInstalledGenerators, l as isRunningInsideAgent, m as requireInteractive, n as OAUTH_NOTE, o as guard, p as relativeTime, r as formatStatus, s as introLine, t as NO_MODELS_MESSAGE, u as menuLoop, v as defaultFeatures, x as hasConfig } from "./_chunks/cli-helpers.mjs";
-import { c as removeLockEntry, i as iterateSkills, n as getSkillsDir, o as parsePackages, r as isOutdated, t as getProjectState } from "./_chunks/skills.mjs";
+import { E as readConfig, S as defaultFeatures, T as hasConfig, _ as sharedArgs, a as getInstalledGenerators, c as introLine, d as menuLoop, f as pickModel, g as resolveAgent, h as requireInteractive, i as formatStatus, k as updateConfig, l as isInteractive, m as relativeTime, n as OAUTH_NOTE, o as getRepoHint, p as promptForAgent, s as guard, t as NO_MODELS_MESSAGE, u as isRunningInsideAgent, v as suggestPrepareHook, w as hasCompletedWizard, y as version } from "./_chunks/cli-helpers.mjs";
+import { a as removeLockEntry, n as parsePackages } from "./_chunks/lockfile.mjs";
+import { i as iterateSkills, n as getSkillsDir, r as isOutdated, t as getProjectState } from "./_chunks/skills.mjs";
 import { c as timeAgo, i as formatSource, l as timedSpinner } from "./_chunks/formatting.mjs";
 import { join, resolve } from "pathe";
 import { existsSync, readFileSync, readdirSync, realpathSync, rmSync, statSync } from "node:fs";
@@ -794,7 +795,10 @@ const SUBCOMMAND_NAMES = [
 	"cache",
 	"validate",
 	"assemble",
-	"setup"
+	"setup",
+	"prepare",
+	"author",
+	"publish"
 ];
 runMain(defineCommand({
 	meta: {
@@ -812,12 +816,15 @@ runMain(defineCommand({
 		config: () => configCommandDef,
 		remove: () => removeCommandDef,
 		install: () => import("./_chunks/install.mjs").then((m) => m.installCommandDef),
+		prepare: () => import("./_chunks/prepare.mjs").then((m) => m.prepareCommandDef),
 		uninstall: () => import("./_chunks/uninstall.mjs").then((m) => m.uninstallCommandDef),
 		search: () => import("./_chunks/search.mjs").then((m) => m.searchCommandDef),
 		cache: () => import("./_chunks/cache2.mjs").then((m) => m.cacheCommandDef),
 		validate: () => import("./_chunks/validate.mjs").then((m) => m.validateCommandDef),
 		assemble: () => import("./_chunks/assemble.mjs").then((m) => m.assembleCommandDef),
-		setup: () => import("./_chunks/setup.mjs").then((m) => m.setupCommandDef)
+		setup: () => import("./_chunks/setup.mjs").then((m) => m.setupCommandDef),
+		author: () => import("./_chunks/author.mjs").then((m) => m.authorCommandDef),
+		publish: () => import("./_chunks/author.mjs").then((m) => m.authorCommandDef)
 	},
 	async run({ args }) {
 		const firstArg = process.argv[2];
@@ -897,12 +904,23 @@ runMain(defineCommand({
 			const projectLabel = projectName ? `Generating skills for \x1B[36m${projectName}\x1B[0m` : "Generating skills for current directory";
 			p.log.step(projectLabel);
 			if (!hasPkgJson) p.log.warn("No package.json found - enter npm package names manually.\n  For best results, run skilld inside a JS/TS project directory.");
+			if (state.shipped.length > 0) {
+				const totalShipped = state.shipped.reduce((sum, s) => sum + s.skills.length, 0);
+				const names = state.shipped.map((s) => s.packageName).join(", ");
+				p.log.info(`\x1B[36m${totalShipped} ready-to-use skill${totalShipped > 1 ? "s" : ""}\x1B[0m shipped by your dependencies: ${names}`);
+			}
 			p.log.info("Tip: Add skills for packages with complex APIs or frequent breaking changes - not every dependency needs one.");
 			let setupComplete = false;
 			while (!setupComplete) {
+				const shippedOption = state.shipped.length > 0 ? [{
+					label: "Install shipped skills",
+					value: "shipped",
+					hint: `\x1B[36m${state.shipped.reduce((sum, s) => sum + s.skills.length, 0)} ready to use\x1B[0m`
+				}] : [];
 				const source = hasPkgJson ? await p.select({
 					message: "How should I find packages?",
 					options: [
+						...shippedOption,
 						{
 							label: "Scan source files",
 							value: "imports",
@@ -932,6 +950,16 @@ runMain(defineCommand({
 					p.log.info("Run \x1B[36mskilld add <pkg>\x1B[0m or \x1B[36mskilld\x1B[0m anytime to add skills.");
 					return;
 				}
+				if (source === "shipped") {
+					const { handleShippedSkills: installShipped } = await import("./_chunks/sync-shared.mjs");
+					for (const pkg of state.shipped) {
+						const version = state.deps.get(pkg.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
+						installShipped(pkg.packageName, version, cwd, agent, false);
+						for (const sk of pkg.skills) p.log.success(`Installed shipped skill: ${sk.skillName}`);
+					}
+					state = await getProjectState(cwd);
+					continue;
+				}
 				let selected;
 				if (source === "manual") {
 					const input = await p.text({
@@ -1066,17 +1094,20 @@ runMain(defineCommand({
 			const firstPkg = previewSkill?.info?.packageName || previewSkill?.name;
 			const trySuggestion = firstPkg ? `\n\n\x1B[36mTry it:\x1B[0m ask your agent "What are the gotchas or breaking changes in ${firstPkg}?"` : "";
 			p.note(`${verifyLine}${trySuggestion}\n\nRun \x1B[36mskilld info\x1B[0m to see installed skills.\nRun \x1B[36mskilld\x1B[0m again to add more, update, or search.`, `${agentName} - next steps`);
-			if (hasPkgJson) {
-				const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
-				if (!pkgJson.scripts?.prepare?.includes("skilld")) {
-					const prepareCmd = pkgJson.scripts?.prepare ? `${pkgJson.scripts.prepare} && skilld update -b` : "skilld update -b";
-					p.log.info(`\x1B[90mKeep skills fresh by adding to package.json scripts:\n  \x1B[36m"prepare": "${prepareCmd}"\x1B[0m\n  \x1B[90mRefreshes docs on install. Run \`skilld update\` to regenerate LLM enhancements.\n  Commit skilld-lock.yaml so teammates can run \`skilld install\`.\x1B[0m`);
-				}
+			try {
+				await suggestPrepareHook(cwd);
+			} catch (err) {
+				p.log.warn(`Failed to suggest prepare hook: ${err instanceof Error ? err.message : String(err)}`);
 			}
 			return;
 		}
 		const status = formatStatus(state.synced.length, state.outdated.length);
 		p.log.info(status);
+		if (state.shipped.length > 0) {
+			const totalSkills = state.shipped.reduce((sum, s) => sum + s.skills.length, 0);
+			const names = state.shipped.map((s) => s.packageName).join(", ");
+			p.log.info(`\x1B[36m${totalSkills} ready-to-use skill${totalSkills > 1 ? "s" : ""}\x1B[0m shipped by your dependencies: ${names}`);
+		}
 		const refreshState = async () => {
 			state = await getProjectState(cwd);
 		};
@@ -1084,6 +1115,14 @@ runMain(defineCommand({
 			message: "What would you like to do?",
 			options: () => {
 				const opts = [];
+				if (state.shipped.length > 0) {
+					const total = state.shipped.reduce((sum, s) => sum + s.skills.length, 0);
+					opts.push({
+						label: "Install shipped skills",
+						value: "shipped",
+						hint: `\x1B[36m${total} available\x1B[0m`
+					});
+				}
 				opts.push({
 					label: "Add new skills",
 					value: "install"
@@ -1110,6 +1149,33 @@ runMain(defineCommand({
 			},
 			onSelect: async (action) => {
 				switch (action) {
+					case "shipped": {
+						const allShipped = state.shipped.flatMap((s) => s.skills.map((sk) => ({
+							packageName: s.packageName,
+							...sk
+						})));
+						const selected = guard(await p.multiselect({
+							message: "Select shipped skills to install",
+							options: allShipped.map((s) => ({
+								label: s.skillName,
+								value: s,
+								hint: s.packageName
+							})),
+							initialValues: allShipped
+						}));
+						if (selected.length === 0) return;
+						const { handleShippedSkills: installShipped } = await import("./_chunks/sync-shared.mjs");
+						const seen = /* @__PURE__ */ new Set();
+						for (const s of selected) {
+							if (seen.has(s.packageName)) continue;
+							seen.add(s.packageName);
+							const version = state.deps.get(s.packageName)?.replace(/^[\^~>=<]+/, "") || "0.0.0";
+							installShipped(s.packageName, version, cwd, agent, false);
+						}
+						p.log.success(`Installed ${selected.length} shipped skill${selected.length > 1 ? "s" : ""}`);
+						await refreshState();
+						return true;
+					}
 					case "install": {
 						const installedNames = new Set([...state.synced.map((s) => s.packageName), ...state.outdated.map((s) => s.packageName)].filter(Boolean));
 						const uninstalledDeps = [...state.deps.keys()].filter((d) => !installedNames.has(d));