@rfxlamia/skillkit 1.0.0

package/src/picker.js

@@ -0,0 +1,74 @@
+import { multiselect, select, log } from '@clack/prompts'
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const manifest = JSON.parse(readFileSync(join(__dirname, '..', 'skills-manifest.json'), 'utf8'))
+
+const CATEGORY_ICONS = {
+  core: '⚙️',
+  engineering: '🧠',
+  documentation: '📖',
+  planning: '📐',
+  deployment: '🚀',
+  productivity: '📊',
+  quality: '🛡️',
+  security: '🔒',
+  experimentation: '🧪',
+  'agent-frameworks': '🤖',
+  creative: '✍️',
+  uncategorized: '  '
+}
+
+export function getCategoryDisplay(skill) {
+  const icon = CATEGORY_ICONS[skill.category] || CATEGORY_ICONS.uncategorized
+  const label = skill.category ? skill.category.replace(/-/g, ' ') : ''
+  return `${icon} ${label}`
+}
+
+export async function pickInstallables() {
+  const mode = await select({
+    message: 'What to install?',
+    options: [
+      { value: 'all', label: 'Everything (24 skills + 7 agents)' },
+      { value: 'skills-only', label: 'All skills only' },
+      { value: 'agents-only', label: 'All agents only' },
+      { value: 'pick', label: 'Let me choose...' }
+    ]
+  })
+
+  if (mode === 'all') return { skills: manifest.skills, agents: manifest.agents }
+  if (mode === 'skills-only') return { skills: manifest.skills, agents: [] }
+  if (mode === 'agents-only') return { skills: [], agents: manifest.agents }
+
+  // Manual pick
+  const skillChoices = manifest.skills.map(s => ({
+    value: s.name,
+    label: `${getCategoryDisplay(s)} ${s.name}`,
+    hint: s.description.slice(0, 60) + (s.description.length > 60 ? '…' : '')
+  }))
+
+  const agentChoices = manifest.agents.map(a => ({
+    value: a.name,
+    label: `🤝 ${a.name}`,
+    hint: a.description.slice(0, 60) + (a.description.length > 60 ? '…' : '')
+  }))
+
+  const selectedSkills = await multiselect({
+    message: 'Select skills to install: (space to toggle, a to select all)',
+    options: skillChoices,
+    required: false
+  })
+
+  const selectedAgents = await multiselect({
+    message: 'Select agents to install:',
+    options: agentChoices,
+    required: false
+  })
+
+  return {
+    skills: manifest.skills.filter(s => selectedSkills.includes(s.name)),
+    agents: manifest.agents.filter(a => selectedAgents.includes(a.name))
+  }
+}

package/src/picker.test.js

@@ -0,0 +1,21 @@
+import { test } from 'node:test'
+import assert from 'node:assert'
+import { getCategoryDisplay } from './picker.js'
+
+test('getCategoryDisplay returns icon and category label', () => {
+  const skill = { name: 'test-skill', category: 'creative' }
+  const result = getCategoryDisplay(skill)
+  assert.strictEqual(result, '✍️ creative')
+})
+
+test('getCategoryDisplay handles uncategorized skills', () => {
+  const skill = { name: 'test-skill', category: 'unknown-category' }
+  const result = getCategoryDisplay(skill)
+  assert.strictEqual(result, '   unknown category')
+})
+
+test('getCategoryDisplay handles missing category', () => {
+  const skill = { name: 'test-skill' }
+  const result = getCategoryDisplay(skill)
+  assert.strictEqual(result, '   ')
+})

package/src/scope.js

