@mzwin/kit-core

One skill library. Claude, Codex, and Grok.
Install once. Link everywhere. Clean the mess when agents pile up.

---

Install

npm i -g @mzwin/kit
kit --version

Node 20+. Command name: kit.

kit                  # status + next command
kit ready --write    # pack → install → apply → link → doctor
kit unify --write --link
kit tui              # keyboard console + calm side mascot

---

---

Clean agent skill folders

_{Scan · filter noise · keep what earns a place.}

kit unify
kit unify --write
kit unify --write --link

---

One-shot project setup

_{Recommend · install · apply · link · doctor.}

kit ready
kit ready --write
kit ready --write --unify

---

Link the library to agents

_{Library → Claude · Codex · Grok.}

kit link --to all --write
kit import --from claude-code --write

---

Starter packs

A pack is a skill set for one project type. Most extend essentials.

Pack	Use when	Extra skills
essentials	Any project. Start here.	—
web-app	Sites and UI	ship-checklist, a11y-pass, pr-ready
library	Packages and SDKs	api-docs, changelog, pr-ready
cli-tool	CLIs	cli-help, pr-ready
api-service	HTTP APIs	api-docs, ship-checklist, pr-ready
full-stack	UI + API	ship-checklist, a11y-pass, api-docs, pr-ready
data-ml	Data / ML	data-check, write-tests, pr-ready

kit pack list
kit recommend --dir .
kit pack apply essentials --dir .

---

Skills

Short instruction files. Agents load them when the task matches.

Skill	Does
add-readme	Project README
project-setup	Clean baseline for agents and humans
workspace-setup	Monorepo / multi-package layout
code-review	Correctness, risk, clarity
write-tests	Tests for important behavior
fix-bug	Root cause + fix without drive-by refactors
pr-ready	PR summary, test plan, risk
ship-checklist	Pre-ship checklist
a11y-pass	Basic UI accessibility
api-docs	API docs with examples
changelog	Changelog entry
cli-help	Help text, usage, flags
data-check	Data scripts / notebooks

kit list
kit pack show essentials

More: docs/packs.md

---

Commands

Command	Purpose
kit	Status + next step
kit ready --write	Make this repo agent-ready
kit unify --write	Clean Claude/Codex/Grok skill dumps
kit unify --write --link	Clean + link into the project
kit recommend --dir .	Suggest a pack
kit pack apply <name> --dir .	Apply pack skills
kit link --to all --write	Link library to agents
kit import --from claude-code --write	Import from one agent
kit doctor	Install health
kit tui	Terminal UI

---

How it works

1. Skills live in ~/.kit.
2. Packs install groups into that library.
3. link exposes them to each agent.
4. unify imports and cleans skills already in agent folders.

TUI: fixed side rail for the mascot (animation does not resize the menu). ↑↓ shows direction. KIT_REDUCED_MOTION=1 freezes motion.

Agents: Claude Code · Codex · Grok Build.

---

From source

git clone https://github.com/Zwin-ux/kit.git
cd kit
pnpm install && pnpm build
pnpm kit doctor
pnpm kit tui
# or:  pnpm tui
# also: pnpm kit -- tui   (npm-style; leading -- is stripped)

Run from the repo root, not your home folder. kit tui needs an interactive terminal (real TTY).

---

_{Skills your agents use.}

_{MIT · npm · Changelog}