---
source_keys:
  - git-scm-submodule-docs
---

# References

One file per task branch in SKILL.md's dispatch table. Load only the one that matches the request.

## setup-and-update.md

Cloning a superproject that has submodules, adding a dependency as a submodule, initializing
without cloning, updating or re-pinning, and running one command across every submodule. Carries
the `add` and `update` flag tables, the keep-pinned and move-the-pin-forward workflows, and the
`foreach` shell-variable table (`$name`, `$sm_path`, `$displaypath`, `$sha1`, `$toplevel`).

## urls-and-config.md

Where a submodule points and how it is configured: the `.gitmodules` vs `.git/config` split, both
key tables, `sync` / `set-url` / `set-branch`, local mirror overrides, relative URL resolution, the
security gate on custom `update` commands, and `absorbgitdirs`.

## removal.md

Removing a submodule, and why `deinit` alone does not remove one. Carries the full four-step
removal sequence including the manual `.git/modules/<name>/` cleanup.

## sources.md

Research sources that informed this skill — provenance chain for git-scm-submodule-docs reference
material.