learn-skill.md 1.0.0

package/README.md

@@ -0,0 +1,64 @@
+# learn-skill
+
+Install AI agent skills from [learn-skill.md](https://learn-skill.md) — the skill marketplace for AI agents.
+
+## Quick Install
+
+```bash
+npx learn-skill add <slug>
+```
+
+## Usage
+
+```bash
+# install a skill (interactive agent picker)
+npx learn-skill add my-skill
+
+# install to a specific agent
+npx learn-skill add my-skill -a claude
+npx learn-skill add my-skill -a cursor
+
+# skip confirmation
+npx learn-skill add my-skill -a claude -y
+
+# search for skills
+npx learn-skill search "unit test"
+
+# list recent skills
+npx learn-skill list
+
+# show supported agents
+npx learn-skill agents
+```
+
+## Supported Agents
+
+| Agent | Skills Directory |
+|-------|-----------------|
+| Claude Code | `~/.claude/skills/` |
+| Cursor | `~/.cursor/skills/` |
+| Codex | `~/.codex/skills/` |
+| Windsurf | `~/.windsurf/skills/` |
+| Continue | `~/.continue/skills/` |
+| OpenCode | `~/.opencode/skills/` |
+| Amp | `~/.amp/skills/` |
+
+The CLI auto-detects which agents are installed on your machine.
+
+## How It Works
+
+1. Fetches the skill from learn-skill.md
+2. Asks which agent(s) to install to (or use `-a` flag)
+3. Downloads the skill as `.tar.gz`
+4. Extracts to the agent's skills directory
+
+## Also works with
+
+```bash
+bunx learn-skill add my-skill
+pnpm dlx learn-skill add my-skill
+```
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+
+import { parseArgs } from 'node:util'
+import { add } from '../src/install.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
+
+  usage:
+    learn-skill.md add <slug>          install a skill
+    learn-skill.md add <slug> -a claude   install to a specific agent
+    learn-skill.md search <query>      search for skills
+    learn-skill.md list                list recent skills
+    learn-skill.md agents              show supported agents
+
+  options:
+    -a, --agent <name>    target agent (claude, cursor, codex, windsurf, etc.)
+    -y, --yes             skip confirmation
+    -h, --help            show this help
+    -v, --version         show version
+
+  examples:
+    npx learn-skill.md add my-skill
+    npx learn-skill.md add my-skill -a cursor
+    npx learn-skill.md search "unit test"
+`
+
+const { values, positionals } = parseArgs({
+  allowPositionals: true,
+  options: {
+    agent: { type: 'string', short: 'a' },
+    yes: { type: 'boolean', short: 'y', default: false },
+    help: { type: 'boolean', short: 'h', default: false },
+    version: { type: 'boolean', short: 'v', default: false },
+  },
+})
+
+const [command, ...args] = positionals
+
+if (values.version) {
+  console.log('learn-skill.md v1.0.0')
+  process.exit(0)
+}
+
+if (values.help || !command) {
+  console.log(HELP)
+  process.exit(0)
+}
+
+async function main() {
+  switch (command) {
+    case 'add':
+    case 'install': {
+      const slug = args[0]
+      if (!slug) {
+        console.error('  error: missing skill slug\n  usage: learn-skill.md add <slug>')
+        process.exit(1)
+      }
+      await add(slug, { agent: values.agent, yes: values.yes })
+      break
+    }
+    case 'search':
+    case 'find': {
+      const query = args.join(' ')
+      if (!query) {
+        console.error('  error: missing search query\n  usage: learn-skill.md search <query>')
+        process.exit(1)
+      }
+      await search(query)
+      break
+    }
+    case 'list':
+    case 'ls': {
+      await list()
+      break
+    }
+    case 'agents': {
+      console.log('\n  supported agents:\n')
+      const detected = detectAgents()
+      for (const a of AGENTS) {
+        const installed = detected.includes(a.id) ? ' (detected)' : ''
+        console.log(`    ${a.id.padEnd(14)} ${a.dir}${installed}`)
+      }
+      console.log()
+      break
+    }
+    default:
+      console.error(`  unknown command: ${command}`)
+      console.log(HELP)
+      process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error(`\n  error: ${err.message}`)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "learn-skill.md",
+  "version": "1.0.0",
+  "description": "Install AI agent skills from learn-skill.md — the skill marketplace for AI agents",
+  "type": "module",
+  "bin": {
+    "learn-skill.md": "./bin/cli.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai",
+    "skills",
+    "claude-code",
+    "cursor",
+    "codex",
+    "windsurf",
+    "continue",
+    "opencode",
+    "amp",
+    "agent",
+    "skill-installer",
+    "skill-marketplace",
+    "learn-skill",
+    "npx"
+  ],
+  "author": "froogooofficial",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/froogooofficial/lear-skill.com"
+  },
+  "homepage": "https://learn-skill.md"
+}

package/src/agents.mjs

@@ -0,0 +1,34 @@
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+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' },
+]
+
+export function detectAgents() {
+  const found = []
+  for (const agent of AGENTS) {
+    const configPath = join(home, agent.configDir)
+    if (existsSync(configPath)) {
+      found.push(agent.id)
+    }
+  }
+  return found
+}
+
+export function getAgent(id) {
+  return AGENTS.find((a) => a.id === id)
+}
+
+export function getSkillDir(agent) {
+  return join(home, agent.dir)
+}

package/src/api.mjs

@@ -0,0 +1,27 @@
+const BASE_URL = 'https://learn-skill.md'
+
+export async function get(path) {
+  const url = `${BASE_URL}${path}`
+  const res = await fetch(url)
+  if (!res.ok) {
+    throw new Error(`API error: ${res.status} ${res.statusText} (${path})`)
+  }
+  return res.json()
+}
+
+export async function download(path) {
+  const url = `${BASE_URL}${path}`
+  const res = await fetch(url)
+  if (!res.ok) {
+    throw new Error(`Download failed: ${res.status} ${res.statusText} (${path})`)
+  }
+  return res
+}
+
+export function rawUrl(slug) {
+  return `${BASE_URL}/raw/${slug}`
+}
+
+export function installUrl(slug) {
+  return `${BASE_URL}/install/${slug}`
+}

package/src/install.mjs

@@ -0,0 +1,99 @@
+import { mkdirSync, writeFileSync, existsSync, 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, installUrl } from './api.mjs'
+import { choose, chooseMultiple, confirm } from './prompt.mjs'
+
+export async function add(slug, opts = {}) {
+  // 1. fetch skill metadata
+  console.log(`\n  fetching skill: ${slug}...`)
+  const data = await get(`/api/skills/${slug}`)
+  const skill = data.skill
+
+  if (!skill) {
+    throw new Error(`skill "${slug}" not found`)
+  }
+
+  console.log(`  found: ${skill.title}`)
+  if (skill.description) console.log(`  ${skill.description}`)
+  console.log(`  files: ${skill.file_count} | size: ${(skill.file_size / 1024).toFixed(1)}KB`)
+
+  // 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...')
+  const url = installUrl(slug)
+  const res = await fetch(url)
+  if (!res.ok) {
+    throw new Error(`download failed: ${res.status}`)
+  }
+
+  const tmpFile = join(tmpdir(), `learn-skill-${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' })
+      console.log(`  done: ${skillDir}/${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  skill "${skill.title}" installed successfully!\n`)
+}

package/src/prompt.mjs

@@ -0,0 +1,54 @@
+import { createInterface } from 'node:readline'
+
+const rl = () =>
+  createInterface({ input: process.stdin, output: process.stdout })
+
+export function ask(question) {
+  return new Promise((resolve) => {
+    const r = rl()
+    r.question(question, (answer) => {
+      r.close()
+      resolve(answer.trim())
+    })
+  })
+}
+
+export async function choose(label, options) {
+  console.log(`\n  ${label}\n`)
+  options.forEach((opt, i) => {
+    console.log(`    ${i + 1}) ${opt.label}`)
+  })
+  console.log()
+
+  while (true) {
+    const answer = await ask(`  select [1-${options.length}]: `)
+    const num = parseInt(answer, 10)
+    if (num >= 1 && num <= options.length) {
+      return options[num - 1]
+    }
+    console.log(`  invalid choice, enter 1-${options.length}`)
+  }
+}
+
+export async function chooseMultiple(label, options) {
+  console.log(`\n  ${label}\n`)
+  options.forEach((opt, i) => {
+    console.log(`    ${i + 1}) ${opt.label}`)
+  })
+  console.log()
+
+  while (true) {
+    const answer = await ask(`  select [1-${options.length}, comma-separated]: `)
+    const nums = answer.split(',').map((s) => parseInt(s.trim(), 10))
+    const valid = nums.every((n) => n >= 1 && n <= options.length)
+    if (valid && nums.length > 0) {
+      return nums.map((n) => options[n - 1])
+    }
+    console.log(`  invalid choice, enter numbers 1-${options.length} separated by commas`)
+  }
+}
+
+export async function confirm(message) {
+  const answer = await ask(`  ${message} [y/N]: `)
+  return answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes'
+}

package/src/search.mjs

@@ -0,0 +1,35 @@
+import { get } from './api.mjs'
+
+export async function search(query) {
+  const data = await get(`/api/skills?q=${encodeURIComponent(query)}&limit=20`)
+  const skills = data.skills || []
+
+  if (skills.length === 0) {
+    console.log(`\n  no skills found for "${query}"\n`)
+    return
+  }
+
+  console.log(`\n  ${skills.length} skill(s) found:\n`)
+  for (const s of skills) {
+    const tags = s.tags?.length ? ` [${s.tags.join(', ')}]` : ''
+    console.log(`    ${s.slug.padEnd(30)} ${s.description || ''}${tags}`)
+  }
+  console.log(`\n  install: npx learn-skill add <slug>\n`)
+}
+
+export async function list() {
+  const data = await get('/api/skills/recent')
+  const skills = data.skills || []
+
+  if (skills.length === 0) {
+    console.log('\n  no skills available yet\n')
+    return
+  }
+
+  console.log('\n  recent skills:\n')
+  for (const s of skills) {
+    const tags = s.tags?.length ? ` [${s.tags.join(', ')}]` : ''
+    console.log(`    ${s.slug.padEnd(30)} ${s.description || ''}${tags}`)
+  }
+  console.log(`\n  install: npx learn-skill add <slug>\n`)
+}