Getting started
Skul applies a shared bundle — skills, commands, agents, instructions, MCP servers — to a project, in the layout each AI coding tool expects, and keeps it out of Git.
Install
npm install --global @solaqua/skul
Needs Node.js 20+ and Git.
Apply a bundle
Run this inside a Git project:
skul add sjquant/ghosts writing
This uses a public example bundle. Skul clones sjquant/ghosts into ~/.skul/library/, asks which tools to target, writes the writing bundle's files, and adds them to .git/info/exclude. Run git status: nothing changed.
Use it
Open your coding tool in the project. The bundle's skills are ready to use; in Claude Code, for example, run /ghosts:rewrite.
Make it yours
Write your own bundle and add it the same way. Narrow an install when you want less:
skul add writing --agent codex # one tool
skul add writing --include skills/rewrite # one item
skul add writing --ref main # a branch, tag, or commit
Keep going
skul status # what is applied, and where
skul update # pull newer bundle revisions
skul remove writing
Starting a new worktree? Skul remembers what this repository wants, so one command brings the same setup back:
git worktree add ../my-feature
cd ../my-feature
skul apply
Before adding a bundle to a repository that commits its own AGENTS.md or CLAUDE.md, read how tracked instructions work.