@skilldeck/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kitasid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @skilldeck/cli
+
+Install SkillDeck skill packs into your coding agent with one command.
+
+```bash
+npx @skilldeck/cli add cartograph disciplines
+```
+
+| Pack | What it does |
+|---|---|
+| [`cartograph`](https://www.npmjs.com/package/@skilldeck/cartograph) | Maps a codebase into a knowledge graph your agent queries instead of grepping |
+| [`disciplines`](https://www.npmjs.com/package/@skilldeck/disciplines) | Nine process skills (brainstorm, plan, test-first, debug, verify, review, finish) plus a SessionStart hook |
+
+## Commands
+
+```bash
+skilldeck add <pack...>      # install (use "all" for every pack)
+skilldeck remove <pack...>   # uninstall exactly what was installed
+skilldeck list               # available packs and where they're installed
+```
+
+## Options
+
+| Flag | Meaning |
+|---|---|
+| `-a, --agent <name>` | `claude` (default), `codex`, `agents`, `all`, or a comma list |
+| `-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 |
+
+## Where files go
+
+| Agent | User scope | Project scope (`--project`) |
+|---|---|---|
+| Claude Code | `~/.claude/skills/` + hook in `~/.claude/settings.json` | `.claude/skills/` + hook in `.claude/settings.json` |
+| Codex | `~/.codex/skills/` | `.codex/skills/` |
+| Other SKILL.md agents | `~/.agents/skills/` | `.agents/skills/` |
+
+Each skills folder gets a `.skilldeck.json` manifest, so `remove` deletes only what SkillDeck added. Your `settings.json` is backed up to `settings.json.bak` before every change.
+
+Requires Node 20+. MIT licensed.

package/bin/skilldeck.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import fs from 'node:fs'
+import { install, parse, printInstall, printStatus, printUninstall, status, toOpts, uninstall, OPTIONS_HELP, bold, dim, red } from '@skilldeck/core'
+import cartograph from '@skilldeck/cartograph'
+import disciplines from '@skilldeck/disciplines'
+
+const PACKS = { cartograph, disciplines }
+const { version } = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+
+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 list                         available packs and where they're installed
+
+Packs:
+${Object.values(PACKS)
+  .map((p) => `  ${p.name.padEnd(13)} ${dim(p.description)}`)
+  .join('\n')}
+
+${OPTIONS_HELP}
+
+Examples:
+  npx @skilldeck/cli add cartograph disciplines
+  npx @skilldeck/cli add cartograph --agent all --project
+  npx @skilldeck/cli remove disciplines`
+
+function resolvePacks(names) {
+  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])
+}
+
+try {
+  const { values, positionals } = parse(process.argv.slice(2))
+  const [cmd, ...names] = positionals
+  const opts = toOpts(values)
+
+  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.'))
+  } else if (cmd === 'remove' || cmd === 'uninstall' || cmd === 'rm') {
+    for (const p of resolvePacks(names)) printUninstall(p.name, uninstall(p.name, opts))
+  } 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' : ''}`)}`)
+    console.log(bold('\nInstalled'))
+    printStatus(status(opts))
+  } else {
+    throw new Error(`Unknown command "${cmd}". Run \`skilldeck --help\`.`)
+  }
+} catch (e) {
+  console.error(red('✗ ') + e.message)
+  process.exitCode = 1
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@skilldeck/cli",
+  "version": "0.1.0",
+  "description": "Install SkillDeck skill packs (cartograph, disciplines) into Claude Code, Codex and other SKILL.md agents.",
+  "type": "module",
+  "bin": {
+    "skilldeck": "bin/skilldeck.mjs"
+  },
+  "files": [
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@skilldeck/core": "^0.1.0",
+    "@skilldeck/cartograph": "^0.1.0",
+    "@skilldeck/disciplines": "^0.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "agent-skills",
+    "skill-md",
+    "cli"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "kitasid"
+}