@skilldeck/cli 0.1.0 → 0.1.1

package/README.md

@@ -14,8 +14,9 @@ npx @skilldeck/cli add cartograph disciplines
 ## Commands
 
 ```bash
-skilldeck add <pack...>      # install (use "all" for every pack)
-skilldeck remove <pack...>   # uninstall exactly what was installed
+skilldeck add <pack...>              # install whole packs ("all" for every pack)
+skilldeck add disciplines/test-first  # install a single skill
+skilldeck remove <pack|pack/skill...> # uninstall exactly what was installed
 skilldeck list               # available packs and where they're installed
 ```
 
@@ -24,6 +25,7 @@ skilldeck list               # available packs and where they're installed
 | Flag | Meaning |
 |---|---|
 | `-a, --agent <name>` | `claude` (default), `codex`, `agents`, `all`, or a comma list |
+| `-s, --skill <name>` | Only these skills from the named pack (repeat, or comma-separate) |
 | `-p, --project` | Install into the current project (`./.claude/skills`, ...) instead of your home folder |
 | `-f, --force` | Replace skill folders SkillDeck didn't install |
 | `--dry-run` | Show what would happen without writing anything |

package/bin/skilldeck.mjs

@@ -10,8 +10,8 @@ const { version } = JSON.parse(fs.readFileSync(new URL('../package.json', import
 const HELP = `${bold('skilldeck')} ${version}: skill packs for coding agents
 
 Usage:
-  npx @skilldeck/cli add <pack...> [options]      install packs (e.g. add cartograph disciplines)
-  npx @skilldeck/cli remove <pack...> [options]   uninstall packs
+  npx @skilldeck/cli add <pack|pack/skill...>     install packs or single skills
+  npx @skilldeck/cli remove <pack|pack/skill...>  uninstall packs or single skills
   npx @skilldeck/cli list                         available packs and where they're installed
 
 Packs:
@@ -23,15 +23,29 @@ ${OPTIONS_HELP}
 
 Examples:
   npx @skilldeck/cli add cartograph disciplines
+  npx @skilldeck/cli add disciplines/test-first disciplines/verify-before-done
   npx @skilldeck/cli add cartograph --agent all --project
   npx @skilldeck/cli remove disciplines`
 
-function resolvePacks(names) {
+/**
+ * Accepts pack names and pack/skill pairs, e.g. `cartograph disciplines/test-first`.
+ * Returns [{ pack, skills }] where skills is undefined for a whole pack.
+ */
+function resolvePacks(names, skillFlag) {
   if (names.length === 0) throw new Error('Name at least one pack, e.g. `skilldeck add cartograph`.')
-  const list = names.includes('all') ? Object.keys(PACKS) : names
-  const unknown = list.filter((n) => !PACKS[n])
-  if (unknown.length) throw new Error(`Unknown pack: ${unknown.join(', ')}. Available: ${Object.keys(PACKS).join(', ')}`)
-  return list.map((n) => PACKS[n])
+  const wanted = new Map()
+  for (const raw of names.includes('all') ? Object.keys(PACKS) : names) {
+    const [name, skill] = raw.split(/[/:]/)
+    if (!PACKS[name]) throw new Error(`Unknown pack: ${name}. Available: ${Object.keys(PACKS).join(', ')}`)
+    if (!skill) wanted.set(name, null)
+    else if (wanted.get(name) !== null) wanted.set(name, [...(wanted.get(name) ?? []), skill])
+  }
+  if (skillFlag) {
+    if (wanted.size !== 1) throw new Error('--skill works with exactly one pack. Use pack/skill to mix packs, e.g. disciplines/test-first.')
+    const [name] = wanted.keys()
+    wanted.set(name, [...(wanted.get(name) ?? []), ...skillFlag])
+  }
+  return [...wanted].map(([name, skills]) => ({ pack: PACKS[name], skills: skills ?? undefined }))
 }
 
 try {
@@ -42,11 +56,16 @@ try {
   if (values.version) console.log(version)
   else if (values.help || !cmd || cmd === 'help') console.log(HELP)
   else if (cmd === 'add' || cmd === 'install' || cmd === 'i') {
-    const packs = resolvePacks(names)
-    for (const p of packs) printInstall(p, install(p, opts))
-    if (!opts.dryRun && packs.some((p) => p.hook)) console.log(dim('\nRestart your agent (or run /clear in Claude Code) to load session hooks.'))
+    const picks = resolvePacks(names, opts.skills)
+    let hooked = false
+    for (const { pack, skills } of picks) {
+      const r = install(pack, { ...opts, skills })
+      printInstall(pack, r)
+      hooked ||= r.some((x) => x.hook)
+    }
+    if (!opts.dryRun && hooked) console.log(dim('\nRestart your agent (or run /clear in Claude Code) to load session hooks.'))
   } else if (cmd === 'remove' || cmd === 'uninstall' || cmd === 'rm') {
-    for (const p of resolvePacks(names)) printUninstall(p.name, uninstall(p.name, opts))
+    for (const { pack, skills } of resolvePacks(names, opts.skills)) printUninstall(pack.name, uninstall(pack.name, { ...opts, skills }))
   } else if (cmd === 'list' || cmd === 'ls' || cmd === 'status') {
     console.log(bold('Available'))
     for (const p of Object.values(PACKS)) console.log(`  ${p.name}@${p.version}  ${dim(`${p.skills.length} skill${p.skills.length === 1 ? '' : 's'}${p.hook ? ' + hook' : ''}`)}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skilldeck/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Install SkillDeck skill packs (cartograph, disciplines) into Claude Code, Codex and other SKILL.md agents.",
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@skilldeck/core": "^0.1.0",
+    "@skilldeck/core": "^0.1.1",
     "@skilldeck/cartograph": "^0.1.0",
     "@skilldeck/disciplines": "^0.1.0"
   },