learn-skill.md 1.0.3 → 1.0.4

package/bin/cli.mjs

@@ -2,6 +2,7 @@
 
 import { parseArgs } from 'node:util'
 import { add } from '../src/install.mjs'
+import { addPack } from '../src/install-pack.mjs'
 import { search, list } from '../src/search.mjs'
 import { AGENTS, detectAgents } from '../src/agents.mjs'
 
@@ -17,6 +18,7 @@ const HELP = `${BANNER}
   usage:
     learn-skill-md add <slug>          install a skill
     learn-skill-md add <slug> -a claude   install to a specific agent
+    learn-skill-md add-pack <slug>     install a skill pack
     learn-skill-md search <query>      search for skills
     learn-skill-md list                list recent skills
     learn-skill-md agents              show supported agents
@@ -46,7 +48,7 @@ const { values, positionals } = parseArgs({
 const [command, ...args] = positionals
 
 if (values.version) {
-  console.log('learn-skill-md v1.0.3')
+  console.log('learn-skill-md v1.0.4')
   process.exit(0)
 }
 
@@ -67,6 +69,16 @@ async function main() {
       await add(slug, { agent: values.agent, yes: values.yes })
       break
     }
+    case 'add-pack':
+    case 'install-pack': {
+      const slug = args[0]
+      if (!slug) {
+        console.error('  error: missing pack slug\n  usage: learn-skill-md add-pack <slug>')
+        process.exit(1)
+      }
+      await addPack(slug, { agent: values.agent, yes: values.yes })
+      break
+    }
     case 'search':
     case 'find': {
       const query = args.join(' ')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learn-skill.md",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Install AI agent skills from learn-skill.md — the skill marketplace for AI agents",
   "type": "module",
   "bin": {

package/src/api.mjs

@@ -25,3 +25,7 @@ export function rawUrl(slug) {
 export function installUrl(slug) {
   return `${BASE_URL}/install/${slug}`
 }
+
+export function installPackUrl(slug) {
+  return `${BASE_URL}/install/pack/${slug}`
+}

package/src/install-pack.mjs

@@ -0,0 +1,104 @@
+import { mkdirSync, createWriteStream } from 'node:fs'
+import { join } from 'node:path'
+import { execSync } from 'node:child_process'
+import { tmpdir } from 'node:os'
+import { pipeline } from 'node:stream/promises'
+import { Readable } from 'node:stream'
+
+import { AGENTS, detectAgents, getAgent, getSkillDir } from './agents.mjs'
+import { get, installPackUrl } from './api.mjs'
+import { chooseMultiple, confirm } from './prompt.mjs'
+
+export async function addPack(slug, opts = {}) {
+  // 1. fetch pack metadata
+  console.log(`\n  fetching pack: ${slug}...`)
+  const data = await get(`/api/packs/${slug}`)
+  const pack = data.pack
+
+  if (!pack) {
+    throw new Error(`pack "${slug}" not found`)
+  }
+
+  console.log(`  found: ${pack.name}`)
+  if (pack.description) console.log(`  ${pack.description}`)
+  console.log(`  skills: ${pack.skills.length}`)
+  for (const s of pack.skills) {
+    console.log(`    - ${s.slug}: ${s.title}`)
+  }
+
+  // 2. pick agent(s)
+  let agents = []
+
+  if (opts.agent) {
+    const agent = getAgent(opts.agent)
+    if (!agent) {
+      throw new Error(
+        `unknown agent "${opts.agent}". supported: ${AGENTS.map((a) => a.id).join(', ')}`
+      )
+    }
+    agents = [agent]
+  } else {
+    const detected = detectAgents()
+    const agentOptions = AGENTS.map((a) => ({
+      label: `${a.name}${detected.includes(a.id) ? ' (detected)' : ''}`,
+      value: a,
+    }))
+
+    const selected = await chooseMultiple('install to which agent(s)?', agentOptions)
+    agents = selected.map((s) => s.value)
+  }
+
+  if (agents.length === 0) {
+    console.log('  no agents selected, aborting.')
+    return
+  }
+
+  // 3. confirm
+  if (!opts.yes) {
+    console.log('\n  will install to:')
+    for (const a of agents) {
+      console.log(`    - ${a.name} (${getSkillDir(a)})`)
+    }
+    const ok = await confirm('proceed?')
+    if (!ok) {
+      console.log('  cancelled.')
+      return
+    }
+  }
+
+  // 4. download tar.gz to temp
+  console.log('\n  downloading pack...')
+  const url = installPackUrl(slug)
+  const res = await fetch(url)
+  if (!res.ok) {
+    throw new Error(`download failed: ${res.status}`)
+  }
+
+  const tmpFile = join(tmpdir(), `learn-skill-pack-${slug}-${Date.now()}.tar.gz`)
+  const fileStream = createWriteStream(tmpFile)
+  await pipeline(Readable.fromWeb(res.body), fileStream)
+
+  // 5. extract to each agent's skill dir
+  for (const agent of agents) {
+    const skillDir = getSkillDir(agent)
+    mkdirSync(skillDir, { recursive: true })
+
+    console.log(`  installing to ${agent.name}...`)
+    try {
+      execSync(`tar -xzf "${tmpFile}" -C "${skillDir}"`, { stdio: 'pipe' })
+      for (const s of pack.skills) {
+        console.log(`    ${skillDir}/${s.slug}/`)
+      }
+    } catch (err) {
+      console.error(`  failed to extract to ${agent.name}: ${err.message}`)
+    }
+  }
+
+  // 6. cleanup
+  try {
+    const { unlinkSync } = await import('node:fs')
+    unlinkSync(tmpFile)
+  } catch {}
+
+  console.log(`\n  pack "${pack.name}" (${pack.skills.length} skills) installed successfully!\n`)
+}