learn-skill.md 1.0.2 → 1.0.4

package/bin/cli.mjs

@@ -2,15 +2,23 @@
 
 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'
 
-const HELP = `
-  learn-skill-md — install AI agent skills from learn-skill.md
+const BANNER = `
+  ▄▄    ▄▄▄▄▄  ▄▄▄  ▄▄▄▄  ▄▄  ▄▄      ▄▄▄▄ ▄▄ ▄▄ ▄▄ ▄▄    ▄▄      ▄▄   ▄▄ ▄▄▄▄
+  ██    ██▄▄  ██▀██ ██▄█▄ ███▄██ ▄▄▄ ███▄▄ ██▄█▀ ██ ██    ██      ██▀▄▀██ ██▀██
+  ██▄▄▄ ██▄▄▄ ██▀██ ██ ██ ██ ▀██     ▄▄██▀ ██ ██ ██ ██▄▄▄ ██▄▄▄ ▄ ██   ██ ████▀
+`
+
+const HELP = `${BANNER}
+  install AI agent skills from learn-skill.md
 
   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
@@ -40,7 +48,7 @@ const { values, positionals } = parseArgs({
 const [command, ...args] = positionals
 
 if (values.version) {
-  console.log('learn-skill-md v1.0.2')
+  console.log('learn-skill-md v1.0.4')
   process.exit(0)
 }
 
@@ -61,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.2",
+  "version": "1.0.4",
   "description": "Install AI agent skills from learn-skill.md — the skill marketplace for AI agents",
   "type": "module",
   "bin": {

package/src/agents.mjs

@@ -5,13 +5,47 @@ import { existsSync } from 'node:fs'
 const home = homedir()
 
 export const AGENTS = [
-  { id: 'claude',    name: 'Claude Code',   dir: '.claude/skills',    configDir: '.claude' },
-  { id: 'cursor',    name: 'Cursor',        dir: '.cursor/skills',    configDir: '.cursor' },
-  { id: 'codex',     name: 'Codex',         dir: '.codex/skills',     configDir: '.codex' },
-  { id: 'windsurf',  name: 'Windsurf',      dir: '.windsurf/skills',  configDir: '.windsurf' },
-  { id: 'continue',  name: 'Continue',      dir: '.continue/skills',  configDir: '.continue' },
-  { id: 'opencode',  name: 'OpenCode',      dir: '.opencode/skills',  configDir: '.opencode' },
-  { id: 'amp',       name: 'Amp',           dir: '.amp/skills',       configDir: '.amp' },
+  { id: 'claude-code',    name: 'Claude Code',     dir: '.claude/skills',                  configDir: '.claude' },
+  { id: 'cursor',         name: 'Cursor',          dir: '.cursor/skills',                  configDir: '.cursor' },
+  { id: 'codex',          name: 'Codex',           dir: '.codex/skills',                   configDir: '.codex' },
+  { id: 'windsurf',       name: 'Windsurf',        dir: '.codeium/windsurf/skills',        configDir: '.codeium' },
+  { id: 'github-copilot', name: 'GitHub Copilot',  dir: '.copilot/skills',                 configDir: '.copilot' },
+  { id: 'gemini-cli',     name: 'Gemini CLI',      dir: '.gemini/skills',                  configDir: '.gemini' },
+  { id: 'amp',            name: 'Amp',             dir: '.config/agents/skills',           configDir: '.config/agents' },
+  { id: 'continue',       name: 'Continue',        dir: '.continue/skills',                configDir: '.continue' },
+  { id: 'opencode',       name: 'OpenCode',        dir: '.config/opencode/skills',         configDir: '.config/opencode' },
+  { id: 'cline',          name: 'Cline',           dir: '.agents/skills',                  configDir: '.agents' },
+  { id: 'roo',            name: 'Roo Code',        dir: '.roo/skills',                     configDir: '.roo' },
+  { id: 'goose',          name: 'Goose',           dir: '.config/goose/skills',            configDir: '.config/goose' },
+  { id: 'augment',        name: 'Augment',         dir: '.augment/skills',                 configDir: '.augment' },
+  { id: 'kilo',           name: 'Kilo Code',       dir: '.kilocode/skills',                configDir: '.kilocode' },
+  { id: 'trae',           name: 'Trae',            dir: '.trae/skills',                    configDir: '.trae' },
+  { id: 'trae-cn',        name: 'Trae CN',         dir: '.trae-cn/skills',                 configDir: '.trae-cn' },
+  { id: 'antigravity',    name: 'Antigravity',     dir: '.gemini/antigravity/skills',      configDir: '.gemini/antigravity' },
+  { id: 'codebuddy',      name: 'CodeBuddy',       dir: '.codebuddy/skills',               configDir: '.codebuddy' },
+  { id: 'command-code',   name: 'Command Code',    dir: '.commandcode/skills',             configDir: '.commandcode' },
+  { id: 'cortex',         name: 'Cortex Code',     dir: '.snowflake/cortex/skills',        configDir: '.snowflake' },
+  { id: 'crush',          name: 'Crush',           dir: '.config/crush/skills',            configDir: '.config/crush' },
+  { id: 'droid',          name: 'Droid',           dir: '.factory/skills',                 configDir: '.factory' },
+  { id: 'iflow-cli',      name: 'iFlow CLI',       dir: '.iflow/skills',                   configDir: '.iflow' },
+  { id: 'junie',          name: 'Junie',           dir: '.junie/skills',                   configDir: '.junie' },
+  { id: 'kimi-cli',       name: 'Kimi Code CLI',   dir: '.config/agents/skills',           configDir: '.config/agents' },
+  { id: 'kiro-cli',       name: 'Kiro CLI',        dir: '.kiro/skills',                    configDir: '.kiro' },
+  { id: 'kode',           name: 'Kode',            dir: '.kode/skills',                    configDir: '.kode' },
+  { id: 'mcpjam',         name: 'MCPJam',          dir: '.mcpjam/skills',                  configDir: '.mcpjam' },
+  { id: 'mistral-vibe',   name: 'Mistral Vibe',    dir: '.vibe/skills',                    configDir: '.vibe' },
+  { id: 'mux',            name: 'Mux',             dir: '.mux/skills',                     configDir: '.mux' },
+  { id: 'openclaw',       name: 'OpenClaw',        dir: '.openclaw/skills',                configDir: '.openclaw' },
+  { id: 'openhands',      name: 'OpenHands',       dir: '.openhands/skills',               configDir: '.openhands' },
+  { id: 'pi',             name: 'Pi',              dir: '.pi/agent/skills',                configDir: '.pi' },
+  { id: 'qoder',          name: 'Qoder',           dir: '.qoder/skills',                   configDir: '.qoder' },
+  { id: 'qwen-code',      name: 'Qwen Code',       dir: '.qwen/skills',                    configDir: '.qwen' },
+  { id: 'replit',         name: 'Replit',          dir: '.config/agents/skills',           configDir: '.config/agents' },
+  { id: 'universal',      name: 'Universal',       dir: '.config/agents/skills',           configDir: '.config/agents' },
+  { id: 'zencoder',       name: 'Zencoder',        dir: '.zencoder/skills',                configDir: '.zencoder' },
+  { id: 'neovate',        name: 'Neovate',         dir: '.neovate/skills',                 configDir: '.neovate' },
+  { id: 'pochi',          name: 'Pochi',           dir: '.pochi/skills',                   configDir: '.pochi' },
+  { id: 'adal',           name: 'AdaL',            dir: '.adal/skills',                    configDir: '.adal' },
 ]
 
 export function detectAgents() {

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`)
+}