@captain_z/zsk

Minimal CLI for installing ZSK personal skills.

Supported commands:

zsk add [pattern...] --target <dir> --yes
zsk install [pattern...] --target <dir> --yes
zsk remove [pattern...] --target <dir> --yes
zsk list

Install

# Full skill pack
npx @captain_z/zsk add zsk --target ~/.agents/skills --yes

# Core loop subset
npx @captain_z/zsk add core --target ./tmp/skills --yes

# One skill
npx @captain_z/zsk add zsk:zsk-debug --target ./tmp/skills --yes

Patterns can be bundle names (zsk, core), exact skill names (zsk:zsk-debug, zsk-debug), or globs (zsk:*debug*).

add is additive: it merges new manifest entries with existing zsk-manifest.json entries and does not purge old installed skills. To cut over from an older bundle, run zsk remove 'zsk:*' --target <dir> --yes first, then run the new zsk add ... command. Use --on-conflict backup when replacing locally edited files you want to keep.

Layouts

• --format flat writes zsk-*/SKILL.md directories. This is the default.
• --format claude-plugin writes skills/, commands/, and .claude-plugin/plugin.json.
• --format codex-plugin writes skills/ and .codex-plugin/plugin.json.

Remove

remove reads zsk-manifest.json, expands exact/glob patterns against installed manifest entries, deletes manifest-owned files, and then rewrites the manifest.

zsk remove 'zsk:*debug*' --target ./tmp/skills --yes
zsk remove 'zsk:*' --target ./tmp/skills --yes

When the last skill is removed from a plugin layout, shared plugin metadata is removed too.

Bundles

• zsk: all 12 skills.
• core: setup, clarify, brief, prototype, slices, redgreen, debug, triage.
• custom: empty bundle used for explicit picks.