Git Submodule

This is the submodule operator manual you wish you had when you were three levels deep in detached HEAD confusion. It forces you to pick one mode (add and pin, bootstrap, sync to recorded commit, advance a tracked branch, edit inside without losing work, remove cleanly, or configure CI) and gives you the exact command packet for that mode. The real value is in the decision matrix upfront: it tells you when submodules are the wrong boundary and you should use subtree, vendoring, or package delivery instead. It keeps the invariants visible (superprojects record commits not branches, update usually leaves you detached, hosted platforms add auth and visibility constraints) so you don't get surprised when CI fails or GitHub Pages refuses your private submodule.

Install to Claude Code

npx -y skills add akillness/oh-my-skills --skill git-submodule --agent claude-code