Quick Start

Apply a bundle from GitHub:

skul add github.com/sjquant/ai-bundles react-expert

Use owner/repo shorthand:

skul add acme/shared-bundles core --agent codex

Clone via SSH:

skul add --ssh github.com/sjquant/ai-bundles react-expert
skul add git@github.com:sjquant/ai-bundles react-expert

Re-apply from cache without network access:

skul add react-expert

Install selected bundle items only:

skul add react-expert --agent codex --include skills/diagnose
skul add react-expert --agent codex --include root-instruction

Or choose items interactively:

skul add react-expert --agent codex --select-items

Inspect state:

skul list
skul status
skul check

Update or clean up:

skul update
skul remove react-expert
skul reset

For scripting or agent usage, set SKUL_NO_TUI=1 to disable interactive prompts.

Tracked root instructions

If a bundle writes to a root instruction file that is already tracked by Git, use the tracked-shadow lifecycle during upstream updates:

skul sync

Manual equivalent:

skul shadow --suspend
git pull --ff-only
skul shadow --refresh