Claude MarketplacesSubmit
akillness avatar

Git Submodule

akillness/oh-my-skills

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.

skills.sh installs
167
GitHub stars
22
last updated
Jun 3, 2026
View on GitHub

Install

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

Installs into .claude/skills of the current project.

Files

Git Submodule

Use this skill as the repository's Git submodule choice and operator-workflow anchor.

The job is not to dump every git submodule command in one blob. The job is to:

  1. decide whether submodule is the right boundary at all,
  2. choose one operating mode,
  3. keep pinned-commit, detached-HEAD, and hosted-platform consequences explicit,
  4. emit the next safe commands only for that mode.

Read references/decision-matrix.md first. Read references/update-and-detached-head.md when the request involves pointer updates, detached HEAD, or editing inside the submodule. Read references/ci-and-automation.md for CI/bootstrap expectations. Read references/mode-packets-and-hosted-constraints.md for mode-specific command packets and GitHub Pages / URL-drift constraints.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Details

Repository
github.com/akillness/oh-my-skills
Category
Git & Pull Requests
First seen
Jun 3, 2026

More from akillness/oh-my-skills

All 81

Recommended

More Git & Pull Requests
1akillness avatargit-workflowakillness/oh-my-skillsgit workflow167skills.sh installs
20xbigboss avatargit-best-practices0xbigboss/claude-codegit best practices149skills.sh installs
3sickn33 avatargitlab-automationsickn33/antigravity-awesome-skillsgitlab automation139skills.sh installs
4buiducnhat avataras-reviewbuiducnhat/agent-skillsas review131skills.sh installs
5absolutelyskilled avatargit-advancedabsolutelyskilled/absolutelyskilledgit advanced130skills.sh installs
6flora131 avatarado-commitflora131/atomicado commit116skills.sh installs