@siliconoid/agentkit 0.1.1 → 0.1.2

package/bin/cli.mjs

@@ -93,6 +93,17 @@ program
     await runAddSkillPack(pack)
   })
 
+program
+  .command('add-skill-bundle')
+  .description('Add a skill bundle (e.g. superpowers) to an existing project')
+  .argument('<bundle>', 'Skill bundle ID (e.g. superpowers)')
+  .option('--global', 'Install to ~/.claude/skills/ (works across all projects)')
+  .option('--project', 'Install to project platform dirs (default)')
+  .action(async (bundle, opts) => {
+    const { runAddSkillBundle } = await import('../lib/commands/add-skill-bundle.mjs')
+    await runAddSkillBundle(bundle, opts)
+  })
+
 program
   .command('doctor')
   .description('Check project configuration for issues')

package/lib/commands/add-platform.mjs

@@ -2,7 +2,7 @@ import { join } from 'path'
 import {
   findProjectRoot, readConfig, writeConfig, PLATFORMS,
 } from '../utils.mjs'
-import { scaffoldPlatforms, scaffoldWorkflows, scaffoldSkills } from '../scaffold.mjs'
+import { scaffoldPlatforms, scaffoldWorkflows, scaffoldSkills, scaffoldSkillBundles } from '../scaffold.mjs'
 import { runSync } from './sync.mjs'
 import log from '../log.mjs'
 
@@ -58,6 +58,14 @@ export async function runAddPlatform(platformId) {
       }
     }
 
+    // Install skill bundles if any (project-level only)
+    if (config.skillBundles?.length > 0) {
+      const bundleFiles = scaffoldSkillBundles(projectRoot, [platformId], config.skillBundles)
+      if (bundleFiles.length > 0) {
+        log.success(`  ${bundleFiles.length} skill bundle files installed`)
+      }
+    }
+
     // Sync portable skills
     await runSync({ _projectRoot: projectRoot, _platforms: [platformId], _vars: vars })
 

package/lib/commands/add-skill-bundle.mjs

@@ -0,0 +1,71 @@
+import {
+  findProjectRoot, readConfig, writeConfig, SKILL_BUNDLES,
+} from '../utils.mjs'
+import { scaffoldSkillBundles, scaffoldSkillBundlesGlobal } from '../scaffold.mjs'
+import log from '../log.mjs'
+
+export async function runAddSkillBundle(bundleId, opts = {}) {
+  const validIds = SKILL_BUNDLES.map(b => b.id)
+
+  if (!validIds.includes(bundleId)) {
+    log.error(`Unknown skill bundle "${bundleId}". Available: ${validIds.join(', ')}`)
+    process.exit(1)
+  }
+
+  try {
+    const projectRoot = findProjectRoot()
+    const config = readConfig(projectRoot)
+
+    if (!config) {
+      log.error('No .ai/agentkit.json found. Run `agentkit init` first.')
+      process.exit(1)
+    }
+
+    if (config.skillBundles.includes(bundleId)) {
+      log.warn(`Skill bundle "${bundleId}" is already installed.`)
+      return
+    }
+
+    const bundle = SKILL_BUNDLES.find(b => b.id === bundleId)
+
+    // Determine scope from flags, config, or default
+    let scope = 'project'
+    if (opts.global && opts.project) scope = 'both'
+    else if (opts.global) scope = 'global'
+    else if (opts.project) scope = 'project'
+
+    // Add to config
+    config.skillBundles.push(bundleId)
+    config.superpowersScope = scope
+
+    log.header(`Adding skill bundle: ${bundle.name} (${scope})...`)
+
+    let totalFiles = 0
+
+    // Project-level install
+    if (scope === 'project' || scope === 'both') {
+      const files = scaffoldSkillBundles(projectRoot, config.platforms, [bundleId])
+      totalFiles += files.length
+    }
+
+    // Global install
+    if (scope === 'global' || scope === 'both') {
+      const files = scaffoldSkillBundlesGlobal([bundleId])
+      totalFiles += files.length
+      log.info(`  Global: ${files.length} files → ~/.claude/skills/`)
+    }
+
+    if (totalFiles > 0) {
+      log.success(`  ${totalFiles} file(s) installed`)
+    }
+
+    // Update config
+    writeConfig(projectRoot, config)
+    log.success(`\nSkill bundle "${bundleId}" added.`)
+    log.plain('')
+  } catch (err) {
+    log.error(`Add skill bundle failed: ${err.message}`)
+    log.verbose(err.stack)
+    process.exit(1)
+  }
+}

