Quick Start

1. See what you have

ipman            # interactive TUI (in a terminal)
ipman status     # same panorama as text: every scope, every skill's state
ipman scan       # deep scan: wild skills, duplicates, broken links

Each skill shows a state quadruple: linkness (real/link/broken) × ownership (store/suite/foreign/native) × active/archived × duplicate group.

2. Absorb loose skills (接管技能)

ipman absorb --user            # list takeover candidates in ~/.claude/skills
ipman absorb --user my-notes   # take one over
ipman absorb --user --all      # every plain skill dir (clones & suites skipped)

Absorbing moves the folder into the central store as a fresh git repo (history starts there) and leaves a symlink — your agent sees exactly the same skill. Git clones, suite wrappers (e.g. gstack-managed) and marketplace plugins are never touched.

3. Dedup and clean

ipman dedup            # duplicate groups (dry-run)
ipman dedup --apply    # merge identical copies onto one stored original
ipman clean            # broken links / orphans / empty shells (dry-run)
ipman clean --apply    # quarantine them to ~/.ipman/trash (recoverable)

4. Switch skills off and on (停用/启用)

ipman disable my-notes --scope user   # link gone, original stays on disk
ipman enable  my-notes --scope user   # back, at the exact pinned version

The TUI's archive area (归档区) shows everything on this machine that's not active in the current scope — one keypress to enable.

5. Packs (功能包)

ipman pack create writing-kit my-notes baoyu-comic   # define a named set
ipman enable  --pack writing-kit --scope user        # load the whole set
ipman disable --pack writing-kit --scope user        # park the whole set

Packs are additive: several can be loaded in the same scope, they may overlap, and they work in projects too (--scope . inside an ipman init-ed project). In the TUI: multi-select with Space, then p.

6. Custody (接管目录, optional)

ipman takeover user    # the whole skills dir moves into IpMan custody;
                       # the original path becomes a symlink — agent unaware
ipman release user     # give it back, contents restored in place

Why bother: a taken-over scope survives accidents. Even if the skills dir link is destroyed, ipman sync --user rebuilds it; stored originals are read-only snapshots that a stray rm -rf cannot gut.

7. Inside your agent

ipman skill-sync --scope claude-code-user   # install the companion skill (explicit)
ipman statusline                            # one-liner for the agent status bar

Then ask your agent to "整理技能 / clean up my skills" — it uses the same engine via --json, confirming before every write.