Skip to main content

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.