package/lib/commands/init.mjs

@@ -7,7 +7,7 @@ import {
 } from '../prompts.mjs'
 import {
   scaffoldBase, scaffoldFramework, scaffoldPlatforms,
-  scaffoldWorkflows, scaffoldSkills, scaffoldSkillBundles,
+  scaffoldWorkflows, scaffoldSkills, scaffoldSkillBundles, scaffoldSkillBundlesGlobal,
   runTemplateReplace, generateQuickStart,
 } from '../scaffold.mjs'
 import { runSync } from './sync.mjs'
@@ -28,7 +28,7 @@ export async function runInit(opts = {}) {
     }
 
     // Gather configuration
-    let projectName, projectDescription, framework, platforms, workflowPacks, skillPacks, skillBundles
+    let projectName, projectDescription, framework, platforms, workflowPacks, skillPacks, skillBundles, superpowersScope
 
     if (opts.smart) {
       // --smart: zero-question fully auto-detected init
@@ -46,6 +46,7 @@ export async function runInit(opts = {}) {
       )
       workflowPacks = WORKFLOW_PACKS.map(w => w.id)
       skillBundles = SKILL_BUNDLES.map(b => b.id)
+      superpowersScope = 'project'
 
       log.info('  Smart mode: auto-detecting project configuration...')
       log.plain(`    Name:         ${projectName}`)
@@ -67,6 +68,7 @@ export async function runInit(opts = {}) {
       workflowPacks = []
       skillPacks = []
       skillBundles = []
+      superpowersScope = 'project'
     } else if (opts.yes) {
       // -y: Auto-detect as much as possible, fill remaining with defaults
       const detected = autoDetect(projectRoot)
@@ -77,6 +79,7 @@ export async function runInit(opts = {}) {
       workflowPacks = WORKFLOW_PACKS.map(w => w.id)
       skillPacks = discoverSkillPacks().map(s => s.id)
       skillBundles = SKILL_BUNDLES.map(b => b.id)
+      superpowersScope = 'project'
     } else {
       // Interactive flow with auto-detection
       const answers = await runInteractivePrompts(projectRoot)
@@ -87,6 +90,7 @@ export async function runInit(opts = {}) {
       workflowPacks = answers.workflowPacks
       skillPacks = answers.skillPacks
       skillBundles = answers.skillBundles
+      superpowersScope = answers.superpowersScope || 'project'
     }
 
     // Build extended vars from auto-detection for template replacement
@@ -198,12 +202,28 @@ export async function runInit(opts = {}) {
 
     // Step 6b: Install skill bundles (e.g. Superpowers)
     if (skillBundles.length > 0) {
+      const scope = superpowersScope || 'project'
       for (const bundleId of skillBundles) {
         const bundle = SKILL_BUNDLES.find(b => b.id === bundleId)
         if (!bundle) continue
-        log.header(`Installing ${bundle.name}...`)
-        const bundleFiles = scaffoldSkillBundles(projectRoot, platforms, [bundleId])
-        log.success(`  ${bundleFiles.length} files (14 skills + agents)`)
+        log.header(`Installing ${bundle.name} (${scope})...`)
+
+        let totalFiles = 0
+
+        // Project-level install
+        if (scope === 'project' || scope === 'both') {
+          const bundleFiles = scaffoldSkillBundles(projectRoot, platforms, [bundleId])
+          totalFiles += bundleFiles.length
+        }
+
+        // Global install (~/.claude/skills/)
+        if (scope === 'global' || scope === 'both') {
+          const globalFiles = scaffoldSkillBundlesGlobal([bundleId])
+          totalFiles += globalFiles.length
+          log.info(`  Global: ${globalFiles.length} files → ~/.claude/skills/`)
+        }
+
+        log.success(`  ${totalFiles} files (14 skills + agents)`)
       }
     }
 
@@ -217,6 +237,7 @@ export async function runInit(opts = {}) {
       workflowPacks,
       skillPacks,
       skillBundles,
+      superpowersScope: superpowersScope || 'project',
       detected: {
         packageManager: vars.packageManager,
         primaryLanguage: vars.primaryLanguage,

package/lib/commands/list.mjs

@@ -1,6 +1,6 @@
 import { join } from 'path'
 import { existsSync, readdirSync, readFileSync } from 'fs'
-import { findProjectRoot, readConfig, PLATFORMS, WORKFLOW_PACKS, discoverSkills, discoverSkillPacks } from '../utils.mjs'
+import { findProjectRoot, readConfig, PLATFORMS, WORKFLOW_PACKS, SKILL_BUNDLES, discoverSkills, discoverSkillPacks } from '../utils.mjs'
 import log from '../log.mjs'
 import pc from 'picocolors'
 
@@ -56,6 +56,20 @@ export async function runList(opts = {}) {
     log.dim('  No skill packs installed')
   }
 
+  // Skill Bundles
+  log.header('Skill Bundles')
+  if (config.skillBundles?.length > 0) {
+    const scope = config.superpowersScope || 'project'
+    for (const bundleId of config.skillBundles) {
+      const bundle = SKILL_BUNDLES.find(b => b.id === bundleId)
+      const name = bundle ? bundle.name : bundleId
+      const desc = bundle ? pc.dim(`— ${bundle.description}`) : ''
+      log.plain(`  ${pc.green('✓')} ${name} ${desc} ${pc.dim(`(${scope})`)}`)
+    }
+  } else {
+    log.dim('  No skill bundles installed')
+  }
+
   // Workflow Packs
   log.header('Workflow Packs')
   if (config.workflowPacks?.length > 0) {

package/lib/prompts.mjs

@@ -249,17 +249,44 @@ export async function askWorkflowPacks() {
   }))
 
   const choices = [...workflowChoices, ...bundleChoices]
-  if (choices.length === 0) return { workflowPacks: [], skillBundles: [] }
+  if (choices.length === 0) return { workflowPacks: [], skillBundles: [], superpowersScope: 'project' }
 
   const selected = await checkbox({
     message: 'Install workflow packs? (space to toggle, enter to confirm)',
     choices,
   })
 
-  return {
-    workflowPacks: selected.filter(s => s.type === 'workflow').map(s => s.id),
-    skillBundles: selected.filter(s => s.type === 'bundle').map(s => s.id),
+  const workflowPacks = selected.filter(s => s.type === 'workflow').map(s => s.id)
+  const skillBundles = selected.filter(s => s.type === 'bundle').map(s => s.id)
+
+  // Ask install scope if Superpowers was selected
+  let superpowersScope = 'project'
+  if (skillBundles.includes('superpowers')) {
+    superpowersScope = await askSuperpowersScope()
   }
+
+  return { workflowPacks, skillBundles, superpowersScope }
+}
+
+export async function askSuperpowersScope() {
+  return select({
+    message: 'Superpowers install scope:',
+    choices: [
+      {
+        name: 'Project-level (recommended) — Install to project platform dirs',
+        value: 'project',
+      },
+      {
+        name: 'Global (~/.claude/skills/) — Install to user home, works across all projects',
+        value: 'global',
+      },
+      {
+        name: 'Both — Install to both locations',
+        value: 'both',
+      },
+    ],
+    default: 'project',
+  })
 }
 
 export async function askSkillPacks() {
@@ -328,10 +355,10 @@ export async function runInteractivePrompts(projectRoot) {
     platforms = await askPlatforms(detected.platforms)
   }
 
-  const { workflowPacks, skillBundles } = await askWorkflowPacks()
+  const { workflowPacks, skillBundles, superpowersScope } = await askWorkflowPacks()
   const skillPacks = await askSkillPacks()
 
-  return { projectName, projectDescription, framework, platforms, workflowPacks, skillBundles, skillPacks }
+  return { projectName, projectDescription, framework, platforms, workflowPacks, skillBundles, skillPacks, superpowersScope }
 }
 
 /**

package/lib/scaffold.mjs

@@ -1,4 +1,5 @@
 import { join, relative } from 'path'
+import { homedir } from 'os'
 import { existsSync, readdirSync, readFileSync, writeFileSync } from 'fs'
 import {
   copyDir, ensureDir, writeIfNotExists, writeWithMarker, templateReplace, getTemplatesDir, MARKERS,
@@ -282,6 +283,43 @@ export function scaffoldSkillBundles(projectRoot, platforms, bundleIds) {
   return created
 }
 
+/**
+ * Install skill bundles globally to ~/.claude/skills/ and ~/.claude/agents/.
+ * Works across all projects (Claude Code only).
+ */
+export function scaffoldSkillBundlesGlobal(bundleIds) {
+  const templatesDir = getTemplatesDir()
+  const home = homedir()
+  const created = []
+
+  for (const bundleId of bundleIds) {
+    const bundle = SKILL_BUNDLES.find(b => b.id === bundleId)
+    if (!bundle) continue
+
+    const bundleDir = join(templatesDir, bundle.templateDir)
+    if (!existsSync(bundleDir)) continue
+
+    // Install each skill subdirectory to ~/.claude/skills/
+    for (const entry of readdirSync(bundleDir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue
+      if (entry.name === '_agents') continue
+
+      const skillSrc = join(bundleDir, entry.name)
+      const dest = join(home, '.claude', 'skills', entry.name)
+      copyRecursiveIfNotExists(skillSrc, dest, home, created)
+    }
+
+    // Install agents to ~/.claude/agents/
+    const agentsDir = join(bundleDir, '_agents')
+    if (existsSync(agentsDir)) {
+      const destDir = join(home, '.claude', 'agents')
+      copyRecursiveIfNotExists(agentsDir, destDir, home, created)
+    }
+  }
+
+  return created
+}
+
 /** Helper: recursively copy files, skip existing */
 function copyRecursiveIfNotExists(src, dest, projectRoot, created) {
   ensureDir(dest)

package/lib/schema.mjs

@@ -65,6 +65,13 @@ export function validateConfig(config) {
     }
   }
 
+  // Superpowers scope
+  if (config.superpowersScope !== undefined) {
+    if (!['project', 'global', 'both'].includes(config.superpowersScope)) {
+      warnings.push(`"superpowersScope" should be one of: project, global, both`)
+    }
+  }
+
   // Workflow packs validation
   if (Array.isArray(config.workflowPacks)) {
     for (const w of config.workflowPacks) {
@@ -97,7 +104,7 @@ export function validateConfig(config) {
   // Warn on unknown top-level keys
   const knownKeys = new Set([
     'version', 'projectName', 'projectDescription', 'framework',
-    'platforms', 'workflowPacks', 'skillPacks', 'skillBundles', 'packages', 'detected',
+    'platforms', 'workflowPacks', 'skillPacks', 'skillBundles', 'superpowersScope', 'packages', 'detected',
   ])
   for (const key of Object.keys(config)) {
     if (!knownKeys.has(key)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siliconoid/agentkit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CLI tool to initialize and manage AI coding rules across multiple platforms",
   "type": "module",
   "bin": {