@@ -0,0 +1,57 @@
+import { select, log } from '@clack/prompts'
+import { homedir } from 'os'
+import { join } from 'path'
+import { existsSync } from 'fs'
+
+export async function selectScope() {
+  const userSkillsPath = join(homedir(), '.claude', 'skills')
+  const projectSkillsPath = join(process.cwd(), '.claude', 'skills')
+  const projectExists = existsSync(join(process.cwd(), '.claude', 'skills'))
+
+  const scope = await select({
+    message: 'Install to:',
+    options: [
+      {
+        value: 'user',
+        label: `User scope  ~/.claude/skills/`,
+        hint: 'available in all projects'
+      },
+      {
+        value: 'project',
+        label: `Project scope  ./.claude/skills/`,
+        hint: projectExists ? 'detected .claude/skills/ here' : `will create ${projectSkillsPath}`
+      }
+    ]
+  })
+
+  if (scope === 'user') {
+    return {
+      scope: 'user',
+      skillsDir: userSkillsPath,
+      agentsDir: join(homedir(), '.claude', 'agents')
+    }
+  }
+
+  return {
+    scope: 'project',
+    skillsDir: projectSkillsPath,
+    agentsDir: join(process.cwd(), '.claude', 'agents')
+  }
+}
+
+// Export for testing
+export function getUserScope() {
+  return {
+    scope: 'user',
+    skillsDir: join(homedir(), '.claude', 'skills'),
+    agentsDir: join(homedir(), '.claude', 'agents')
+  }
+}
+
+export function getProjectScope() {
+  return {
+    scope: 'project',
+    skillsDir: join(process.cwd(), '.claude', 'skills'),
+    agentsDir: join(process.cwd(), '.claude', 'agents')
+  }
+}

package/src/scope.test.js

@@ -0,0 +1,19 @@
+import { test } from 'node:test'
+import assert from 'node:assert'
+import { homedir } from 'os'
+import { join } from 'path'
+import { getUserScope, getProjectScope } from './scope.js'
+
+test('getUserScope returns correct paths', () => {
+  const scope = getUserScope()
+  assert.strictEqual(scope.scope, 'user')
+  assert.strictEqual(scope.skillsDir, join(homedir(), '.claude', 'skills'))
+  assert.strictEqual(scope.agentsDir, join(homedir(), '.claude', 'agents'))
+})
+
+test('getProjectScope returns correct paths', () => {
+  const scope = getProjectScope()
+  assert.strictEqual(scope.scope, 'project')
+  assert.strictEqual(scope.skillsDir, join(process.cwd(), '.claude', 'skills'))
+  assert.strictEqual(scope.agentsDir, join(process.cwd(), '.claude', 'agents'))
+})

package/src/update.js

@@ -0,0 +1,34 @@
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+import { log, select } from '@clack/prompts'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'))
+
+export async function checkForUpdates() {
+  // npx always runs latest — no need to check
+  if (process.env.npm_execpath?.includes('npx')) return
+
+  try {
+    const res = await fetch(`https://registry.npmjs.org/@rfxlamia/skillkit/latest`)
+    if (!res.ok) {
+      if (process.env.DEBUG) log.warn(`Update check failed: HTTP ${res.status}`)
+      return
+    }
+    const { version: latest } = await res.json()
+
+    if (latest !== pkg.version) {
+      log.warn(`Update available: ${pkg.version} → ${latest}`)
+      log.info(`Run: npx @rfxlamia/skillkit@latest install`)
+    }
+  } catch (err) {
+    // Network unavailable or other errors — log in debug mode
+    if (process.env.DEBUG) log.warn(`Update check failed: ${err.message}`)
+  }
+}
+
+// Export for testing
+export function isNpxExecution() {
+  return process.env.npm_execpath?.includes('npx') ?? false
+}

package/src/update.test.js

@@ -0,0 +1,24 @@
+import { test } from 'node:test'
+import assert from 'node:assert'
+import { isNpxExecution } from './update.js'
+
+test('isNpxExecution returns true when npm_execpath includes npx', () => {
+  const original = process.env.npm_execpath
+  process.env.npm_execpath = '/usr/local/lib/node_modules/npm/bin/npx-cli.js'
+  assert.strictEqual(isNpxExecution(), true)
+  process.env.npm_execpath = original
+})
+
+test('isNpxExecution returns false when npm_execpath does not include npx', () => {
+  const original = process.env.npm_execpath
+  process.env.npm_execpath = '/usr/local/lib/node_modules/npm/bin/npm-cli.js'
+  assert.strictEqual(isNpxExecution(), false)
+  process.env.npm_execpath = original
+})
+
+test('isNpxExecution returns false when npm_execpath is undefined', () => {
+  const original = process.env.npm_execpath
+  delete process.env.npm_execpath
+  assert.strictEqual(isNpxExecution(), false)
+  process.env.npm_execpath = original
+})