Function installSkills

packages/cli/src/commands/install-skills.ts:190–264

(options: InstallSkillsOptions)

}

async function installSkills(options: InstallSkillsOptions): Promise<void> {
  const isGlobal = !!options.global
  const baseDir = isGlobal ? os.homedir() : process.cwd()
  const skillDir = getSkillDir()

  debug(`Base directory: ${baseDir}`)
  debug(`Skill source: ${skillDir}`)
  debug(`Mode: ${isGlobal ? 'global' : 'project'}`)

  try {
    await fs.access(skillDir)
  } catch {
    throw new Error(`Skill source directory not found: ${skillDir}`)
  }

  const agents = await detectAgents(baseDir, isGlobal, options.agent)

  if (agents.length === 0) {
    logError('No agents detected. Use --agent to specify one.')
    process.exit(ExitCode.InvalidUsage)
  }

  // Read all files from the skill directory recursively
  const skillContents = await readDirRecursive(skillDir)

  const results: InstallResult[] = []
  const installedDirs = new Set<string>()

  for (const agent of agents) {
    const agentSkillDir = isGlobal ? agent.globalSkillDir : agent.projectSkillDir
    if (!agentSkillDir) {
      continue
    }
    const targetDir = path.join(baseDir, agentSkillDir, 'deepnote')

    // Deduplicate: universal agents share the same project skill directory
    if (installedDirs.has(targetDir)) {
      continue
    }
    installedDirs.add(targetDir)

    const skillPath = path.join(agentSkillDir, 'deepnote', 'SKILL.md')

    if (options.dryRun) {
      const status = await getInstallStatus(targetDir, skillContents)
      results.push({ agent, status, skillPath })
      continue
    }

    const status = await installSkillFiles(targetDir, skillContents)
    results.push({ agent, status, skillPath })
  }

  const c = getChalk()

  if (options.dryRun) {
    output(c.bold('Dry run — no files written:'))
  } else {